Skip to main content
POST
This moves the lead to a different AI agent (workflow). It does not change the lead’s owner — the person on your team responsible for it.To set the owner, send assigned_to on PATCH /leads/ or when creating the lead.

Authorizations

X-API-Key
string
header
required

API key for authentication. Keys are prefixed with nxr_live_.

Path Parameters

id
string<uuid>
required

Lead ID

Body

application/json
workflow_id
string<uuid>
required

ID of the workflow to assign the lead to. Use GET /workflows to list available workflows. workflowId (camelCase) is accepted as an alias.

Example:

"123e4567-e89b-12d3-a456-426614174000"

reason
string

Optional reason for the assignment. Stored on the deactivated workflow run when reassigning.

Example:

"Lead qualified for premium workflow"

Response

Workflow assigned successfully

success
boolean
required
workflow_run
object
required
Last modified on August 4, 2026