Skip to main content
GET
List recent runs that used sandboxes
Lists the runs whose sandbox lineages changed most recently, newest first: each run’s runId, lineageCount and lastSnapshotAt (epoch ms, null when unknown). This is the Console’s Sandboxes landing list. limit is 1-100 (default 50). The read looks at a recency window, the newest 4 × limit active and archived lineages, so it is not a full history and has no cursor. A run you cannot read is omitted, not refused; when the read could not decide every run inside its limits, meta.partial is true.

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.

Query Parameters

limit
integer
default:50

Rows, 1-100. Default 50.

Required range: 1 <= x <= 100

Response

Recent runs with sandboxes

data
object
required
meta
object
required