Skip to main content
GET
Get the status, partial results, and any pending changes for an async chat job.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization
string | null

Path Parameters

job_id
string
required

Response

Successful Response

Status and details of an async job.

job_id
string
required

Unique job identifier. Use this to poll for status updates.

session_id
string
required

Session associated with this job.

job_type
string
required

Type of job: 'chat' or 'attachment_processing'.

status
string
required

Current status: 'pending', 'in_progress', 'awaiting_approval', 'completed', 'failed', or 'cancelled'.

created_at
string
required

ISO 8601 timestamp when the job was created.

updated_at
string
required

ISO 8601 timestamp of the last status change.

progress
integer
required

Progress percentage (0-100).

organization_id
string | null

Organization that owns this job (null for user jobs).

user_id
string | null

User that owns this job (null for organization jobs).

result
JobResult · object | null

Job output. Present when status is 'completed'. Contains AI response and document changes for chat jobs.

error
string | null

Error message. Present when status is 'failed'.

metadata
JobMetadata · object | null

Job metadata and context. Contains pending_changes when status is 'awaiting_approval'.