dograh/docs/configurations/agent-uuid.mdx

43 lines
1.5 KiB
Text

---
title: "Agent UUID"
description: "Find and use your workflow's stable Agent UUID"
---
The **Agent UUID** is the workflow's stable identifier. In API routes and payloads you may also see it called `workflow_uuid`.
Unlike numeric workflow IDs, the Agent UUID is portable across environments and does not change when you publish new versions of the same workflow.
## 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}`
- `wss://<your-host>/api/v1/agent-stream/{agent_uuid}`
<Note>
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 Dograh and cannot be changed
See [API Trigger](/voice-agent/api-trigger) for trigger-node URLs.
</Note>