Skip to main content
GET
/
v1
/
runs
/
{run_id}
Get run details
curl --request GET \
  --url https://api.usezombie.com/v1/runs/{run_id} \
  --header 'Authorization: Bearer <token>'
{
  "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "spec_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "current_state": "<string>",
  "attempt": 123,
  "mode": "pull_request",
  "requested_by": "<string>",
  "branch": "<string>",
  "created_at": 123,
  "updated_at": 123,
  "transitions": [
    {
      "state_from": "<string>",
      "state_to": "<string>",
      "actor": "<string>",
      "reason_code": "<string>",
      "ts": 123
    }
  ],
  "artifacts": [
    {
      "artifact_name": "<string>",
      "object_key": "<string>",
      "checksum_sha256": "<string>",
      "producer": "echo",
      "attempt": 123,
      "created_at": 123
    }
  ],
  "policy_events": [
    {
      "action_class": "safe",
      "decision": "allow",
      "rule_id": "<string>",
      "actor": "<string>",
      "ts": 123
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pr_url": "<string>"
}

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Path Parameters

run_id
string<uuid>
required

Run identifier

Response

Run details

run_id
string<uuid>
required
workspace_id
string<uuid>
required
spec_id
string<uuid>
required
current_state
string
required

Current pipeline state (e.g. SPEC_QUEUED, ECHO_RUNNING, PR_OPENED, FAILED)

attempt
integer
required

Current attempt number (increments on retry)

mode
enum<string>
required
Available options:
pull_request
requested_by
string
required
branch
string
required

Git branch created for this run

created_at
integer
required

Unix timestamp in milliseconds

updated_at
integer
required

Unix timestamp in milliseconds

transitions
object[]
required

Ordered list of state transitions

artifacts
object[]
required

Artifacts produced during the run

policy_events
object[]
required

Policy evaluation events

request_id
string<uuid>
required
pr_url
string<uri> | null

Pull request URL, null until PR is opened