Jobs
Stream job events
Server-sent events for one job: job.queued, job.running, job.stage (with done and total for the current stage, and notes such as waiting for capacity), then job.succeeded or job.failed. The stream ends with an event named job carrying the finished Job, result included (which collects and deletes it, like GET /jobs/{job_id}). Resume with the Last-Event-ID header; a comment ping is sent every 15 seconds.
GET
Billing. Free. Credits & pricing
Path parameters
job_idstringrequiredThe job to watch.
Response
text/event-streamidstringEvent id (evt_…). Send it back as Last-Event-ID to resume.
eventenumEvent name. job is the last event: its data is the finished Job.
Available options:
job.queuedjob.runningjob.stagejob.succeededjob.failedjobdataJSONA JobEvent (id, job_id, type, created, stage, data with done, total and an optional note), or the Job for the final job event.
Errors
- 404not_found
- 401invalid_api_key
- 429rate_limited