Jobs

Fetch a single async-job record

Returns the WireJobRecord for jobId, or 404 if no such job exists. The record carries the job's lifecycle state, progress percent, and — once completed — the outputAssetId whose bytes resolve by-reference through the Asset read surface.

get/v1/jobs/{jobId}

Request

  • Base URL: http://localhost:9998
  • URL: http://localhost:9998/v1/jobs/{jobId}
  • Auth: HTTP bearer

Path parameters

jobIdstring required

Identifier returned when the async job was enqueued.

Response

Job record

idstring required

Stable job identifier (returned when the job was enqueued).

verbstring required

The async verb this job runs (e.g. the transform/capture name).

state'pending' | 'running' | 'completed' | 'failed' | 'cancelled' required

Lifecycle state of an async job.

progressnumber double required

Completion percent (0–100).

startedAtstring required

ISO-8601 timestamp when the job started.

finishedAtstring nullable

ISO-8601 timestamp when the job reached a terminal state; null while running.

errorstring nullable

Failure message when state is failed; null otherwise.

outputAssetIdstring nullable

Asset id of the produced output when state is completed; null otherwise.

Changes

No recorded changes to this operation across all 1 revision of this API.