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

# Manage Cadences

> List, update, and control cadences

## List Cadences

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

### Response

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "cadence-uuid",
      "name": "New Lead Welcome",
      "description": "Welcome sequence",
      "active": true,
      "steps_count": 3,
      "leads_enrolled": 150
    }
  ]
}
```

***

## Get Cadence

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

Returns complete cadence with all steps.

***

## Update Cadence

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

```bash theme={null}
curl -X PUT "https://api.leavo.ai/backend/cadences/cadence-uuid" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Welcome",
    "active": false
  }'
```

***

## Delete Cadence

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

```bash theme={null}
curl -X DELETE "https://api.leavo.ai/backend/cadences/cadence-uuid" \
  -H "Authorization: Bearer your_api_key_here"
```

***

## Enroll Lead

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

### Body Parameters

<ParamField body="lead_id" type="string" required>
  Lead ID to enroll
</ParamField>

```bash theme={null}
curl -X POST "https://api.leavo.ai/backend/cadences/cadence-uuid/enroll" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_id": "lead-uuid"
  }'
```

***

## Remove Lead

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

```bash theme={null}
curl -X DELETE "https://api.leavo.ai/backend/cadences/cadence-uuid/leads/lead-uuid" \
  -H "Authorization: Bearer your_api_key_here"
```

***

## List Enrolled Leads

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

```json theme={null}
{
  "success": true,
  "data": [
    {
      "lead_id": "lead-uuid",
      "lead_name": "John Smith",
      "current_step": 2,
      "enrolled_at": "2024-01-15T10:30:00Z",
      "next_step_at": "2024-01-16T10:30:00Z"
    }
  ]
}
```