Skip to main content
POST
/
api
/
v1
/
public
/
agent
/
workflow
/
{workflow_uuid}
Initiate Call By Workflow Uuid
curl --request POST \
  --url https://app.dograh.com/api/v1/public/agent/workflow/{workflow_uuid} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "phone_number": "<string>",
  "initial_context": {},
  "telephony_configuration_id": 123
}
'
{
  "status": "<string>",
  "workflow_run_id": 123,
  "workflow_run_name": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.dograh.com/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint when you want to execute a workflow directly by its stable Agent UUID instead of through an API Trigger node. The workflow_uuid is the workflow’s Agent UUID. It is different from an API Trigger node’s trigger_path. To find and copy the Agent UUID in the UI, see Agent UUID. 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 a workflow UUID. Do not pass an API Trigger node UUID here. If you want to execute via an API Trigger node, use Trigger an outbound call 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

​
workflow_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

Successful Response

Response model for successful call initiation

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