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/{provider}/{agent_uuid}