Create
Persists a SQL query with authorship and replay metadata. The name must be unique within the tenant (case-insensitive); a conflict returns 409.
Authorizations
OAuth 2.0 Client Credentials flow. The tokenUrl shown is for the production environment. For other environments, replace prod with the target environment name (e.g., auth.staging.oleria.io for staging).
Body
1 - 200"Disabled MFA accounts"
The SQL text. Stored verbatim — not parsed or validated as SQL at save (it may be a draft or carry :placeholder parameters). SQL validity is checked at execution time via /v1/query/execute.
1 - 100000"SELECT account_id, mfa_status FROM oleria_account WHERE mfa_status = :status"
Semantic model the query targets. Optional — defaults to oleria_identity. Validated against the available models (/v1/schema/models) at save.
"oleria_identity"
2000"Accounts where MFA is disabled"
Response
Saved query created.
A stored SQL query with authorship metadata.
Opaque stable identifier. Clients key on this, never the name.
"550e8400-e29b-41d4-a716-446655440000"
Free-form label, unique within the tenant (case-insensitive).
"Disabled MFA accounts"
The stored SQL text.
"SELECT account_id, mfa_status FROM oleria_account WHERE mfa_status = :status"
Semantic model the query targets.
"oleria_identity"
The principal (user or service client) that created or last modified the saved query, identified by a stable, opaque id.
The principal (user or service client) that created or last modified the saved query, identified by a stable, opaque id.
Monotonic version — 1 on create, incremented on every update. Doubles as the optimistic-concurrency token on update.
3
"2026-06-01T10:00:00Z"
"2026-06-04T09:30:00Z"
Optional free-form context about the query.
"Accounts where MFA is disabled — weekly review"

