Page writes return 504 when a request times out
By Steven Van ·
A timed-out page write now gets its own 504 status instead of a generic 500, while writes that run out of time budget still return 503.
Notion's API now returns HTTP 504 gateway_timeout when a page write runs past its deadline, instead of the HTTP 500 internal_server_error it returned before. This applies to updating a page's content as markdown and to the notion-update-page MCP tool; the notion-create-pages and notion-convert-page-to-skill MCP tools already returned 504 in this case.
A 504 does not mean the write was undone, so check whether the change was saved before retrying it. A write that runs out of its time budget still returns 503 service_unavailable, with additional_data.retry_guidance on what to do next. See the request limits page for when to retry each status.