Skip to main content
POST
Requeue Failed Queue Job

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

job_id
string
required

Query Parameters

clear_cancellation
boolean
default:false
force
boolean
default:false

Response

Successful Response

One durable queue job (a background run's queue ticket).

id
string
required

Job ID (identical to the run's run_id)

component_type
string
required

Component kind: agent, team or workflow

component_id
string
required

ID of the agent/team/workflow the run executes on

session_id
string
required

Session the run belongs to

status
string
required

queued | running | completed | failed | cancelled | paused

job_type
string
default:run

Kind of work the ticket carries (runs only today)

user_id
string | null

User the run was submitted for

payload
Payload · object

Serialized run parameters

attempt
integer
default:0

Executions started so far

max_attempts
integer
default:1

Execution budget under any failure mode

idempotency_key
string | null

Client-provided dedupe key, if any

available_at
integer | null

Epoch seconds the job becomes claimable

locked_by
string | null

Worker currently holding the job's lock

locked_at
integer | null

Epoch seconds the current lock was taken

error
string | null

Terminal error of the last attempt, if any

created_at
integer | null

Epoch seconds the job was accepted

updated_at
integer | null

Epoch seconds of the last state change

completed_at
integer | null

Epoch seconds the job reached a terminal state