Skip to main content
Issue a bounded Tool connection

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

Path Parameters

instanceId
string
required
Required string length: 1 - 160

Query Parameters

projectId
string
required
Required string length: 1 - 160
environmentId
string
required
Required string length: 1 - 160

Body

application/json
epoch
integer
required
Required range: 0 <= x <= 9007199254740991
audience
enum<string>
required
Available options:
http,
mcp,
ui
purpose
enum<string>
required
Available options:
manual,
target
allowedOperations
string[]
required
Required array length: 1 - 256 elements
Required string length: 1 - 160
ttlSeconds
integer
required
Required range: 1 <= x <= 604800

Response

The retained resource or operation response.

connection
object
required
token
string | null
required
tokenDelivery
enum<string>
required
Available options:
one_time,
not_repeated
repair
string
required
launchUrl
string | null