Skip to main content
Use the base URL https://facetime.trychert.com/api with project authentication.

Endpoints

See BYOR outbound calls for the complete request body, bridge credentials, and idempotency requirements.

Call records

A successful creation returns HTTP 201 and an envelope containing data and request_id. Read the new call ID from data.id. Creation does not prove that the destination answered or that media is ready.

Lifecycle and cleanup

For outbound audio and video, wait for bridge_ready (or the corresponding outbound call.started webhook) before starting the greeting. Deduplicate by call ID and ignore activation after termination. Monitor status, lifecycle events, and terminal reason. If your integration receives a call-ended or failure event, release your agent resources. Chert cleans up its bridge and stored room credentials; your service owns its room and agent cleanup. Choose a unique end key (END_KEY, 8–200 characters). HTTP 202 acknowledges the request; continue observing until the call is terminal and cleanup completes.

Additional call capabilities

  • Group calls and links use the existing create endpoint on enabled lines.
  • Busy-call queues return a waiting receipt before allocation.
  • Screen/media authorization, busy incoming-attempt reporting, and other advanced interfaces are described in Feature availability. Route presence does not establish that your line can run the feature.