---
search:
  tags:
    - Brands
    - PATCH
seo:
  description: >-
    Updates a Brand. Send the base_revision you read. Omit the body to keep it.
    Send… Reference for the PATCH /context/brands/{slug} endpoint in the
    AdCrunch API.
sidebar:
  label: Update a Brand
  badge: PATCH
title: Update a Brand
type: openapi-operation
---
Updates a Brand. Send the `base_revision` you read. Omit the `body` to keep it. Send `null` to clear it. The slug changes only when you send a `slug`: a new `name` alone never moves the handle. The answer is `409` with `error=revision_mismatch` if the Brand changed after you read it. It is `409` with `error=slug_conflict` if another Brand already holds the `slug` you send.

`PATCH /context/brands/{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), at most 50,000 characters. It replaces the old one. null clears it.
- `description` (string)
- `logo_document_id` (string | null) — Nominate one of the Brand's documents as its logo; null clears the nomination.
- `name` (string)
- `slug` (string) — Optional new slug handle (a deliberate rename).
- `website_url` (string<uri> | null) — The Brand's public site; null clears it. Changing it starts no read.

Request body example:

```json
{
  "base_revision": 4,
  "body": "## Identity\n\nAcme makes one running shoe and sells it direct. The promise is a thousand kilometres on the same pair, and a resole rather than a replacement.\n\n## Voice\n\nPlain and measured. Short sentences. No superlative the shoe cannot earn.\n\n## Guidelines\n\n- Name the distance, never the \"journey\".\n- Claim the kilometres the shoe is tested to, and no more.\n- Do not compare the shoe to a named competitor.\n\n## Messaging\n\n- One shoe, a thousand kilometres.\n- Resole it twice, and keep running on it.\n- Sold direct, so the price is the cost of the shoe.",
  "logo_document_id": "doc_5e2b41"
}
```

**Responses**

- `200` — The Brand as it now stands, at the next \`revision\`. Send that one back on your next edit.
- `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 \`brand:write\`. \`error\` is \`forbidden\`.
- `404` — No Brand with that slug. \`error\` is \`not\_found\`.
- `409` — \`error\` tells the two conflicts apart. \`revision\_mismatch\` means somebody wrote first — re-read, re-apply, and send \`currentRevision\` back. \`slug\_conflict\` means the rename collides.
- `422` — Two codes share this status. \`invalid\_slug\`: the new slug has no letter or digit. \`invalid\_logo\`: the nominated logo is not one of this Brand’s own finished documents.

Response example, 200:

```json
{
  "assignees": [
    {
      "id": "usr_4d8b12",
      "name": "Maya Lindqvist"
    }
  ],
  "body": "## Identity\n\nAcme makes one running shoe and sells it direct. The promise is a thousand kilometres on the same pair, and a resole rather than a replacement.\n\n## Voice\n\nPlain and measured. Short sentences. No superlative the shoe cannot earn.\n\n## Guidelines\n\n- Name the distance, never the \"journey\".\n- Claim the kilometres the shoe is tested to, and no more.\n- Do not compare the shoe to a named competitor.\n\n## Messaging\n\n- One shoe, a thousand kilometres.\n- Resole it twice, and keep running on it.\n- Sold direct, so the price is the cost of the shoe.",
  "createdAt": 1790000000000,
  "createdBy": "usr_4d8b12",
  "description": "Running shoes sold direct to the runner, made to last a thousand kilometres.",
  "id": "brd_6a9c33",
  "logoDocumentId": "doc_5e2b41",
  "name": "Acme",
  "revision": 5,
  "slug": "acme",
  "updatedAt": 1790086400000,
  "websiteUrl": "https://acme.example"
}
```
