GET /v1/jobs/{jobId}/events
Stream job events — Server-Sent Events stream of status and progress updates for one job.
ivy_ API key (Authorization: Bearer ivy_…), a signed-in session token (Authorization: Bearer …) or the session cookie (browser sessions). See Authentication.Server-Sent Events stream of status and progress updates for one job. The stream opens with a current-state snapshot when available and closes after a terminal status, after about 290 seconds, or when the client disconnects. Comment heartbeats are sent every 15 seconds; reconnect to keep watching. Accepts an ivy_ API key, a signed-in session token or the session cookie. A project-scoped key only reaches jobs in its projects.
Request
Path parameters
Job UUID.
Responses
200 OK
event: <name> followed by data: <JSON>. Event names: subscribed ({jobId, type}), job_update (JobEventUpdate), close ({code, reason}) when the upstream stream ends, error ({error}) when it fails, and message ({raw}) for a payload that is not JSON. Other typed events from the job stream are forwarded under their own type name with the payload unchanged.400 Bad Request
Response shape: object
401 Unauthorized
Response shape: object
403 Forbidden
Response shape: object
404 Not Found
Response shape: object
503 Service Unavailable
Response shape: object
Was this page helpful?
GET /api/v1/jobs/{job_id}
Get job details — Return the full record for one job you can access: status, progress, parameters, results and output artifact references.
POST /v1/jobs/{jobId}/cancel
Cancel a job — Requests cancellation of an in-flight job you can write to. A job that has already finished returns its current status unchanged.