Skip to main content
POST
Trigger an Outbound Agent Run by Agent UUID
Outbound calling is temporarily disabled. Use the browser tester or incoming calls to test your agent. The reference below does not enable outbound calling.
Requires a Labs OAuth user access token with super_user and at least Editor access to the selected workspace. API keys are not accepted for this endpoint. See authentication. Use this endpoint when you want to start an agent run 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 run 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 Phone numbers.
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 agent run instead.
Your telephony provider must be configured before outbound calls will connect. See Telephony for setup instructions.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workflow_uuid
string
required

Body

application/json
phone_number
string
required
initial_context
Initial Context · object | null
telephony_configuration_id
integer | null

Response

Successful Response

status
string
required
workflow_run_id
integer
required
workflow_run_name
string
required