Skip to main content
Read one run

Authorizations

Authorization
string
header
required

Opaque Firedrill interactive or scoped machine credential. The CLI handles human-approved login; CI stores its scoped credential as FIREDRILL_TOKEN. Capabilities and project/environment ownership are rechecked at use.

Headers

x-fd-read-scope-version
string

Send all three selected-read headers together. The response echoes the confirmed selection.

Allowed value: "2026-10-16-read-scope.1"
x-fd-read-project-id
string

Your selected project. A resource outside the selected context returns 409.

x-fd-read-environment-id
string

Your selected environment. These headers never grant authority.

Path Parameters

runId
string
required
Required string length: 1 - 160

Response

The retained resource or operation response.

id
string
required
batchId
string
required
projectId
string
required
environmentId
string
required
scenario
object
required
configuration
object
required
repetition
number
required
target
object
required
execution
enum<string>
required
Available options:
error,
queued,
running,
completed,
interrupted,
cancelled
attemptId
null | string
required
startedAt
null | string
required
finishedAt
null | string
required
output
any
required

Any JSON value: null, boolean, finite number, string, array or object. The request transport must contain valid JSON; canonical validation rejects nonfinite numbers.

reason
null | string
required
assessment
enum<string>
required
Available options:
error,
completed,
not_requested,
pending,
partial,
unavailable
gate
enum<string>
required
Available options:
not_configured,
allow,
block,
inconclusive
scenarioRevision
string
measurements
object