---
search:
  tags:
    - Campaign Plans
    - PATCH
seo:
  description: >-
    Updates a Campaign Plan. Send the base_revision you read. Omit a field…
    Reference for the PATCH /context/campaign-plans/{slug} endpoint in the
    AdCrunch API.
sidebar:
  label: Update a Campaign Plan
  badge: PATCH
title: Update a Campaign Plan
type: openapi-operation
---
Updates a Campaign Plan. Send the `base_revision` you read. Omit a field to keep it. Send `null` to clear it.

**Any change puts an approved plan back into draft.** An approval speaks about content, and it cannot survive a change to that content. A write that changes nothing keeps the approval, and it does not move the `revision`.

The Line Items keep the state they hold. The revert is local to the Campaign Plan, so a `validated` line stays validated.

The answer is `409` with `error=currency_frozen` if a Line Item already has a budget or a cost target, with `error=revision_mismatch` if the Campaign Plan changed after you read it, and with `error=slug_conflict` if the new name gives a slug that already exists.

`PATCH /context/campaign-plans/{slug}`

**Request body** (`application/json`, required)

- `base_revision` (integer, required) — The revision last read via GET — guards concurrent edits.
- `body` (string | null) — The whole new body (markdown): it replaces the old one. null clears it. A change returns an approved Campaign Plan to draft.
- `brand_name` (string | null) — Re-point the Campaign Plan at another Brand by slug; null unlinks it. Refused with 409 error=persona\_not\_in\_brand while any Line Item still names a Persona of the current Brand.
- `currency` (string) — ISO 4217. Refused with 409 error=currency\_frozen once any Line Item carries a budget or a cost target (\`cpa\`, \`cpc\` or \`cpm\`) — re-denominating a costed plan would silently reinterpret every number in it.
- `description` (string)
- `end_date` (string | null) — null makes the Campaign Plan always-on — which also flips every inheriting line’s amount from a total to a daily rate.
- `name` (string)
- `slug` (string) — Optional new slug handle (a deliberate rename).
- `start_date` (string | null)
- `total_budget` (number | null) — null means "no declared constraint", not zero.

Request body example:

```json
{
  "base_revision": 3,
  "end_date": "2026-06-30",
  "total_budget": 7500
}
```

**Responses**

- `200` — The Campaign Plan as it now stands. A change takes the approval away and moves the \`revision\`; the Line Items keep the state they hold.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`campaign\_plan:write\`. \`error\` is \`forbidden\`.
- `404` — No Campaign Plan with that slug, or \`brand\_name\` names no Brand. \`error\` is \`not\_found\` for both.
- `409` — Four codes share this status. \`revision\_mismatch\`: somebody wrote first. \`slug\_conflict\`: the rename collides. \`persona\_not\_in\_brand\`: re-pointing the Campaign Plan would orphan Line Items that name a Persona of the current Brand, and \`lineItemIds\` names them — they are not cleared for you. \`currency\_frozen\`: a Line Item already carries a budget or a cost target (\`cpa\`, \`cpc\` or \`cpm\`), so the denomination is fixed; nothing is ever converted.
- `422` — \`invalid\_slug\`, \`invalid\_currency\`, \`invalid\_amount\` or \`invalid\_window\`.

Response example, 200:

```json
{
  "allocation": {
    "allocated": 2500,
    "comparable": true,
    "unallocated": 5000,
    "unit": "total"
  },
  "assignees": [
    {
      "id": "usr_4d8b12",
      "name": "Maya Lindqvist"
    }
  ],
  "body": "## Why this split\n\nMeta carries the reach. One Line Item keeps the budget in one place.\n\n## How it will be judged\n\nRevenue in the window, against the spring of 2025.",
  "brand": {
    "name": "Acme",
    "slug": "acme"
  },
  "brandId": "brd_6a9c33",
  "commentCount": 2,
  "createdAt": 1768435200000,
  "createdBy": "usr_5d2b71",
  "currency": "EUR",
  "description": "The spring sale of Acme, on Meta, in France and Belgium.",
  "endDate": "2026-06-30",
  "id": "cpl_4e1a08",
  "lineItemCount": 1,
  "name": "Spring Sale 2026",
  "revision": 4,
  "slug": "spring-sale",
  "startDate": "2026-03-01",
  "status": "draft",
  "totalBudget": 7500,
  "updatedAt": 1769644800000
}
```
