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.

示例: