Issue a room-join token for private browser calling

Issues a single-call token for browser calling where RevDesk places the call and your browser joins it. You provide a caller ID (from_number, which must be a number you own) and a destination (to_number); RevDesk dials the destination and returns a token your browser uses to join the live call and talk through the mic. Nothing about the underlying network is exposed to the browser. The connection runs entirely on RevDesk’s own infrastructure. Pass the returned token and room_url to the RevDesk browser SDK (@revdesk/webrtc) to join.

POST /v1/room-token

Issue a room-join token for private browser calling

cURL

curl --request POST \
  --url https://api.revdesk.com/v1/room-token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_number": "<string>",
  "to_number": "<string>",
  "ttl_seconds": 315
}
'

200

{
  "data": {
    "token": "<string>",
    "room_url": "<string>",
    "room_name": "<string>",
    "call_id": "<string>",
    "expires_in": 123,
    "from_number": "<string>",
    "to_number": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key · string

UUID — when present, deduplicates repeat submissions. See /api-reference/idempotency.

Body

application/json

from_number · string · required

Pattern: ^\+[1-9]\d{1,14}$

to_number · string · required

Pattern: ^\+[1-9]\d{1,14}$

ttl_seconds · integer

Required range: 30 <= x <= 600

Response

200

application/json

Success

data · object · required

Show child attributes