Skip to main content
GET
List a step's sandbox commands
Lists the sandbox commands a run’s step ran, oldest first: status, timing, costCents, commandTier, commandId, governanceDisposition, the stored summaries and error.
  • A shell command carries exec: its text (the first 4,096 characters), exitCode, and stdout and stderr (the last 4,096 characters each); truncated says a cap cut one of them.
  • A file write carries files: the paths it wrote, never their contents.
  • Any other command carries neither.
The read scans each sandbox tool’s newest 1,000 commands across Forge, so an older command of the step may be missing, and it keeps the step’s newest limit commands (1-200, default 200). meta.partial is true when a scan window came back full or more than limit commands matched. stepId is required.

Masking

Runtime text is masked before it is cut to its cap: credential-shaped strings (JWTs, Bearer tokens, x-access-token: URLs and GitHub tokens) are replaced by a [REDACTED] marker. Masking is defense in depth, not a scrubber: a secret in a shape it does not recognise still crosses.

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

Query Parameters

stepId
string
required

The step.

Minimum string length: 1
limit
integer
default:200

Rows, 1-200. Default 200.

Required range: 1 <= x <= 200

Response

The step's sandbox commands

data
object
required
meta
object
required