Get Job Status

Poll job status, with conditional-GET (ETag / If-None-Match) support. Polling clients can pass back the previous response’s ETag value as If-None-Match…

GET /api/v1/jobs/{job_id}

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/jobs/{job_id}' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending",
  "template": "string",
  "summary": "Two-person tent, green — replacement for damaged pole set.",
  "error": "string",
  "input_tokens": 1,
  "output_tokens": 1,
  "cost_usd": 1.5,
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}

Poll job status, with conditional-GET (ETag / If-None-Match) support.

Polling clients can pass back the previous response’s ETag value as If-None-Match; an unchanged job returns 304 Not Modified with no body. Saves bytes and downstream JSON parse cost on every tick.

Path parameters

job_id · string (uuid) · required

Response

JobStatusResponse

id · string · required

Job UUID.

status · string · required

Current status: queued, running, succeeded, failed, cancelled, awaiting_approval.

template · string · required

Agent type / template that was used.

summary · string,null

Pipe-separated final assistant text. Populated when the job reaches a terminal state. Truncated to ≈5 segments × 280 chars.

error · string,null

Human-readable error message when status is ‘failed’ or ‘cancelled’.

input_tokens · integer,null

Cumulative input tokens consumed.

output_tokens · integer,null

Cumulative output tokens generated.

cost_usd · number,null

Cumulative billable cost. Priced at the job’s selected model rate (not the deployment default).

created_at · string · required

ISO 8601 UTC timestamp.

updated_at · string · required

ISO 8601 UTC timestamp; refreshed on every iteration.

Status codes

Code	Meaning
200	Successful Response
422	Validation Error

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/jobs/{job_id}' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending",
  "template": "string",
  "summary": "Two-person tent, green — replacement for damaged pole set.",
  "error": "string",
  "input_tokens": 1,
  "output_tokens": 1,
  "cost_usd": 1.5,
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}