pages

Create a page

editor+ on the target space. Two server-side transforms to know about: leading YAML frontmatter in body is lifted into props (except on deck and sheet pages, whose bodies are stored verbatim), and a leading # Heading identical to title is stripped.

post/api/pages

Request

  • Base URL: https://telawiki.com
  • URL: https://telawiki.com/api/pages
  • Auth: one of:
    • HTTP bearer
    • API key in cookie tela_session

Request body

space_idinteger required
parent_idinteger nullable

Omit or null for a top-level page. Must live in the same space.

titlestring required
bodystring

Markdown.

propsPageProps

Free-form page properties. Reserved keys are dropped. Two are load-bearing: deck: true makes the body a Slidev presentation, sheet: true makes it a spreadsheet — both are then stored verbatim, frontmatter included.

status'draft' | 'published'

A draft is labelled in the app and never served on public spaces or share links until published. Defaults to published.

Example request

{
  "props": {
    "status": "draft",
    "owner": "platform-team"
  }
}

Response

The page.

Example response

{
  "page": {
    "props": {
      "status": "draft",
      "owner": "platform-team"
    },
    "created_at": "2026-09-09 14:03:21",
    "updated_at": "2026-09-09 14:03:21"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.