Skip to main content
GET
Get AI job status

Authorizations

Authorization
string
header
required

Can be either an Organization API Key or Personal Access Token (PAT).

Include in the Authorization header as: Bearer YOUR_TOKEN

Path Parameters

jobId
string<uuid>
required

The unique identifier of the AI job

Response

Job status retrieved successfully. Check the state field to determine if the job is still running or has reached a terminal state.

id
string<uuid>
required

The unique identifier for this job.

Example:

"550e8400-e29b-41d4-a716-446655440000"

state
enum<string>
required

Current state of the job. Terminal states are COMPLETE, FAILED, and CANCELLED. Poll until the job reaches a terminal state.

Available options:
CANCELLED,
COMPLETE,
DELIVERING,
EXECUTING,
FAILED,
QUEUED
Example:

"QUEUED"

prompt
string
required

The natural language prompt that was submitted.

Example:

"What are the top 5 products by revenue?"

conversationId
string<uuid>
required

The conversation this job belongs to. Use this to submit follow-up jobs in the same conversation thread.

Example:

"660e8400-e29b-41d4-a716-446655440001"

modelId
string<uuid> | null
required

The shared model ID used for query generation.

Example:

"770e8400-e29b-41d4-a716-446655440002"

branchId
string<uuid> | null
required

Branch ID used for model context, or null if querying the main shared model.

organizationId
string<uuid>
required

The organization that owns this job.

Example:

"880e8400-e29b-41d4-a716-446655440003"

userId
string<uuid>
required

The user ID who created (or is associated with) this job.

Example:

"990e8400-e29b-41d4-a716-446655440004"

topicName
string | null
required

Topic name used to scope query generation, or null if the AI selected the topic automatically.

Example:

"order_items"

requestedLlm
object | null
required

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.

Example:
createdAt
string<date-time>
required

When the job was submitted.

Example:

"2025-01-15T10:00:00.000Z"

updatedAt
string<date-time>
required

When the job record was last modified.

Example:

"2025-01-15T10:00:05.000Z"

omniChatUrl
string<uri>

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.

Example:

"https://blobsrus.omni.co/chat/660e8400-e29b-41d4-a716-446655440001"

progress
object | null

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.

resultSummary
string

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.

Example:

"### Top 5 Products by Revenue\n\n1. **Sunglasses** - $678,994\n2. **Jeans** - $475,072"

error
object

Only present in FAILED state. Error details explaining why the job failed.

executionStartedAt
string<date-time>

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.

Example:

"2025-01-15T10:00:05.000Z"

completedAt
string<date-time>

Present in COMPLETE and FAILED states. When the job finished (successfully or with error).

Example:

"2025-01-15T10:01:30.000Z"

cancelledAt
string<date-time>

When the job was cancelled.

Example:

"2025-01-15T10:00:12.000Z"

cancelledBy
string<uuid>

Only present in CANCELLED state. User ID of who cancelled the job.

Example:

"990e8400-e29b-41d4-a716-446655440004"