curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/jobs/{job_id}' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
{
"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"
}
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 --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/jobs/{job_id}' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
{
"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"
}
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
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
string (uuid)
required
Response
JobStatusResponse
string
required
Job UUID.
string
required
Current status: queued, running, succeeded, failed, cancelled, awaiting_approval.
string
required
Agent type / template that was used.
string,null
Pipe-separated final assistant text. Populated when the job reaches a terminal state. Truncated to ≈5 segments × 280 chars.
string,null
Human-readable error message when status is ‘failed’ or ‘cancelled’.
integer,null
Cumulative input tokens consumed.
integer,null
Cumulative output tokens generated.
number,null
Cumulative billable cost. Priced at the job’s selected model rate (not the deployment default).
string
required
ISO 8601 UTC timestamp.
string
required
ISO 8601 UTC timestamp; refreshed on every iteration.
Status codes
| Code | Meaning |
|---|---|
200 | Successful Response |
422 | Validation Error |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/jobs/{job_id}' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
{
"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"
}
Last modified on September 21, 2026