Pular para o conteúdo principal
PUT
/
backend
/
leads
/
{id}
/
status
/
{status_id}
curl -X PUT "https://api.leavo.ai/backend/leads/550e8400-e29b-41d4-a716-446655440000/status/770e8400-e29b-41d4-a716-446655440001" \
  -H "Authorization: Bearer sua_chave_aqui"

// Sem conteúdo - status atualizado com sucesso

​
Path Parameters

​
id
string
obrigatório
UUID do lead
​
status_id
string
obrigatório
UUID do novo status

​
Response

Retorna 204 No Content em caso de sucesso.
Mudar o status de um lead pode disparar webhooks outbound configurados para o evento status_changed.
curl -X PUT "https://api.leavo.ai/backend/leads/550e8400-e29b-41d4-a716-446655440000/status/770e8400-e29b-41d4-a716-446655440001" \
  -H "Authorization: Bearer sua_chave_aqui"

// Sem conteúdo - status atualizado com sucesso

​
Exemplo de Fluxo de Status

// Buscar todos os status disponíveis
const statusList = await fetch('https://api.leavo.ai/backend/status', {
  headers: { 'Authorization': 'Bearer sua_chave_aqui' }
}).then(r => r.json());

// Encontrar o status "Qualificado"
const qualifiedStatus = statusList.find(s => s.name === 'Qualificado');

// Atualizar lead para "Qualificado"
await fetch(
  `https://api.leavo.ai/backend/leads/${leadId}/status/${qualifiedStatus.id}`,
  {
    method: 'PUT',
    headers: { 'Authorization': 'Bearer sua_chave_aqui' }
  }
);