> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leavo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Status do Lead

> Atualiza o status de um lead

## Path Parameters

<ParamField path="id" type="string" required>
  UUID do lead
</ParamField>

<ParamField path="status_id" type="string" required>
  UUID do novo status
</ParamField>

## Response

Retorna `204 No Content` em caso de sucesso.

<Info>
  Mudar o status de um lead pode disparar webhooks outbound configurados para o evento `status_changed`.
</Info>

<RequestExample>
  ```bash cURL theme={null}
  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"
  ```

  ```javascript JavaScript theme={null}
  const leadId = '550e8400-e29b-41d4-a716-446655440000';
  const newStatusId = '770e8400-e29b-41d4-a716-446655440001';

  const response = await fetch(
    `https://api.leavo.ai/backend/leads/${leadId}/status/${newStatusId}`,
    {
      method: 'PUT',
      headers: {
        'Authorization': 'Bearer sua_chave_aqui'
      }
    }
  );

  if (response.status === 204) {
    console.log('Status atualizado com sucesso');
  }
  ```

  ```python Python theme={null}
  import requests

  lead_id = '550e8400-e29b-41d4-a716-446655440000'
  new_status_id = '770e8400-e29b-41d4-a716-446655440001'

  response = requests.put(
      f'https://api.leavo.ai/backend/leads/{lead_id}/status/{new_status_id}',
      headers={'Authorization': 'Bearer sua_chave_aqui'}
  )

  if response.status_code == 204:
      print('Status atualizado com sucesso')
  ```
</RequestExample>

<ResponseExample>
  ```json 204 No Content theme={null}
  // Sem conteúdo - status atualizado com sucesso
  ```

  ```json 404 Not Found theme={null}
  {
    "success": false,
    "error": {
      "code": "NOT_FOUND",
      "message": "Lead or status not found"
    }
  }
  ```
</ResponseExample>

## Exemplo de Fluxo de Status

```javascript theme={null}
// 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' }
  }
);
```