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_idstringrequired

The job to watch.

Response

text/event-stream
idstring

Event id (evt_…). Send it back as Last-Event-ID to resume.

eventenum

Event name. job is the last event: its data is the finished Job.

Available options:job.queuedjob.runningjob.stagejob.succeededjob.failedjob
dataJSON

A JobEvent (id, job_id, type, created, stage, data with done, total and an optional note), or the Job for the final job event.

Errors