---
title: "Free the place of a page issued in local mode"
method: POST
path: "/pages/{id}/retire"
tags: ["Local mode"]
---

# Free the place of a page issued in local mode

`POST /pages/{id}/retire`

## Request

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

The user's statement that the page is no longer wanted in App Store Connect. Its place on the plan is free again, and the page is approved and ready here with none of Apple's ids kept. Pagefully does not check and does not touch App Store Connect: deleting the page there is the developer's to do. Safe to send twice. A page Pagefully sent itself is taken back on the Publish screen of the web app, not here.

## Path parameters

- `id` string, uuid, required

## Response `200`

Retired.

- object
  - `retired` boolean, required
  - `already` boolean, required: It had been retired before, and nothing changed.
  - `page_id` string, uuid, required
  - `name` string, required
  - `meter` object, required
    - `plan` string, required
    - `pages_out` integer, required
    - `pages_allowed` integer, required
  - `said` string, required

## Other responses

- `401`: No token, or one that is not valid or has been revoked.
- `403`: The token's scope does not allow this call. Local mode needs the full scope.
- `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. `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)