WebRTC

Issue a scoped WebRTC calling token

Issues a single-use WebRTC token for the RevDesk WebRTC SDK, pinned to one caller ID (from_number, which must be a number you own) and one destination (to_number). The token is an opaque RevDesk token — pass it to the @revdesk/webrtc SDK to place exactly that one call. It is valid only for that single call and is invalidated when the call ends; it cannot be reused. (Token lifetime covers the platform max call duration so it never cuts an active call.)

post/v1/webrtc-token

Request

  • Base URL: https://api.revdesk.com
  • URL: https://api.revdesk.com/v1/webrtc-token
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

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

X-Revdesk-Caller-IPstring

Optional end-user IPv4 or IPv6 address reported by your server for the browser caller. Stored as client-reported diagnostics, separately from the API request IP; never used for authentication. Raw IPs expire after 30 days.

Request body

from_numberstring required
to_numberstring required
client_namestring
client_labelstring

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.