Skip to main content
POST
/
v1
/
agents
/
{id}
/
dial
Dial outbound (Twilio or SIP trunk)
curl --request POST \
  --url https://api.vatel.ai/v1/agents/{id}/dial \
  --header 'Authorization: Bearer <token>'
{
  "success": true
}

Authorizations

​
Authorization
string
header
required

Send your organization API key as Authorization: Bearer <key>.

Path Parameters

​
id
string<uuid>
required

Agent id

Query Parameters

​
number
string

Callee to dial (alias of destination). Required for a successful dial unless you rely solely on destination. Must match destination if both are sent.

​
destination
string

Callee to dial (alias of number). Required for a successful dial unless you rely solely on number. Must match number if both are sent.

​
sipTrunkId
string<uuid>

UUID of a SIP trunk assigned to this agent. When set, outbound uses the SIP trunk path instead of Twilio.

​
callerId
string

When using sipTrunkId, optional SIP From user override; defaults to the agent id.

Response

Call request accepted (Twilio) or SIP dial accepted asynchronously (trunk path).

Acknowledgement that an outbound call was requested (Twilio) or that a SIP trunk dial was accepted to run asynchronously.

​
success
boolean
required

True when the provider accepted the call request.