# PATCH /lead-gen/initiatives/:id

**Resource:** [Lead Generation](./lead-gen.md)  
**Scopes:** `lead-gen:write`  
**Write operation:** yes

Update an outreach initiative's name, description, status, or daily send cap. Set status to "active" to begin processing enrolments, "paused" to temporarily halt sends.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Initiative UUID |
| `name` | body | string | no | Updated name |
| `description` | body | string | no | Updated description |
| `status` | body | string | no | New status: draft, active, paused, completed |
| `daily_send_cap` | body | integer | no | Updated daily send cap (null to remove cap) |

## Request example

```bash
curl -X PATCH \
  "https://api.trustpager.com/functions/v1/api/v1/lead-gen/initiatives/a1b2c3d4-..." \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"active"}'
```

## Response example

```json
{
  "id": "a1b2c3d4-...",
  "name": "Q3 Roofing Outreach",
  "status": "active",
  "updated_at": "2026-05-02T09:00:00Z"
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`