Skip to main content
Save a scenario revision

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

Idempotency-Key
string
required

Save a unique stable key for this exact logical action, at most 200 characters. Reuse it with identical input after an uncertain response. A new key is new intent; it must not be used merely to recover an accepted action.

Required string length: 1 - 200

Body

application/json
projectId
string
required
Required string length: 1 - 160
environmentId
string
required
Required string length: 1 - 160
schemaVersion
string
required
Allowed value: "2026-10-14-preparation.1"
scenario
object
required
expectedRevision
string | null
required
Pattern: ^[a-f0-9]{64}$

Response

The retained resource or operation response.

schemaVersion
string
required
Allowed value: "2026-10-14-preparation.1"
projectId
string
required
environmentId
string
required
id
string
required
revision
string
required
scenario
object
required
createdAt
string
required