Ring the user now and patch them into a live call. They join by pressing 1; the caller goes quiet and takes back over when they press * or hang up. Mode "listen" lets them listen in without being heard. Tell the user before calling this.

post/api/calls/{call_id}/connect

Request

  • Base URL: https://call4.me
  • URL: https://call4.me/api/calls/{call_id}/connect
  • Auth: HTTP bearer

Path parameters

call_idstring required

the call id from placing or listing calls ("call_...")

Request body

phonestring

a different number to ring, e.g. "(415) 555-0123"

mode'join' | 'listen' required

"join" (default): they take the call over by pressing 1. "listen": they listen in while the caller keeps working, and can press 1 anytime to take over

Response

Ringing the user

call_idstring required
messagestring required

Changes

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