Move Page

Use Case

Use this endpoint to move a normal page, database, mind map, or folder under another page, database, or the workspace root. It moves page-level objects only; use block endpoints for normal content blocks.

Endpoint

Permissions

Requires pages.write. The source object and target parent must both be in the current bot workspace, and the bot must have write access to both.

Parameters

Path Parameters

Request Body

parent supports these forms:

{ "workspace": true }

{ "page_id": "55555555-5555-4555-8555-555555555555" }

{ "database_id": "66666666-6666-4666-8666-666666666666" }

Request Example

{
  "parent": {
    "page_id": "55555555-5555-4555-8555-555555555555"
  },
  "after": "12121212-1212-4212-8212-121212121212"
}

Move to workspace root:

{
  "parent": {
    "workspace": true
  },
  "before": "34343434-3434-4434-8434-343434343434"
}

Response Example

{
  "object": "move_result",
  "id": "22222222-2222-4222-8222-222222222222",
  "object_type": "page",
  "parent": {
    "type": "page_id",
    "page_id": "55555555-5555-4555-8555-555555555555"
  },
  "after": "12121212-1212-4212-8212-121212121212",
  "before": null
}

object_type can be:

Behavior

• If neither after nor before is provided, the object moves to the end of the target parent's direct child list.
• after or before must reference a direct child of the target parent.
• A page-level object cannot be moved under itself or one of its descendants.
• parent.database_id moves the object under a database as a record; this endpoint does not set database properties.
• Normal content blocks should still be moved with block endpoints.

Errors

• 400 validation_error: missing parent, multiple parent targets, both after and before, position sibling is not a direct child of target parent, or target is self or descendant.
• 401 unauthorized: invalid or expired token.
• 403 forbidden: missing pages.write, no write access to the source object, or no write access to the target parent.
• 404 not_found: source object or target parent does not exist.

Related Docs

Prerequisites

• Get Page
• Create Page

Next Steps

• Update Page

References

• Scope Reference
• Error Codes