Skip to main content
GET
Job status (the polling workhorse)

承認

Authorization
string
header
必須

Authorization: Bearer <api-key> — account-scoped API keys on Cloud and serverless. Self-hosted accepts unauthenticated requests by default and can be configured with a static bearer token.

パスパラメータ

id
string
必須

レスポンス

The job.

One execution of a workflow. Durable from creation until expires_at; outputs populates incrementally during execution.

id
string
必須
:

"job_01JZTGXW9Q2M4R8V0B1N3P5D7F"

status
enum<string>
必須

Lifecycle: queued → running → succeeded | failed | expired; a cancel request moves running → canceling → canceled. Terminal states: succeeded, canceled, failed, expired.

利用可能なオプション:
queued,
running,
succeeded,
canceling,
canceled,
failed,
expired
created_at
string<date-time>
必須
started_at
string<date-time> | null
必須
completed_at
string<date-time> | null
必須
expires_at
string<date-time>
必須

Retention deadline — a platform property, not an API constant.

queue_position
integer | null
必須
progress
object | null
必須

The latest progress snapshot; same data the SSE stream pushes.

outputs
object[]
必須
error
object | null
必須

Execution failure detail, carried in job.error (not an HTTP error).

urls
object
必須

Embedded follow-up links — follow these, don't build URLs. A link is either an absolute URL or a host-relative reference (leading /) that already includes any prefix the serving surface is mounted under (e.g. a serverless gateway's /deployment/{deployment_id}/api/v2). Clients MUST resolve a host-relative link against the request origin (scheme + authority), never against a configured base URL — joining it to a base URL that carries the same mount prefix duplicates the prefix.

metrics
object

Values are nullable (a metric not yet available — e.g. execution_ms before a job starts running — is null, not omitted); the example below is deliberately all-non-null purely to work around a Spectral/nimma lint-tooling crash on a literal null inside a schema example combined with additionalProperties.nullable: true — the schema itself is unchanged and still allows null values at runtime.

: