Skip to main content
Read a retained assessment

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
assessmentId
string
required
Required string length: 1 - 160

Response

The retained resource or operation response.

id
string
required
runId
string
required
kind
enum<string>
required
Available options:
reassessment,
initial
rubric
null | object
required
evidenceManifest
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.

evidenceHash
string
required
result
object
required
gatePolicy
null | object
required
gate
enum<string>
required
Available options:
not_configured,
allow,
block,
inconclusive
createdAt
string
required
finishedAt
null | string
required
evaluationAttempts
object[]
required