StateSet API Docs

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

{
  "a": {
    "id": "string",
    "template": "string",
    "status": "string",
    "summary": "string",
    "error": "string",
    "input_tokens": 1,
    "output_tokens": 1,
    "cost_usd": 1,
    "duration_seconds": 1,
    "model": "string",
    "effort": "string",
    "agent_mode": "string",
    "tags": [
      "string"
    ],
    "instruction_preview": "string"
  },
  "b": {
    "id": "string",
    "template": "string",
    "status": "string",
    "summary": "string",
    "error": "string",
    "input_tokens": 1,
    "output_tokens": 1,
    "cost_usd": 1,
    "duration_seconds": 1,
    "model": "string",
    "effort": "string",
    "agent_mode": "string",
    "tags": [
      "string"
    ],
    "instruction_preview": "string"
  },
  "deltas": {},
  "same": [
    "string"
  ]
}

GET

api

jobs

diff

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

{
  "a": {
    "id": "string",
    "template": "string",
    "status": "string",
    "summary": "string",
    "error": "string",
    "input_tokens": 1,
    "output_tokens": 1,
    "cost_usd": 1,
    "duration_seconds": 1,
    "model": "string",
    "effort": "string",
    "agent_mode": "string",
    "tags": [
      "string"
    ],
    "instruction_preview": "string"
  },
  "b": {
    "id": "string",
    "template": "string",
    "status": "string",
    "summary": "string",
    "error": "string",
    "input_tokens": 1,
    "output_tokens": 1,
    "cost_usd": 1,
    "duration_seconds": 1,
    "model": "string",
    "effort": "string",
    "agent_mode": "string",
    "tags": [
      "string"
    ],
    "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

string (uuid)

required

UUID of the first job.

string (uuid)

required

UUID of the second job.

Response

JobDiffResponse

JobDiffSide

required

Show JobDiffSide

string

required

string

required

string

required

string,null

integer,null

number,null

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

string,null

string

required

string[]

string

required

First 280 chars of the original instruction.

JobDiffSide

required

Show JobDiffSide

string

required

string

required

string

required

string,null

integer,null

number,null

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

string,null

string

required

string[]

string

required

First 280 chars of the original instruction.

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.

string[]

required

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

Status codes

Code	Meaning
`200`	Successful Response
`422`	Validation Error

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

{
  "a": {
    "id": "string",
    "template": "string",
    "status": "string",
    "summary": "string",
    "error": "string",
    "input_tokens": 1,
    "output_tokens": 1,
    "cost_usd": 1,
    "duration_seconds": 1,
    "model": "string",
    "effort": "string",
    "agent_mode": "string",
    "tags": [
      "string"
    ],
    "instruction_preview": "string"
  },
  "b": {
    "id": "string",
    "template": "string",
    "status": "string",
    "summary": "string",
    "error": "string",
    "input_tokens": 1,
    "output_tokens": 1,
    "cost_usd": 1,
    "duration_seconds": 1,
    "model": "string",
    "effort": "string",
    "agent_mode": "string",
    "tags": [
      "string"
    ],
    "instruction_preview": "string"
  },
  "deltas": {},
  "same": [
    "string"
  ]
}

Overview

Jobs

Trigger

Templates

Skills

Custom agents

Approvals

Approval policies

Outcomes

Usage

Quota

Billing

Webhooks

Keys

Auth

System

Health

Events

Tags

Side-by-side comparison of two of the tenant's jobs

Query parameters

Response

Status codes

​Query parameters

​Response

​Status codes

Query parameters

Response

Status codes