---
title: "Change the brief"
method: PATCH
path: "/apps/{id}/brief"
tags: ["Brief"]
---

# Change the brief

`PATCH /apps/{id}/brief`

## Request

- Base URL: `https://pagefully.com/api/v1`
- URL: `https://pagefully.com/api/v1/apps/{id}/brief`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `locale` string: A language of the app. The app's own when left out.
  - `summary` string: Two sentences, 400 characters at most.
  - `audience` string[]: Up to 5.
  - `jobs` object[]: Up to 5.
    - `job` string, required
    - `screen` integer, nullable, required
  - `tone` string[]: Up to 5.
  - `brand` object: Colours and typeface, in the shape GET returns.

## Response `200`

The brief as saved.

- object
  - `brief` Brief, required
    - `locale` string, required
    - `summary` string, required
    - `audience` string[], required
    - `jobs` object[], required
      - `job` string, required
      - `screen` integer, nullable, required
    - `tone` string[], required
    - `brand` object, required
    - `approved` boolean, required
    - `edited_at` string, nullable, required
    - `generated_at` string, required

## Other responses

- `400`: The request could not be read: a body that is not a JSON object, or a field missing or of the wrong kind.
- `401`: No token, or one that is not valid or has been revoked.
- `403`: The token's scope does not allow this call.
- `404`: Not found on this workspace.
- `422`: Understood, and refused by the product. The message says why, in a sentence that can be shown as it is.
- `429`: Too many calls: 120 requests a minute for a token, and 20 generation starts an hour. `retry_after` is seconds.

---

[API](https://skmtc.dev/pagefully/apis/pagefully-api.md) · [All operations](https://skmtc.dev/pagefully/apis/pagefully-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pagefully/apis/pagefully-api/revisions/60e17ce09d31?raw)