Extend the lease on a running job
POST /jobs/{id}/heartbeat
POST
/jobs/{id}/heartbeat
Workers should call this faster than the lease window (default 5 minutes). Returns 409 if the lease was already taken by another worker.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string format: uuid
Request Body required
Section titled “Request Body required ”Body for heartbeat; identifies the worker holding the lease.
object
worker_id
required
string
Responses
Section titled “ Responses ”Lease extended
Authentication required, missing, or invalid
object
error
required
Human-readable error summary
string
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Lease lost — another worker took the job