---
title: "Make a page for every intent that is on and has none"
method: POST
path: "/apps/{id}/pages"
tags: ["Pages"]
---

# Make a page for every intent that is on and has none

`POST /apps/{id}/pages`

## Request

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

Each page is written, drawn and checked by its own job. A new page counts against the app's plan. Where the plan stops every page the answer is 402; where it stops some, they are counted in `skipped` and `limit` says why.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `locale` string: A language of the app. The app's own when left out.

## Response `200`

Every intent that is on already has a page.

- PagesStarted
  - `started` integer, required
  - `skipped` integer, required
  - `jobs` object[], required
    - `job_id` string, uuid, required
    - `page_id` string, uuid, nullable, required
  - `job_id` string, uuid, nullable, required: The first of `jobs`.
  - `limit` object: Why some were skipped, where the plan is why.
    - `code` string, required
    - `message` string, required
    - `upgrade` object, required

## Other responses

- `202`: Pages were started.
- `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.
- `402`: A plan's limit stopped the call. `error.code` is `upgrade_required`, `error.message` states the facts, and `error.upgrade.url` is the app's plan screen.
- `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)