Skip to main content
PUT
/
v1
/
leads
/
{id}
/
stage
Move o lead para uma etapa do funil (idempotente)
curl --request PUT \
  --url https://api.superlead.app/v1/leads/{id}/stage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "stage_id": "<string>"
}
'
{
  "lead_id": "<string>",
  "previous_stage": {
    "id": "<string>",
    "name": "<string>"
  },
  "current_stage": {
    "id": "<string>",
    "name": "<string>"
  },
  "changed": true,
  "moved_at": "<string>"
}

Authorizations

Authorization
string
header
required

Chave de API (sk_...)

Path Parameters

id
string
required
Example:

"lead_0b5f8a3e-..."

Body

application/json
stage_id
string
required
Pattern: ^stage_\d+$
reason
string
Required string length: 1 - 500

Response

Resultado do movimento

lead_id
string
required
previous_stage
object | null
required
current_stage
object
required
changed
boolean
required
moved_at
string
required