Get job by ID (system admin only)

GET

/jobs/{jobId}

Retrieve details of a specific background job. Requires system admin access.

Parameters

Path Parameters

jobId

required

string

Responses

200

Job found

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

403

Forbidden - system admin access required

object

error

required

string

code

string

404

Job not found

object

error

required

string

code

string