Record a failure on a running job

POST

/jobs/{id}/fail

• Local development behind nginx (port 8088 by default)

If terminal=true the job goes straight to status=failed and will not be retried. Otherwise the job returns to pending unless its attempts count reached max_attempts.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body ^required

object

worker_id

required

string

>= 1 characters <= 200 characters

error

required

string

terminal

boolean

Responses

204

Failure recorded

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

409

Lease lost