Get AI job status
Retrieve the current status and details of an AI job, including its state, progress information, and result summary.
The response fields vary by state — for example, progress is only present during EXECUTING, and resultSummary is only present when COMPLETE.
Poll this endpoint every 2–5 seconds until the job reaches a terminal state (COMPLETE, FAILED, or CANCELLED).
Authorizations
Can be either an Organization API Key or Personal Access Token (PAT).
Include in the Authorization header as: Bearer YOUR_TOKEN
Path Parameters
The unique identifier of the AI job
Response
Job status retrieved successfully
The unique identifier for this job.
"550e8400-e29b-41d4-a716-446655440000"
Current state of the job. Terminal states are COMPLETE, FAILED, and CANCELLED. Poll until the job reaches a terminal state.
CANCELLED, COMPLETE, DELIVERING, EXECUTING, FAILED, QUEUED "QUEUED"
The natural language prompt that was submitted.
"What are the top 5 products by revenue?"
The conversation this job is associated with. Use this to submit follow-up jobs in the same conversation thread.
"660e8400-e29b-41d4-a716-446655440001"
The shared model ID used for query generation.
"770e8400-e29b-41d4-a716-446655440002"
Branch ID used for model context, or null if querying the main shared model.
The organization that owns this job.
"880e8400-e29b-41d4-a716-446655440003"
The user ID who created (or is associated with) this job.
"990e8400-e29b-41d4-a716-446655440004"
Topic name used to scope query generation, or null if the AI selected the topic automatically.
"order_items"
The LLM the job is pinned to, or null when if the job used the organization default. If your organization is over its AI credit downgrade threshold, this will be the organization's downgrade LLM.
URL to view this conversation in the Omni chat interface. Opens the chat session where the job actions and results are visible.
Omitted for MCP requests (X-MCP-Request: true) when the organization hides Omni links from MCP clients.
"https://blobsrus.omni.co/chat/660e8400-e29b-41d4-a716-446655440001"
Only present in EXECUTING state. Real-time progress information. Null if no progress has been reported yet. Updated in real-time as the AI works through iterations.
Only present in COMPLETE state. Markdown-formatted summary of the job result. For the full result with query details and data, use the Stream AI job results endpoint.
"### Top 5 Products by Revenue\n\n1. **Sunglasses** - $678,994\n2. **Jeans** - $475,072"
Only present in FAILED state. Error details explaining why the job failed.
When the job was submitted.
"2025-01-15T10:00:00.000Z"
When execution began. Present once the job transitions from QUEUED to EXECUTING. May be absent on jobs that failed or were cancelled before execution started.
"2025-01-15T10:00:05.000Z"
Present in COMPLETE and FAILED states. When the job finished (successfully or with error).
"2025-01-15T10:01:30.000Z"
When the job was cancelled.
"2025-01-15T10:00:12.000Z"
Only present in CANCELLED state. User ID of who cancelled the job.
"990e8400-e29b-41d4-a716-446655440004"
When the job record was last modified.
"2025-01-15T10:00:05.000Z"

