Requeue a failed or cancelled job

POST

/admin/jobs/{id}/requeue

• Local development behind nginx (port 8088 by default)

Admin action (#401): send a dead job back to the pending pool — attempts reset, claim/lease/error cleared. Guarded on the source status: a running job is never touched (409). Gated on system.admin (mutations are admin-only; reads use system.jobs.read).

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

204

Job requeued.

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"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed

409

Conflict (slug taken, would create cycle, etc.)

object

error

required

Human-readable error summary

string

Example

the request could not be completed