Skip to main content
POST
Generate a New Access Token

Authorizations

Authorization
string
header
default:$CARTESIA_API_KEY
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

Cartesia-Version
enum<string>
default:2026-03-01
required

API version header.

Available options:
2026-03-01
Example:

"2026-03-01"

Body

application/json
grants
TokenGrant · object | null

The permissions to be granted via the token. Both TTS and STT grants are optional - specify only the capabilities you need.

expires_in
integer | null

The number of seconds the token will be valid for since the time of generation. The maximum is 1 hour (3600 seconds).

Response

200 - application/json
token
string
required

The generated Access Token.