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

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

200

{
  "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"
  ]
}

Compare two jobs side-by-side.

Useful for ‘did changing the model improve cost?’ or ‘which run succeeded — the original or the duplicate?’. Surfaces the two jobs’ full status snapshots plus a deltas dict highlighting the fields that actually differ. Both jobs must belong to the calling tenant.

Query parameters

a · string (uuid) · required

UUID of the first job.

b · string (uuid) · required

UUID of the second job.

Response

JobDiffResponse

a · JobDiffSide · required

Show JobDiffSide

id · string · required

template · string · required

status · string · required

summary · string,null

error · string,null

input_tokens · integer,null

output_tokens · integer,null

cost_usd · number,null

duration_seconds · number,null

updated_at - created_at, in seconds. None when not terminal.

model · string,null

effort · string,null

agent_mode · string · required

tags · string[]

instruction_preview · string · required

First 280 chars of the original instruction.

b · JobDiffSide · required

Show JobDiffSide

id · string · required

template · string · required

status · string · required

summary · string,null

error · string,null

input_tokens · integer,null

output_tokens · integer,null

cost_usd · number,null

duration_seconds · number,null

updated_at - created_at, in seconds. None when not terminal.

model · string,null

effort · string,null

agent_mode · string · required

tags · string[]

instruction_preview · string · required

First 280 chars of the original instruction.

deltas · 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.

same · string[] · required

Field names that matched on both sides — quick visual confirmation.

Status codes

Code	Meaning
200	Successful Response
422	Validation Error

cURL

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

200

{
  "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"
  ]
}