Route a Phone Number to Anything

Switch targets from the API

Two endpoints change a number's target. Both accept Authorization: Bearer sk_... or Basic auth with your Account SID and Auth Token.

PUT /v1/phone-numbers/{id}/inbound binds the four API-first targets in one call and provisions the telephony behind them: webhook, media_stream, conversation_relay and voice_agent. DELETE on the same path detaches it.

curl -X PUT https://voice-api.edesy.in/v1/phone-numbers/$PHONE_NUMBER_ID/inbound \
  -H "Authorization: Bearer $EDESY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target": "media_stream", "stream_url": "wss://bot.example.com/ws", "sample_rate": 16000}'

PATCH /v1/phone-numbers/{id}/routing sets any of webhook, sip, stream, relay, trunk, voiceagent, application, ivr or missed_call, with the fields that target needs, plus per-number options such as recording_enabled, outbound_caller_id and friendly_name.

# Send calls to an AI platform over SIP, with digest auth and a custom header
curl -X PATCH https://voice-api.edesy.in/v1/phone-numbers/$PHONE_NUMBER_ID/routing \
  -H "Authorization: Bearer $EDESY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inbound_target_type": "sip",
    "inbound_sip_uri": "sip:[email protected]",
    "inbound_sip_username": "edesy",
    "inbound_sip_password": "********",
    "inbound_sip_headers": {"X-Api-Secret": "********"}
  }'

# Turn the same number into a missed-call line
curl -X PATCH https://voice-api.edesy.in/v1/phone-numbers/$PHONE_NUMBER_ID/routing \
  -H "Authorization: Bearer $EDESY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_target_type": "missed_call"}'

SIP passwords and custom headers are stored encrypted. Sending inbound_sip_headers replaces the whole set; an empty object clears it. Softphones and forwarding rules are set from the dashboard and the forwarding portal. See inbound routing for every field.