Notion API - Public Beta (English)
  1. Other
Notion API - Public Beta (English)
  • Introduction
  • Integration capabilities
  • Request limits
  • Status codes
  • ENDPOINTS
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Delete a block
      • Append block children
      • Retrieve a block
      • Update a block
      • Retrieve block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
    • Pages
      • Archive a page
      • Retrieve a page property item
      • Create a page
      • Retrieve a Page
      • Update Page properties
    • Users
      • List all users
      • Retrieve your token's bot user
      • Retrieve a user
    • Comments
      • Create comment
      • Retrieve comments
    • Search
      • Search optimizations and limitations
      • Search by title
  • OBJECTS
    • Block
    • Comment
    • Unfurl attribute object for Link Previews
    • Page
      • Page
      • Page properties
    • Database
      • Database
      • Database properties
    • User
      • User
      • Comment
    • Other
      • Emoji object
      • File object
      • Parent object
      • Rich text object
  • Versioning
    • Versioning
    • Changes by version
  • ENDPOINTS Copy
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Retrieve a block
      • Update a block
      • Retrieve block children
      • Delete a block
      • Append block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
      • Create a database
    • Pages
      • Archive a page
      • Retrieve a Page
      • Update Page properties
      • Retrieve a page property item
      • Create a page
    • Users
      • Retrieve a user
      • List all users
      • Retrieve your token's bot user
    • Comments
      • Create comment
      • Retrieve comments
  1. Other

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#

PropertyTypeDescriptionExample values
typestringAlways "database_id"."database_id"
database_idstring (UUIDv4)The ID of the database that this page belongs to."b8595b75-abd1-4cad-8dfe-f935a8ef57cb"
Database parent example
{
  "type": "database_id",
  "database_id": "d9824bdc-8445-4327-be8b-5b47500af6ce"
}

Page parent#

PropertyTypeDescriptionExample values
typestringAlways "page_id"."page_id"
page_idstring (UUIDv4)The ID of the page that this page belongs to."59833787-2cf9-4fdf-8782-e53db20768a5"
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:
PropertyTypeDescriptionExample values
typetypeAlways "workspace"."workspace"
workspacebooleanAlways true.true
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:
PropertyTypeDescriptionExample values
typetypeAlways "block_id"."block_id"
block_idstring (UUIDv4)The ID of the page that this page belongs to."ea29285f-7282-4b00-b80c-32bdbab50261"
Block parent example
{
    "type": "block_id",
    "block_id": "7d50a184-5bbe-4d90-8f29-6bec57ed817b"
}
Modified at 2023-04-28 06:52:26
Previous
File object
Next
Rich text object
Built with