Skip to main content
Outbound calling is temporarily disabled. Use the browser tester or incoming calls to test your agent. The reference below does not enable outbound calling.
The Agent UUID is the workflow’s stable identifier. In API routes and payloads you may also see it called workflow_uuid. The Agent UUID stays the same when you publish new versions of that agent. Use the UUID belonging to the target workspace; do not assume IDs are shared between workspaces.

Where to find it

You can copy the Agent UUID from two places in the dashboard.

From the workflow editor

  1. Open your agent in the workflow editor
  2. Click the ⋮ menu in the top-right of the header
  3. Click Copy Agent UUID

From the agent’s Settings page

  1. Open the agent and go to Settings
  2. Scroll to the Agent UUID section
  3. Click the UUID code block, or use Copy UUID

Where you use it

Use the Agent UUID for workflow-level routes such as:
  • POST /api/v1/public/agent/workflow/{workflow_uuid}
  • POST /api/v1/public/agent/test/workflow/{workflow_uuid}
Do not confuse the Agent UUID with an API Trigger node UUID (trigger_path).
  • Use the Agent UUID for workflow-level routes like /public/agent/workflow/{workflow_uuid}
  • Use the API Trigger node UUID for trigger routes like /public/agent/{uuid}
  • The API Trigger node path can be edited if you want something more descriptive
  • The Agent UUID is generated by Bandwidth Agent Builder and cannot be changed
See API Trigger for trigger-node URLs.