Skip to main content
POST
/
api
/
v1
/
public
/
agent
/
{uuid}
Initiate Call
curl --request POST \
  --url https://app.dograh.com/api/v1/public/agent/{uuid} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "phone_number": "<string>",
  "initial_context": {}
}
'
{
  "status": "<string>",
  "workflow_run_id": 123,
  "workflow_run_name": "<string>"
}
The simplest way to initiate a call programmatically. The uuid is visible in the dashboard URL when viewing an agent. Use workflow_run_id from the response to later retrieve call details, recordings, and transcripts. Pass initial_context to inject runtime data as template variables into the agent’s prompt. See Using initial context.
Your telephony provider must be configured before outbound calls will connect. See Telephony for setup instructions.

Headers

​
X-API-Key
string
required

Path Parameters

​
uuid
string
required

Body

application/json

Request model for triggering a call via API

​
phone_number
string
required
​
initial_context
Initial Context · object

Response

Successful Response

Response model for successful call initiation

​
status
string
required
​
workflow_run_id
integer
required
​
workflow_run_name
string
required