Skip to main content
POST
/
v1
/
calls
/
token
cURL
curl --request POST \
  --url https://api.buildwithchirp.com/v1/calls/token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "roomName": "<string>",
  "participantIdentity": "user_123",
  "participantName": "<string>",
  "ttl": 3600
}
'
{
  "token": "<string>",
  "expiresAt": 1737000000
}

Authorizations

Authorization
string
header
required

App API key (format: sk_live_app_* or sk_test_app_*) for app-level operations

Body

application/json
roomName
string
required

Room name to scope the token to

participantIdentity
string
required

Identity for the participant in the room

Example:

"user_123"

participantName
string

Display name for the participant

ttl
integer

Token time-to-live in seconds (60-86400)

Required range: 60 <= x <= 86400
Example:

3600

Response

Token generated successfully

token
string
required

LiveKit access token for WebRTC connections

expiresAt
number
required

Token expiration as Unix timestamp

Example:

1737000000