Skip to main content
Exchange verified device identity for a revocable Firedrill CLI session

Authorizations

Authorization
string
header
required

Organization-scoped WorkOS access token accepted only at the session exchange boundary

Headers

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

Body

application/json

The body is of type object.

Response

Existing idempotent control session

schemaVersion
enum<number>
required
Available options:
1
credentialId
string
required
Pattern: ^cred_[0-9a-z]{12,32}$
credentialClass
enum<string>
required
Available options:
browser,
device
credential
string
required
Pattern: ^fd_(?:web|cli)_[A-Za-z0-9_-]{32,}$
organizationId
string
required
Pattern: ^org_[0-9a-z]{12,32}$
userId
string
required
Pattern: ^usr_[0-9a-z]{12,32}$
expiresAtMs
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991