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
Moving a page updates its
last_edited_time and last_edited_by fields. The page URL may also change after the move.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
Related Methods
- pages.retrieve - Retrieve a page before moving
- pages.update - Update page properties after moving
- pages.create - Create a new page in a specific location