# LeadPilot REST API — Follow-Ups & Sequences

**Document Version:** 1.0.0 (Phase 13)  
**Authentication:** Bearer Token (API Key)  
**Base URL:** `/api/v1`

---

## 1. List Follow-Ups

```http
GET /api/v1/followups?tab=due
Authorization: Bearer lp_live_YOUR_API_KEY
```

**Parameters:**
- `tab` / `status`: `due`, `upcoming`, `completed`, `failed`, `all`
- `lead_id`: Filter by lead UUID
- `assigned_user_id`: Filter by assigned user UUID
- `per_page`: 10–100 items

---

## 2. Create Manual Follow-Up Task

```http
POST /api/v1/followups
Authorization: Bearer lp_live_YOUR_API_KEY
Content-Type: application/json

{
  "lead_id": "9cb5a045-8fe1-4c48-8df0-202d6fae3b3a",
  "due_at": "2026-09-02T09:00:00Z",
  "reminder_notes": "Call prospect to review commercial contract terms."
}
```

---

## 3. Complete Follow-Up

```http
POST /api/v1/followups/{id}/complete
Authorization: Bearer lp_live_YOUR_API_KEY
Content-Type: application/json

{
  "notes": "Spoke for 20 minutes; scheduled proposal review for Friday."
}
```

---

## 4. Reschedule Follow-Up

```http
POST /api/v1/followups/{id}/reschedule
Authorization: Bearer lp_live_YOUR_API_KEY
Content-Type: application/json

{
  "due_at": "2026-09-05T14:30:00Z",
  "reason": "Client requested call next week."
}
```

---

## 5. Skip or Cancel Follow-Up

```http
POST /api/v1/followups/{id}/skip
POST /api/v1/followups/{id}/cancel
```