Skip to main content
Issue an actor-scoped access bundle for the customer-owned agent runner

Authorizations

Authorization
string
header
required

Opaque control credential

Headers

Idempotency-Key
string
required
Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Path Parameters

projectId
string
required
Pattern: ^prj_[0-9a-z]{12,32}$
sessionId
string
required
Pattern: ^ses_[0-9a-z]{12,32}$

Body

application/json
actorId
string
required
Required string length: 1 - 96
Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$
callbackReceiverBindingId
string

Explicit receiver-reaction access for this selected session binding. Usable only during its active callback attempt; never grants ordinary or hosted-interaction access.

Pattern: ^cbr_[0-9a-z]{12,32}$
ttlMs
integer
Required range: 0 < x <= 3600000

Response

Existing idempotent access bundle

schemaVersion
enum<number>
required
Available options:
1
sessionId
string
required
Pattern: ^ses_[0-9a-z]{12,32}$
environmentId
string
required
Pattern: ^env_[0-9a-z]{12,32}$
buildHash
string
required
Pattern: ^sha256:[0-9a-f]{64}$
actorId
string
required
Required string length: 1 - 96
Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$
worldHttpUrl
string<uri>
required
credential
string
required
Minimum string length: 32
expiresAtMs
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
capabilities
object[]
required
Minimum array length: 1
hostedRunId
string
Pattern: ^hrun_[0-9a-z]{12,32}$
interactionId
string
Required string length: 1 - 96
Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$
callbackReceiverBindingId
string
Pattern: ^cbr_[0-9a-z]{12,32}$
worldWireHttpUrl
string<uri>
worldWireAuthorizationHeader
enum<string>
Available options:
X-Firedrill-World-Authorization
worldMcpUrl
string<uri>