Escalate a call using Twilio call bridge

Performs a warm transfer by bridging the current call to a human agent, keeping the caller connected during handoff.

POST /api/v1/automations/escalate-call-with-bridge

cURL

curl --request POST \
  --url 'https://api.voice.stateset.com/api/v1/automations/escalate-call-with-bridge' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "call_sid": "CA1234567890abcdef1234567890abcdef",
  "customer_phone": "[phone]",
  "metadata": {
    "order_id": "ORD-12345"
  },
  "reason": "customer requested a human agent",
  "session_id": "550e8400-e29b-41d4-a716-446655440000"
}'

200

{
  "ok": true,
  "result": {
    "message_sid": "SM1234567890abcdef",
    "queued_at": "2026-05-14T17:42:09Z"
  }
}

Performs a warm transfer by bridging the current call to a human agent, keeping the caller connected during handoff.

Request body

AutomationPayload

call_sid · string,null

Twilio call SID

customer_phone · string,null

Customer phone number in E.164 format

metadata · object

Optional workflow-specific metadata

reason · string,null

Human-readable workflow reason or note

session_id · string,null

Voice session identifier when the automation is tied to a persisted session

to · string,null

Destination phone number or escalation target

Response

AutomationResponse

error · string,null

Error message (present on failure)

ok · boolean · required

Whether the automation executed successfully

result · object

Result payload returned by the function (present on success)

Status codes

Code	Meaning
200	Automation executed successfully
400	Automation execution failed
401	Unauthorized - invalid or missing bearer token
500	Internal server error

cURL

curl --request POST \
  --url 'https://api.voice.stateset.com/api/v1/automations/escalate-call-with-bridge' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "call_sid": "CA1234567890abcdef1234567890abcdef",
  "customer_phone": "[phone]",
  "metadata": {
    "order_id": "ORD-12345"
  },
  "reason": "customer requested a human agent",
  "session_id": "550e8400-e29b-41d4-a716-446655440000"
}'

200

{
  "ok": true,
  "result": {
    "message_sid": "SM1234567890abcdef",
    "queued_at": "2026-05-14T17:42:09Z"
  }
}