Retry job (system admin only)

POST

/jobs/{jobId}/retry

Retry a failed job. Only failed jobs that have not exceeded max attempts can be retried. Requires system admin access.

Parameters

Path Parameters

jobId

required

string

Responses

200

Job retried successfully

object

id

required

string

taskType

required

string

payload

nullable

result

nullable

status

required

string

Allowed values: pending claimed running succeeded failed cancelled

affinityTags

required

Array<string>

workerId

required

string

nullable

leaseExpiresAt

required

string format: date-time

nullable

heartbeatAt

required

string format: date-time

nullable

attempt

required

number

maxAttempts

required

number

errorMessage

required

string

nullable

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

completedAt

required

string format: date-time

nullable

400

Bad request - job cannot be retried

object

error

required

string

code

string

403

Forbidden - system admin access required

object

error

required

string

code

string

404

Job not found

object

error

required

string

code

string