Skip to main content
POST
Creates a page inside a space. The page type decides where it appears: STANDARD in the space’s document tree, BLOG in the intranet blog feed, FOLDER as a folder in the tree and SCRIBBLE as a whiteboard.
Your API key needs the docs:write scope, and its owner needs the right to create pages in the space (the right to create blog posts for BLOG). The scope only narrows what the owner may do, it never adds rights. Pass your API key as a Bearer token in the Authorization header.

Request body

string
required
The unique slug identifier of the target space. Visible in the space URL.
string
required
The title of the page. Must be between 1 and 500 characters.
string
required
The type of page: STANDARD, BLOG, FOLDER or SCRIBBLE.
string
UUID of the parent page to nest this page under. The parent must be in the same space. Omit to create a top-level page.
array
The body as Plate JSON (an array of nodes). Only for STANDARD and BLOG; the maximum size is 1 MB. Omit to create an empty page.
Unknown fields are rejected with 422.

Idempotency

Send an Idempotency-Key header to retry safely. The same key with the same body within 24 hours returns the first answer with status 200 and the header Idempotency-Status: replayed, and creates no second page. The same key with a different body returns 422 with the code IDEMPOTENCY_MISMATCH. Without a key, every call creates a page.

Response

The response is wrapped in data.
string
required
Unique identifier (UUID) of the newly created page.
string
required
The title of the page as stored.
string
required
The page type: STANDARD, BLOG, FOLDER or SCRIBBLE.
string
required
The workflow status. A new page starts as DRAFT.
string
required
The full URL to view the page in Collabase.
string
required
The slug of the space the page lives in.
string | null
required
The parent page, or null for a top-level page.
string | null
required
The emoji shown in the tree, or null.
string
required
Creation time as an ISO 8601 timestamp.
string
required
Time of the last change as an ISO 8601 timestamp.
Last modified on November 4, 2026