Get Job Timeline V1

Annotated event timeline for a single job. Higher-level than /replay: returns one row per phase (job_created, sandbox_ready, each tool call, terminal) with a…

GET /api/v1/jobs/{job_id}/timeline

cURL

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

200

{
  "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending",
  "events": [
    {
      "kind": "job_created",
      "timestamp": "2026-08-31T14:22:05Z",
      "summary": "Two-person tent, green — replacement for damaged pole set.",
      "sequence_number": 1001,
      "tool_name": "string",
      "duration_ms": 8,
      "is_error": false
    }
  ]
}

Annotated event timeline for a single job.

Higher-level than /replay: returns one row per phase (job_created, sandbox_ready, each tool call, terminal) with a one-line summary, ordered chronologically. Useful for dashboards that want to render a job lifecycle without parsing raw tool inputs/outputs.

Path parameters

job_id · string (uuid) · required

Response

TimelineResponse

job_id · string · required

status · string · required

events · TimelineEvent[] · required

Chronological. First entry is always job_created.

Show TimelineEvent

kind · string · required

Event class. Stable; new kinds may be appended.

timestamp · string · required

ISO 8601 UTC.

summary · string · required

One-line human-readable description.

sequence_number · integer,null

For tool_call events, the position in the tool stream.

tool_name · string,null

For tool_call events only.

duration_ms · integer,null

For tool_call events only.

is_error · boolean

True for tool_call rows whose execution errored.

Status codes

Code	Meaning
200	Successful Response
422	Validation Error

cURL

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

200

{
  "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending",
  "events": [
    {
      "kind": "job_created",
      "timestamp": "2026-08-31T14:22:05Z",
      "summary": "Two-person tent, green — replacement for damaged pole set.",
      "sequence_number": 1001,
      "tool_name": "string",
      "duration_ms": 8,
      "is_error": false
    }
  ]
}