Skip to main content
When the agent kicks off a long-running background task (such as generating a schedule from a scope-of-work document), it runs as a job. Poll this endpoint for its status while it runs, and refetch the chat once it completes.
Jobs are scoped to both the organization and authenticated member. A job outside either scope returns 404, never disclosed. Poll while a job is visible; there is no streaming job-progress frame today.
​
string
required
Bearer token obtained from the authenticate endpoint.
​
string
required
The job id.

​
Response

​
string
required
The job id.
​
string
required
The job type. Currently the only kind is sow_generate (schedule generation from a scope-of-work document); more kinds may be added.
​
string
required
One of queued, running, succeeded, failed, cancelled.
​
string
The chat the job belongs to, if any.
​
string
The turn the job was submitted from, if any.
​
object
Free-form progress payload, when the worker reports one.
​
object
A reference to the job’s result (e.g. an artifact id) once it completes.
​
object
Failure detail, present when the job failed.
​
string
required
ISO 8601 timestamp when the job was created.
​
string
ISO 8601 timestamp when the job finished, or null while running.