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 throughout 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}

When to use the Agent UUID#

• Use the Agent UUID when an API trigger, SDK script, or external workflow needs a stable identifier for the agent.
• Prefer the UUID over numeric IDs when configuration may move between environments or when external systems store a long-lived reference.
• Keep the UUID with the integration configuration that calls Paladin so future workflow edits do not break the connection.

Implementation checklist#

1. Copy the UUID from the agent settings or workflow editor.
2. Store it in backend configuration, not in user-editable copy unless your workflow requires it.
3. Test the route or SDK call against a draft or test flow before using it for production calls.