Returns the job’s current state (pending, in_progress, awaiting_approval, completed, failed, or cancelled), intermediate AI responses streamed during execution, the final document HTML once complete, and any pending changes awaiting user approval (with chunk IDs and proposed HTML diffs in metadata.pending_changes). Poll this after chat_async to track progress and retrieve results. When status is awaiting_approval, call POST /v1/chat//approve to approve or deny each pending change.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Successful Response
Status and details of an async job.
Unique job identifier. Use this to poll for status updates.
Session associated with this job.
Type of job: 'chat' or 'attachment_processing'.
Current status: 'pending', 'in_progress', 'awaiting_approval', 'completed', 'failed', or 'cancelled'.
ISO 8601 timestamp when the job was created.
ISO 8601 timestamp of the last status change.
Progress percentage (0-100).
Organization that owns this job (null for user jobs).
User that owns this job (null for organization jobs).
Job output. Present when status is 'completed'. Contains AI response and document changes for chat jobs.
Error message. Present when status is 'failed'.
Job metadata and context. Contains pending_changes when status is 'awaiting_approval'.