Exchange a token
Exchanges a JWT from a trusted issuer for an opaque crt_ token. The JWT is the credential, so the route takes no bearer token. Errors have the RFC 6749 shape.
Request
This endpoint expects an object.
grant_type
RFC 8693 token exchange or the RFC 7523 JWT bearer grant.
Allowed values:
subject_token
The JWT. Token exchange only.
subject_token_type
The type of subject_token. Token exchange only.
Allowed values:
assertion
The JWT. JWT bearer grant only.
requested_token_type
Only the access token type.
audience
The tenant host, when sent.
resource
The tenant host, when sent.
Response headers
x-request-id
The id of the request: req_ and a ULID. Every answer has it.
x-ratelimit-limit-requests
The size of the request bucket, per minute.
x-ratelimit-remaining-requests
The requests that remain.
x-ratelimit-reset-requests
The time until the request bucket is full.
x-ratelimit-limit-units
The size of the units bucket, per minute. Absent when no limit applies.
x-ratelimit-remaining-units
The units that remain.
x-ratelimit-reset-units
The time until the units bucket is full.
Response
The new token.
access_token
An opaque crt_ token.
token_type
expires_in
The life of the token, in seconds.
issued_token_type
The RFC 8693 issued token type.
scope
The scopes of the token, separated by spaces.
Errors
400
Bad Request Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error