Skip to main content
GET
Get Job

Authorizations

Authorization
string
header
required

An API key or OAuth2/OIDC access token sent as Authorization: Bearer <token>.

Path Parameters

job_id
string<uuid>
required

Response

Successful Response

A job resource — the uniform, control-plane envelope over every job implementation.

Stable across every status; status-specific fields (error) are present-but-null rather than added/removed. Heavy, high-frequency, or implementation-specific data lives behind the *_url sub-resources, never inline.

id
required
job_type
string
required
status
enum<string>
required
Available options:
pending,
running,
completed,
failed,
cancelled
created_at
string<date-time>
required
updated_at
string<date-time>
required
metrics_url
string
required
result_url
string
required
artifacts_url
string
required
progress
number | null
error
JobError · object | null

Structured failure info; present on a JobResponse only when status == failed.