---
title: "Changes to Update a page's content as markdown"
method: PATCH
path: "/v1/pages/{page_id}/markdown"
---

# Changes to Update a page's content as markdown

`PATCH /v1/pages/{page_id}/markdown`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 39 revisions.

- **2026-10-08** `ed50532d1d7e`: 1 breaking, 1 warning, 1 info
- **2026-08-26** `c5c86cca7c79`: 1 breaking
- **2026-08-15** `c90a4587bc95`: 1 warning
- **2026-08-13** `ae20477af71b`: 1 breaking, 1 info
- **2026-08-12** `28d140865fc6`: 2 warning
- **2026-07-31** `301eea0116d9`: 2 warning
- **2026-07-26** `681ee94f046c`: 3 warning

## Changes

- **2026-10-08** `ed50532d1d7e`: 1 breaking, 1 warning, 1 info
  - added `subschema #1, subschema #2` to the request body `allOf` list
  - removed `subschema #1, subschema #2` from the request body `allOf` list
  - added the optional property `warnings` to the response with the `200` status
- **2026-08-26** `c5c86cca7c79`: 1 breaking
  - the `allOf[subschema #2]/oneOf[subschema #3: Update Content]/update_content/content_updates/items/old_str` request property's minLength was increased from `0` to `1`
- **2026-08-15** `c90a4587bc95`: 1 warning
  - added the new `idempotency_key_reused` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
- **2026-08-13** `ae20477af71b`: 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3` to the response body `oneOf` list for the response status `403`
  - removed `#/components/schemas/publicApiCommonErrorResponse, subschema #2` from the response body `allOf` list for the response status `403`
- **2026-08-12** `28d140865fc6`: 2 warning
  - added the new `agent_credit_limit_reached` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
  - added the new `workspace_credits_exhausted` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
- **2026-07-31** `301eea0116d9`: 2 warning
  - added the new `invalid_beta` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
  - added the new `invalid_credit_limit` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
- **2026-07-26** `681ee94f046c`: 3 warning
  - added the new `agent_deleted` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
  - added the new `directory_not_found` enum value to the `allOf[subschema #2]/code` response property for the response status `404`
  - added the new `status_change_not_allowed` enum value to the `allOf[subschema #2]/code` response property for the response status `403`

---

[Operation](https://skmtc.dev/notion/apis/notion-api/docs/v1/pages/:page_id/markdown/patch.md) - [API](https://skmtc.dev/notion/apis/notion-api.md) - [Page](https://skmtc.dev/notion/apis/notion-api/changes/v1/pages/:page_id/markdown/patch)