Trigger an Outbound Call by API Trigger Node

Initiate an outbound call using an API Trigger node UUID

POST /api/v1/public/agent/{uuid}

Initiate Call

cURL

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": {},
  "telephony_configuration_id": 123
}
'

200

{
  "status": "<string>",
  "workflow_run_id": 123,
  "workflow_run_name": "<string>"
}

Use this endpoint when you want to execute a workflow through an API Trigger node.

The uuid comes from the API Trigger node in your agent. Add the node to your workflow and copy its auto-generated trigger_path.

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.

Pass telephony_configuration_id to route the call through a specific telephony configuration instead of your organization’s default. The id is shown on each row in Telephony configurations (https://app.dograh.com/telephony-configurations for hosted or http://localhost:3010/telephony-configurations for local).

This route expects an API Trigger node UUID (trigger_path). Do not pass a workflow UUID here. If you want to execute by workflow UUID, use Trigger an outbound call by workflow UUID instead.

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

telephony_configuration_id · integer | null

Response

200

application/json

Successful Response

Response model for successful call initiation

status · string · required

workflow_run_id · integer · required

workflow_run_name · string · required