An application is a saved routing preset. It holds where calls go (a webhook, media stream, SIP URI, SIP trunk, Edesy AI voice agent or IVR flow), plus an outbound caller ID, a status callback and a recording setting. Attach one application to many numbers so they all behave the same, and pass its ID as application_id on POST/v1/calls to reuse it for outbound calls.

Endpoints#

Method	Path	Description
GET	`/v1/applications`	List applications
POST	`/v1/applications`	Create an application
GET	`/v1/applications/{id}`	Read one
PATCH	`/v1/applications/{id}`	Update (send only the fields to change)
DELETE	`/v1/applications/{id}`	Delete
POST	`/v1/applications/{id}/assign`	Attach numbers: `{"phone_number_ids": ["..."]}`
GET	`/v1/applications/{id}/numbers`	Numbers attached to it
GET	`/v1/applications/{id}/stats`	Call counts across its numbers, including answer rate, for a health view

There is no /v1/applications/{id}/calls endpoint. To place a call with an application, send application_id in the body of POST/v1/calls.

Create an application#

curl -X POST https://voice-api.edesy.in/v1/applications \
  -H "Authorization: Bearer $EDESY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support bot",
    "inbound_target_type": "stream",
    "inbound_stream_url": "wss://bot.example.com/ws",
    "inbound_stream_sample_rate": 16000,
    "outbound_caller_id": "+9180XXXXXXXX",
    "status_callback_url": "https://example.com/edesy/status",
    "recording_enabled": true
  }'

Field	Type	Required	Description
`name`	string	Required	Up to 255 characters
`friendly_name`	string	Optional	Display name
`inbound_target_type`	string	Required	`webhook`, `sip`, `stream`, `trunk`, `voiceagent` or `ivr`
`inbound_webhook_url`, `inbound_webhook_method`	string	for `webhook`	URL that returns VoiceML; GET or POST
`inbound_sip_uri`	string	for `sip`	`sip:` URI of your SIP endpoint
`inbound_stream_url`, `inbound_stream_sample_rate`	string, integer	for `stream`	`wss://` URL; `8000` or `16000`
`inbound_trunk_id`	UUID	for `trunk`	One of your SIP trunks
`ivr_flow_id`	UUID	for `ivr`	A published IVR Studio flow
`outbound_caller_id`	string	Optional	Default caller ID for outbound calls
`status_callback_url`	string	Optional	Receives status callbacks for calls on this application
`recording_enabled`	boolean	Optional	Record calls

Outbound calls with an application#

{ "from": "+9180XXXXXXXX", "to": "+9198XXXXXXXX", "application_id": "8d5c1e2a-0000-4000-8000-000000000000" }

Only applications whose target is stream or webhook can drive an outbound call. Any other target returns 400 VALIDATION_ERROR with a message naming the application. application_id cannot be combined with text, url, voiceml or stream_url.

Attaching to a number#

Set a number's inbound target to application with its application_id, or call POST/v1/applications/{id}/assign. A target set directly on a number overrides its application. See Inbound Routing.