curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/jobs/diff' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
{
"a": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"template": "string",
"status": "pending",
"summary": "Two-person tent, green — replacement for damaged pole set.",
"error": "string",
"input_tokens": 1,
"output_tokens": 1,
"cost_usd": 1.5,
"duration_seconds": 7.5,
"model": "string",
"effort": "string",
"agent_mode": "string",
"tags": [
"priority"
],
"instruction_preview": "string"
},
"b": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"template": "string",
"status": "pending",
"summary": "Two-person tent, green — replacement for damaged pole set.",
"error": "string",
"input_tokens": 1,
"output_tokens": 1,
"cost_usd": 1.5,
"duration_seconds": 7.5,
"model": "string",
"effort": "string",
"agent_mode": "string",
"tags": [
"priority"
],
"instruction_preview": "string"
},
"deltas": {},
"same": [
"string"
]
}
Side-by-side comparison of two of the tenant's jobs
Compare two jobs side-by-side. Useful for ‘did changing the model improve cost?’ or ‘which run succeeded — the original or the duplicate?’…
GET
/
api
/
v1
/
jobs
/
diff
curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/jobs/diff' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
{
"a": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"template": "string",
"status": "pending",
"summary": "Two-person tent, green — replacement for damaged pole set.",
"error": "string",
"input_tokens": 1,
"output_tokens": 1,
"cost_usd": 1.5,
"duration_seconds": 7.5,
"model": "string",
"effort": "string",
"agent_mode": "string",
"tags": [
"priority"
],
"instruction_preview": "string"
},
"b": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"template": "string",
"status": "pending",
"summary": "Two-person tent, green — replacement for damaged pole set.",
"error": "string",
"input_tokens": 1,
"output_tokens": 1,
"cost_usd": 1.5,
"duration_seconds": 7.5,
"model": "string",
"effort": "string",
"agent_mode": "string",
"tags": [
"priority"
],
"instruction_preview": "string"
},
"deltas": {},
"same": [
"string"
]
}
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.
deltas dict highlighting the fields
that actually differ. Both jobs must belong to the calling tenant.
Query parameters
string (uuid)
required
UUID of the first job.
string (uuid)
required
UUID of the second job.
Response
JobDiffResponse
JobDiffSide
required
One side of a job-vs-job comparison.
Show JobDiffSide
Show JobDiffSide
JobDiffSide
required
One side of a job-vs-job comparison.
Show JobDiffSide
Show JobDiffSide
object
required
Field-by-field diff summary, e.g.
{'cost_usd': '0.0420 → 0.0085 (-80.95%)'}. Only fields that actually differ between A and B appear here. Additional keys map to values of type string.string[]
required
Field names that matched on both sides — quick visual confirmation.
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/diff' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
{
"a": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"template": "string",
"status": "pending",
"summary": "Two-person tent, green — replacement for damaged pole set.",
"error": "string",
"input_tokens": 1,
"output_tokens": 1,
"cost_usd": 1.5,
"duration_seconds": 7.5,
"model": "string",
"effort": "string",
"agent_mode": "string",
"tags": [
"priority"
],
"instruction_preview": "string"
},
"b": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"template": "string",
"status": "pending",
"summary": "Two-person tent, green — replacement for damaged pole set.",
"error": "string",
"input_tokens": 1,
"output_tokens": 1,
"cost_usd": 1.5,
"duration_seconds": 7.5,
"model": "string",
"effort": "string",
"agent_mode": "string",
"tags": [
"priority"
],
"instruction_preview": "string"
},
"deltas": {},
"same": [
"string"
]
}
Last modified on September 21, 2026