pages

Update a page's title, body, properties, or draft status

editor+. A change to title or body snapshots a revision first. props replaces the whole bag — send the properties you want to keep. There is no section-level patch over REST; the patch_page MCP tool is the only place heading-path targeting exists.

patch/api/pages/{id}

Request

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

Request body

titlestring
bodystring

The whole markdown document.

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.

base_versioninteger

The page version you last read. If the page has changed since, the write is refused with 409 version_conflict instead of overwriting that edit. Omit for last-write-wins.

reset_collabboolean

Set when the body was edited outside the page's live collaborative session (e.g. as raw markdown). Anyone with the page open in the editor reloads it from the new body.

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.