Create page
Create a page from Markdown, at the top of a project, inside another page or in a folder. Pages nest three levels deep.
/v1/w/{workspace}/pagesSend an Idempotency-Key. This may answer 202 while it waits for approval.
Path parameters
workspacestringrequiredYour workspace’s address name.
Headers
Idempotency-Keystring8–100 characters. Repeat the same key and body to get the first outcome back instead of writing twice.
Body
titlestringrequiredThe page’s title.
markdownstringThe content as Markdown: headings, lists, to-dos (- [ ]), quotes, code, tables, links and **bold**/_italic_.
blocksobject[]Page blocks, including embed blocks. Use instead of markdown.
projectIdstringProject id for a new top-level page. Alias of project.
projectstringWhere a top-level page goes: general, a product key like APP, or a custom project’s id. Defaults to general.
parentIdstringPut it inside this page instead.
folderIdstring | nullFile a top-level page in this folder, in the same project.
iconstringAn icon like hi:rocket, or one emoji.
Response
createdstringrequiredtitlestringrequiredversionnumberrequiredDetails
Create a page from blocks or Markdown: headings, lists, to-dos (- [ ]), quotes, code fences, tables, dividers, **bold**, _italic_, `code`, links, [[pg_id]] page links and item ids such as LIT-12. Put it at the top of a project, or inside another page (pages go three levels deep).