Pages

Update a page's content as markdown

Changed on
patch/v1/pages/{page_id}/markdown

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/pages/{page_id}/markdown
  • Auth
    HTTP bearer

Path parameters

page_idstring required

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Request body

OR
OR
OR

Example request

{
  "insert_content": {
    "content": "## New Section\n\nInserted content here."
  }
}

Response

object'page_markdown' required

The type of object, always 'page_markdown'.

idstring uuid required
markdownstring required

The page content as Markdown, in the syntax set by markdown_version: enhanced markdown (v1, the default) or Notion-flavored Markdown (v2).

truncatedboolean required

Whether the content was truncated due to exceeding the record count limit.

unknown_block_idsIdResponse[] required

Block IDs that could not be loaded (appeared as <unknown> tags in the markdown). Pass these IDs back to this endpoint to fetch their content separately.

Changes

  • ed50532d1d7eRevision changes
    • breaking

      added subschema #1 subschema #2 to the request body allOf list

    • warning

      removed subschema #1 subschema #2 from the request body allOf list

    • info

      added the optional property to the response with the status

  • c5c86cca7c79Revision changes
    • breaking

      the ///// request property's minLength was increased from 0 to 1