Skip to main content
Moves a page to a new parent location. The page can be moved to a different page (making it a child page) or to a different data source (database).

Method Signature

Parameters

string
required
The ID of the page to move (with or without dashes).
object
required
The new parent location for the page.
string
Bearer token for authentication. Overrides the client-level authentication.

Response

string
Always "page"
string
The ID of the moved page
string
ISO 8601 timestamp when the page was created
string
ISO 8601 timestamp when the page was last edited (updated after the move)
boolean
Whether the page is archived
boolean
Whether the page is in trash
boolean
Whether the page is locked from editing
string
The URL of the Notion page (may change after move)
string | null
The public URL if published to the web
object
Information about the page’s new parent location
object
Property values of the page
object | null
Page icon
object | null
Page cover image
object
User who created the page
object
User who last edited the page

Examples

Move Page to Another Page

Move a page to become a child of another page:

Move Page to a Data Source

Move a page into a database (data source):

Move with Type Guard

Organize Pages into Sections

Move Page from Database to Page

Error Handling

Conditional Move Based on Property

Important Notes

When moving a page from one database to another, ensure the target database has compatible properties. The page will retain its property values, but incompatible properties may be lost.
Moving a page updates its last_edited_time and last_edited_by fields. The page URL may also change after the move.
You need appropriate permissions to move a page. The integration must have access to both the page being moved and the destination parent.

Use Cases

  • Organize content: Move pages into different sections or categories
  • Archive completed items: Move finished tasks to an archive page
  • Restructure hierarchy: Reorganize your workspace structure
  • Promote database items: Convert database entries to standalone pages
  • Migrate data: Move pages between databases

See Also