NotionNotion collaborative workspace API
POST/v1/pages/{page_id}/move
Move a page
Moves a page to a new parent or position, which can restructure the page tree.
Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.
Request
- operationId
movePage- Server
https://api.notion.com- Authentication
- bearerAuth, basicAuth
Request parameters
page_id
pathidRequestrequired
Notion-Version
headerstringrequired
API version date for the request; the current latest version is 2026-03-11.
2026-03-11
Request body
objectrequired
Properties: parent
Responses
200
stringapplication/json
Request succeeded.
400
error_api_400application/json
Request parameters are invalid.
401
error_api_401application/json
Unauthenticated or the token is invalid.
403
error_api_403application/json
Access to the resource is forbidden.
404
error_api_404application/json
The requested resource was not found.
406
error_api_406application/json
The request cannot be represented as requested.
409
error_api_409application/json
The request conflicts with the current state of the resource.
429
error_api_429application/json
Rate limited; retry after Retry-After.
500
error_api_500application/json
Upstream internal error.
503
error_api_503application/json
Upstream service temporarily unavailable.
504
error_api_504application/json
Upstream gateway timeout.
529
error_api_529application/json
Upstream overloaded; retry like a 429.