> ## 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.

# Deletar Status

> Remove um status permanentemente

## Path Parameters

<ParamField path="id" type="string" required>
  UUID do status a ser removido
</ParamField>

<Warning>
  Não é possível deletar um status que está sendo usado por leads. Mova os leads para outro status antes de deletar.
</Warning>

<Warning>
  Não é possível deletar o status padrão. Defina outro status como padrão primeiro.
</Warning>

## Response

Retorna `204 No Content` em caso de sucesso.

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.leavo.ai/backend/status/770e8400-e29b-41d4-a716-446655440002" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```

  ```javascript JavaScript theme={null}
  const statusId = '770e8400-e29b-41d4-a716-446655440002';

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

  if (response.status === 204) {
    console.log('Status removido com sucesso');
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 204 No Content theme={null}
  // Sem conteúdo
  ```

  ```json 400 Bad Request theme={null}
  {
    "success": false,
    "error": {
      "code": "STATUS_IN_USE",
      "message": "Cannot delete status that is assigned to leads"
    }
  }
  ```
</ResponseExample>
