Overview
Add Notion to any ModuleX agent or workflow. Notion v1 REST API integration. Pure HTTP (no SDK dep). 19 actions across pages, databases, blocks, users, comments, and search.Categories: Productivity & Collaboration · Productivity · Knowledge Management · Documentation · Auth: OAuth2 (Recommended), Internal Integration · Actions: 19
Authentication
- OAuth2 (Recommended)
- Internal Integration
OAuth2 (Recommended)
Connect using Notion OAuth — most secure optionRequired Credentials
| Field | Description | Required | Format |
|---|---|---|---|
| Client ID | Notion OAuth integration Client ID | Yes | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| Client Secret | Notion OAuth integration Client Secret | Yes | - |
OAuth Configuration
- Authorization URL:
https://api.notion.com/v1/oauth/authorize - Token URL:
https://api.notion.com/v1/oauth/token
Available Actions
search — Search across Notion pages and databases
search — Search across Notion pages and databases
Parameters
string
Search query text
object
Filter (e.g. {‘property’: ‘object’, ‘value’: ‘page’})
object
Sort options
string
Pagination cursor
integer
Number of results (max 100) (Default:
100)Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"total": {
"default": 0,
"title": "Total",
"type": "integer"
},
"has_more": {
"default": false,
"title": "Has More",
"type": "boolean"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Cursor"
},
"results": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Results",
"type": "array"
}
},
"required": [
"success"
],
"title": "SearchOutput",
"type": "object"
}
create_page — Create a new page in a database or under a parent page
create_page — Create a new page in a database or under a parent page
Parameters
string
required
‘database’ or ‘page’
string
required
Parent page/database ID
string
Page title
string
Markdown content (converted to paragraph blocks)
array
Direct Notion block array (overrides content)
object
Database properties (required for database parents)
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"created_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created Time"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"properties": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Properties"
},
"parent": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent"
}
},
"required": [
"success"
],
"title": "CreatePageOutput",
"type": "object"
}
get_page — Retrieve a Notion page (optionally with child blocks)
get_page — Retrieve a Notion page (optionally with child blocks)
Parameters
string
required
Page ID to retrieve
boolean
Include page child blocks (N+1 fetch) (Default:
true)Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"created_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created Time"
},
"last_edited_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Edited Time"
},
"created_by": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Created By"
},
"last_edited_by": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Edited By"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"properties": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Properties"
},
"parent": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent"
},
"archived": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Archived"
},
"content": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
}
},
"required": [
"success"
],
"title": "GetPageOutput",
"type": "object"
}
update_page — Update page properties / archive status
update_page — Update page properties / archive status
Parameters
string
required
Page ID
string
New title
object
Updated properties
boolean
Archive (true) / unarchive (false)
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"last_edited_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Edited Time"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"properties": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Properties"
},
"archived": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Archived"
}
},
"required": [
"success"
],
"title": "UpdatePageOutput",
"type": "object"
}
query_database — Query a database with filters and sorts
query_database — Query a database with filters and sorts
Parameters
string
required
Database ID
object
Filter conditions
array
Sort options
string
Pagination cursor
integer
Number of results (max 100) (Default:
100)Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"total": {
"default": 0,
"title": "Total",
"type": "integer"
},
"has_more": {
"default": false,
"title": "Has More",
"type": "boolean"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Cursor"
},
"database_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Database Id"
},
"results": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Results",
"type": "array"
}
},
"required": [
"success"
],
"title": "QueryDatabaseOutput",
"type": "object"
}
get_database — Retrieve database metadata + property schema
get_database — Retrieve database metadata + property schema
Parameters
string
required
Database ID
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"created_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created Time"
},
"last_edited_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Edited Time"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"properties": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Properties"
},
"parent": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent"
},
"archived": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Archived"
},
"is_inline": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Inline"
}
},
"required": [
"success"
],
"title": "GetDatabaseOutput",
"type": "object"
}
create_database — Create a new database under a parent page
create_database — Create a new database under a parent page
Parameters
string
required
Parent page ID
string
required
Database title
object
required
Property schema definitions
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"created_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created Time"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"properties": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Properties"
},
"parent": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent"
}
},
"required": [
"success"
],
"title": "CreateDatabaseOutput",
"type": "object"
}
update_database — Update database title / description / schema
update_database — Update database title / description / schema
Parameters
string
required
Database ID
string
New title
string
New description
object
Updated property schema
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"last_edited_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Edited Time"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"properties": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Properties"
}
},
"required": [
"success"
],
"title": "UpdateDatabaseOutput",
"type": "object"
}
create_database_item — Create a new page inside a database
create_database_item — Create a new page inside a database
Parameters
string
required
Database ID
object
required
Item properties matching database schema
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"created_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created Time"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"properties": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Properties"
}
},
"required": [
"success"
],
"title": "CreateDatabaseItemOutput",
"type": "object"
}
get_block — Retrieve a single block by ID
get_block — Retrieve a single block by ID
Parameters
string
required
Block ID
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Type"
},
"created_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created Time"
},
"last_edited_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Edited Time"
},
"has_children": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Has Children"
},
"archived": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Archived"
},
"parent": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent"
},
"content": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
}
},
"required": [
"success"
],
"title": "GetBlockOutput",
"type": "object"
}
get_block_children — Retrieve a block's / page's child blocks
get_block_children — Retrieve a block's / page's child blocks
Parameters
string
required
Parent block or page ID
string
Pagination cursor
integer
Number of results (max 100) (Default:
100)Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"total": {
"default": 0,
"title": "Total",
"type": "integer"
},
"has_more": {
"default": false,
"title": "Has More",
"type": "boolean"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Cursor"
},
"block_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Block Id"
},
"children": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Children",
"type": "array"
}
},
"required": [
"success"
],
"title": "GetBlockChildrenOutput",
"type": "object"
}
append_blocks — Append blocks to a page or block
append_blocks — Append blocks to a page or block
Parameters
string
required
Block / page ID to append into
array
required
Notion block objects to append
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"block_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Block Id"
},
"appended_blocks": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Appended Blocks",
"type": "array"
},
"total_appended": {
"default": 0,
"title": "Total Appended",
"type": "integer"
}
},
"required": [
"success"
],
"title": "AppendBlocksOutput",
"type": "object"
}
update_block — Update an existing block
update_block — Update an existing block
Parameters
string
required
Block ID
object
required
Block object with updated content
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Type"
},
"last_edited_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Edited Time"
},
"has_children": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Has Children"
},
"content": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
}
},
"required": [
"success"
],
"title": "UpdateBlockOutput",
"type": "object"
}
delete_block — Archive (delete) a block
delete_block — Archive (delete) a block
Parameters
string
required
Block ID
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Type"
},
"archived": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Archived"
}
},
"required": [
"success"
],
"title": "DeleteBlockOutput",
"type": "object"
}
list_users — List all workspace users (people + bots)
list_users — List all workspace users (people + bots)
Parameters
string
Pagination cursor
integer
Number of results (max 100) (Default:
100)Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"total": {
"default": 0,
"title": "Total",
"type": "integer"
},
"has_more": {
"default": false,
"title": "Has More",
"type": "boolean"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Cursor"
},
"users": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Users",
"type": "array"
}
},
"required": [
"success"
],
"title": "ListUsersOutput",
"type": "object"
}
get_user — Retrieve a specific user by ID
get_user — Retrieve a specific user by ID
Parameters
string
required
User ID
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"object": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Object"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Type"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"person": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Person"
},
"bot": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Bot"
}
},
"required": [
"success"
],
"title": "GetUserOutput",
"type": "object"
}
get_bot_user — Retrieve the integration's bot user (GET /users/me)
get_bot_user — Retrieve the integration's bot user (GET /users/me)
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"object": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Object"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Type"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"bot": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Bot"
}
},
"required": [
"success"
],
"title": "GetBotUserOutput",
"type": "object"
}
create_comment — Create a comment on a page or discussion
create_comment — Create a comment on a page or discussion
Parameters
array
required
Rich text array for the comment body
string
Page ID (use this for new comments)
string
Discussion ID (use this for replies)
Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"created_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created Time"
},
"discussion_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Discussion Id"
},
"parent": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Parent"
},
"rich_text": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Rich Text"
},
"created_by": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Created By"
}
},
"required": [
"success"
],
"title": "CreateCommentOutput",
"type": "object"
}
get_comments — Retrieve comments on a block / page
get_comments — Retrieve comments on a block / page
Parameters
string
required
Block / page ID
string
Pagination cursor
integer
Number of results (max 100) (Default:
100)Response
{
"additionalProperties": false,
"properties": {
"success": {
"title": "Success",
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"total": {
"default": 0,
"title": "Total",
"type": "integer"
},
"has_more": {
"default": false,
"title": "Has More",
"type": "boolean"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Cursor"
},
"block_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Block Id"
},
"comments": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Comments",
"type": "array"
}
},
"required": [
"success"
],
"title": "GetCommentsOutput",
"type": "object"
}
Limits & Quotas
- 30s timeout on every request.
page_sizeclamped to 100 (Notion’s max).- All actions wrap in try/except →
success=Falseenvelope (exa-style). - Trivial markdown→blocks conversion in
create_page.content: splits on newlines and creates one paragraph block per non-empty line. Usechildrenfor anything fancier.