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

# Gerenciar Cadências

> Listar, atualizar, ativar e deletar cadências

## Listar Cadências

<Card>
  <strong>GET</strong> `/backend/cadences`
</Card>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.leavo.ai/backend/cadences" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": "uuid",
      "name": "Follow-up 7 dias",
      "description": "Sequência de acompanhamento",
      "is_active": true,
      "steps_count": 3,
      "leads_enrolled": 150,
      "created_at": "2024-01-01T00:00:00Z"
    }
  ]
  ```
</ResponseExample>

***

## Obter Cadência

<Card>
  <strong>GET</strong> `/backend/cadences/{id}`
</Card>

<ParamField path="id" type="string" required>
  UUID da cadência
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.leavo.ai/backend/cadences/uuid" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```
</RequestExample>

***

## Atualizar Cadência

<Card>
  <strong>PUT</strong> `/backend/cadences/{id}`
</Card>

<ParamField path="id" type="string" required>
  UUID da cadência
</ParamField>

<Warning>
  Atualizar uma cadência ativa pode afetar leads que já estão na sequência. Considere desativar antes de fazer alterações significativas.
</Warning>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT "https://api.leavo.ai/backend/cadences/uuid" \
    -H "Authorization: Bearer sua_chave_aqui" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Follow-up 7 dias (Atualizado)",
      "description": "Nova descrição"
    }'
  ```
</RequestExample>

***

## Ativar Cadência

<Card>
  <strong>POST</strong> `/backend/cadences/{id}/activate`
</Card>

Ativa uma cadência para começar a processar leads.

<ParamField path="id" type="string" required>
  UUID da cadência
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.leavo.ai/backend/cadences/uuid/activate" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "uuid",
    "name": "Follow-up 7 dias",
    "is_active": true,
    "message": "Cadence activated successfully"
  }
  ```
</ResponseExample>

***

## Desativar Cadência

<Card>
  <strong>POST</strong> `/backend/cadences/{id}/deactivate`
</Card>

Desativa uma cadência. Leads que já estão na sequência não receberão mais mensagens.

<ParamField path="id" type="string" required>
  UUID da cadência
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.leavo.ai/backend/cadences/uuid/deactivate" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "uuid",
    "name": "Follow-up 7 dias",
    "is_active": false,
    "message": "Cadence deactivated successfully"
  }
  ```
</ResponseExample>

***

## Deletar Cadência

<Card>
  <strong>DELETE</strong> `/backend/cadences/{id}`
</Card>

<ParamField path="id" type="string" required>
  UUID da cadência
</ParamField>

<Warning>
  Não é possível deletar uma cadência ativa. Desative-a primeiro.
</Warning>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.leavo.ai/backend/cadences/uuid" \
    -H "Authorization: Bearer sua_chave_aqui"
  ```
</RequestExample>

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

  ```json 400 Bad Request theme={null}
  {
    "success": false,
    "error": {
      "code": "CADENCE_ACTIVE",
      "message": "Cannot delete an active cadence. Deactivate it first."
    }
  }
  ```
</ResponseExample>