Skip to main content
GET
Get a run's sandbox lineage graph
Returns the sandbox lineages a run owns and every snapshot in them. A lineage carries its label, origin and head snapshots, runtime, status and times. A snapshot carries its parent and origin, runtime, vcpus and memoryMb, the step and agent definition that created it, status, expiresAt, sizeBytes, costCents and labels: what the Console’s snapshot drawer shows. A snapshot’s source (its repository URL and credential reference) never crosses. Use a snapshot’s snapshotId with Diff sandbox snapshots and Replay sandbox command.

Visibility

You need factories:read at the run’s home (its own org unit, else its workflow’s owning org unit) and at every company it carries. Any other run, and a run with neither home, answers 404 like a missing one. A Personal key reads as its owner, cut down to the key’s scopes; an External App reads by its own role grants.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

runId
string
required

The workflow run.

Minimum string length: 1

Response

The run's lineages and snapshots

data
object
required
meta
object
required