Get one job's detail
const url = 'https://example.com/v1/jobs/example';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/v1/jobs/example \ --header 'Authorization: Bearer <token>'Return a job’s header, final result manifest, and latest public event.
404 JOB_NOT_FOUND when the job doesn’t exist OR belongs to another tenant.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Header Parameters
Section titled “Header Parameters ”Responses
Section titled “ Responses ”Successful Response
GET /v1/jobs/{id} — header + final result manifest + latest event.
object
The job’s ULID public_id.
The job’s type (UPPER_SNAKE).
The job’s current status.
Job creation timestamp (UTC).
The final-artifact manifest (empty until the job succeeds).
A job artifact — image_url is a short-lived presigned GET URL; a raw
S3 key never crosses this boundary (studio AD-8).
object
Short-lived presigned GET URL for the artifact image.
Artifact kind, e.g. “on_model_render”, “catalog_image”.
Intermediate | final.
Kind-specific metadata.
object
One public-visibility event in a job’s timeline.
object
Monotonic per-job sequence number — the polling cursor.
Queued | stage | succeeded | failed.
Always ‘public’ on this surface.
Human-readable event line.
Presigned artifacts for this event.
A job artifact — image_url is a short-lived presigned GET URL; a raw
S3 key never crosses this boundary (studio AD-8).
object
Short-lived presigned GET URL for the artifact image.
Artifact kind, e.g. “on_model_render”, “catalog_image”.
Intermediate | final.
Kind-specific metadata.
object
Type-specific payload fields (cost/error/etc.).
object
Event creation timestamp (UTC).
Example
{ "status": "NOT_STARTED"}Validation Error
object
object
Example generated
{ "detail": [ { "loc": [ "example" ], "msg": "example", "type": "example" } ]}