---
title: "Create and asynchronously generate a standalone page."
method: POST
path: "/api/v1/pages"
tags: ["Pages"]
---

# Create and asynchronously generate a standalone page.

`POST /api/v1/pages`

## Request

- Base URL: `https://coloringbookify.com`
- URL: `https://coloringbookify.com/api/v1/pages`
- Auth: HTTP bearer

Generation consumes one credit.

## Headers

- `Idempotency-Key` string, required

## Request body

- PageCreateInput
  - `page` object, required
    - `title` string, required
    - `description` string
    - `kind` 'coloring' | 'freeform' | 'dedication' | 'quote' | 'test_color' | 'belongs'
    - `aspect` 'square' | 'portrait' | 'landscape'
    - `level` string
    - `privacy` string
    - `border_type` string
    - `outline_weight` string
    - `input_image` string, binary
    - `character_ids` string[]
    - `template_data` object

## Response `202`

Page generation accepted.

- object
  - `data` Operation, required
    - `id` string
    - `action` 'character.create' | 'character.regenerate' | 'book.create' | 'page.create' | 'page.regenerate'
    - `status` 'queued' | 'running' | 'succeeded' | 'partially_succeeded' | 'failed'
    - `credits` object
      - `charged` integer
      - `refunded` integer
    - `progress` object
    - `resource` object
      - `type` string
      - `id` string
      - `link` string
    - `error` object
      - `code` string
      - `message` string
    - `created_at` string, date-time
    - `started_at` string, date-time, nullable
    - `finished_at` string, date-time, nullable
    - `links` Links
  - `resource` object, required
    - `id` string
    - `title` string
    - `description` string, nullable
    - `status` string
    - `kind` string
    - `aspect` string
    - `level` string
    - `privacy` string
    - `outline_weight` string
    - `character_ids` string[]
    - `book_ids` string[]
    - `image_format` string
    - `book_index` integer, nullable
    - `error` 'Generation failed.'
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `links` Links

## Other responses

- `400`: Invalid request or idempotency key
- `401`: Bearer API key missing or invalid
- `402`: Not enough credits
- `403`: Active Business plan required
- `409`: Idempotency
- `422`: Validation failed

---

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