Pages & Spaces

`createPage`

Create Page

Create a Page: a rich document in a Space.

write

Arguments

contentstringoptionalOptional markdown content. Use # headings, - lists, > blockquotes, --- horizontal rules, a URL alone on its own line for a link tile, and > [!emoji] for a callout.
docContractstringoptionalThe doc-contract slug this page CLAIMS to be, e.g. "builddoc" or "handoff-memo". Pass it whenever you are filing a staple. The server validates the content against that contract and REFUSES to file a malformed one, naming the missing or…
excerptstringoptionalOptional short summary shown wherever the page is listed: for a library-article it is the dek under the title on /library. Plain text, one or two sentences.
iconDataobjectoptionalPage icon for the sidebar. Use { type: 'emoji', value: '📌' }: one emoji aligned with the page subject; required for normal creates.
idempotencyKeystringoptionalOptional client-chosen key for guaranteed-once filing. Repeating createPage with the same key within 24h returns the ORIGINAL page (deduplicated) instead of creating another. Use one stable key per intended page when a session might retry…
parentIdstringoptionalOptional parent page ID for a sub-page
spaceIdstringoptionalOptional page space ID from listPageSpaces. Omit to use the caller's personal workspace (the default).
tagsstring[]optionalOptional tags applied to the page (plain strings, no leading #).
titlestringrequiredPage title
typestringoptionalOptional page kind. "memory" for a memory page; "library-article" for an official library CMS article: once published public in the configured library Space it appears at /library; "skill" for a skill page (prefer createSkill, which pairs…

Returns

You MAY pass an idempotencyKey for guaranteed-once filing: repeating a create with the same key within 24h returns the original page instead of a duplicate (identical replayed args are also…

Ask for it

The Cloud routes these requests to this verb.

make a page
write a doc
start a note about X
draft a X
write a library article

Pair it with

The verbs that finish the job.