Skip to main content

Get ingest job status

GET 
/ingest/jobs/:job_id

Query the status of an async ingest job.

This endpoint allows native clients to poll for job completion after submitting an ingest request. The client can use this to confirm:

  • Job is still queued or running (keep polling)
  • Job succeeded (safe to purge local staged data)
  • Job failed (may retry or alert user)

Security:

  • Jobs are tenant-scoped; you cannot query another tenant's jobs
  • No transcript content is ever returned

Response fields:

  • status: One of queued, running, succeeded, failed
  • document_id: Populated on success
  • tasks_extracted: Number of tasks found (on success)
  • error_code / error_message: Populated on failure

Request​

Responses​

Successful Response