Parent object

Pages, databases, and blocks are either located inside other pages, databases, and blocks, or are located at the top level of a workspace. This location is known as the "parent". Parent information is represented by a consistent parent object throughout the API.

Parenting rules:

• Pages can be parented by other pages, databases, blocks, or by the whole workspace.
• Blocks can be parented by pages, databases, or blocks.
• Databases can be parented by pages, blocks, or by the whole workspace.

Database parent

Database parent example

{
  "type": "database_id",
  "database_id": "d9824bdc-8445-4327-be8b-5b47500af6ce"
}

Page parent

Page parent example

{
  "type": "page_id",
    "page_id": "59833787-2cf9-4fdf-8782-e53db20768a5"
}

Workspace parent

A page with a workspace parent is a top-level page within a Notion workspace. The parent property is an object containing the following keys:

Workspace parent example

{
    "type": "workspace",
    "workspace": true
}

Block parent

A page may have a block parent if it is created inline in a chunk of text, or is located beneath another block like a toggle or bullet block. The parent property is an object containing the following keys:

Block parent example

{
    "type": "block_id",
    "block_id": "7d50a184-5bbe-4d90-8f29-6bec57ed817b"
}