Skip to main content
POST
Force lead workflow status

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de ruta

id
string<uuid>
requerido

Lead ID

Cuerpo

application/json
status_key
string
requerido

Target workflow status key (e.g. 'qualified', 'lost'). Must exist in the lead's workflow. List valid keys via GET /workflows/{id}.

reason
string

Optional human-readable reason, stored on the run and in the status history.

workflow_id
string<uuid>

Optional. Required only when the lead has multiple active workflow runs.

discard_reason_code
string
discard_reason_label
string
discard_reason_note
string
discard_reason_subcode
string | null
discard_reason_subcode_label
string | null

Respuesta

Status updated (or already in the target status)

success
boolean
changed
boolean

false when the lead was already in the target status (or a concurrent process moved it).

previous_status
string | null
new_status
string
workflow_run
object
note
string

Present only on a concurrent no-op transition.

Última modificación el 10 de septiembre de 2026