curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/jobs' \
--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"
}
]
List Jobs V1
List jobs for the authenticated tenant. Mirrors the dashboard’s /api/jobs/ filters + cursor pagination so v1 callers can enumerate their own runs without…
GET
/
api
/
v1
/
jobs
curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/jobs' \
--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.
/api/jobs/ filters + cursor pagination so v1
callers can enumerate their own runs without remembering every job id.
Query parameters
string,null
Filter to a single status: queued, running, succeeded, failed, cancelled, awaiting_approval
string,null
Filter to a specific agent_type / template name
string,null
Substring match against job id or summary
string[],null
Filter to jobs that carry every supplied tag (AND-match). Repeat the parameter to require multiple tags:
?tag=env:prod&tag=owner:billing-team.string
field:dir — field is one of created_at|updated_at|status|template|cost_usd; dir is asc|desc
integer
integer
string,null
Opaque cursor from a previous response’s X-Next-Cursor header. When set, supersedes
offset and pages strictly past the seed row using a seek predicate. Only valid for sort=created_at.Response
JobStatusResponse[] — each element:
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' \
--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