---
search:
  tags:
    - Personas
    - PATCH
seo:
  description: >-
    Updates a Persona. Send the base_revision you read. Omit… Reference for the
    PATCH /context/brands/{slug}/personas/{personaSlug} endpoint in the AdCrunch
    API.
sidebar:
  label: Update a Persona
  badge: PATCH
title: Update a Persona
type: openapi-operation
---
Updates a Persona. Send the `base_revision` you read. Omit the `body` or an age bound to keep it. Send `null` to clear it. AdCrunch checks the age range on the result of the merge. Therefore a call that sends only `age_min` can still fail, if the result is inverted. 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 Persona changed after you read it. It is `409` with `error=slug_conflict` if another Persona of this Brand already holds the `slug` you send.

`PATCH /context/brands/{slug}/personas/{personaSlug}`

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

- `age_max` (integer | null) — Upper age bound; null clears it ("and older").
- `age_min` (integer | null) — Lower age bound; null clears it ("and younger").
- `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)
- `name` (string)
- `slug` (string) — Optional new slug handle (a deliberate rename).

Request body example:

```json
{
  "base_revision": 2,
  "body": "## Profile\n\nRunners of 40 to 80 kilometres a week, ten years in, with one pair in rotation and one on the shelf.\n\n## Motivations\n\nThey want the same shoe again, and proof that it is the same. A resole keeps them running on a pair they trust.\n\n## Frictions\n\nThey fear the new model is worse than the one they know. A change of sole or of last reads to them as a risk, not as progress.\n\n## Language\n\nThey say \"my daily trainer\" and \"I got 900 out of the last pair\". They ask about the drop and the stack, never about the technology."
}
```

**Responses**

- `200` — The Persona 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 such Brand, or no Persona with that slug inside it. \`error\` is \`not\_found\`.
- `409` — \`error\` tells the two conflicts apart: \`revision\_mismatch\` and \`slug\_conflict\`.
- `422` — \`invalid\_slug\`, or \`invalid\_age\_range\`. The age range is checked against the \*\*merged\*\* result, so sending only \`age\_min\` can still be rejected as inverted.

Response example, 200:

```json
{
  "ageMax": 45,
  "ageMin": 28,
  "body": "## Profile\n\nRunners of 40 to 80 kilometres a week, ten years in, with one pair in rotation and one on the shelf.\n\n## Motivations\n\nThey want the same shoe again, and proof that it is the same. A resole keeps them running on a pair they trust.\n\n## Frictions\n\nThey fear the new model is worse than the one they know. A change of sole or of last reads to them as a risk, not as progress.\n\n## Language\n\nThey say \"my daily trainer\" and \"I got 900 out of the last pair\". They ask about the drop and the stack, never about the technology.",
  "brandId": "brd_6a9c33",
  "createdAt": 1790000000000,
  "createdBy": "usr_4d8b12",
  "description": "Runners who already own a pair, and who buy the next one without looking at another brand.",
  "id": "psn_8c4a20",
  "name": "Loyalists",
  "revision": 3,
  "slug": "loyalists",
  "updatedAt": 1790086400000
}
```
