opensource/sim
3
0
Fork 0
mirror of https://github.com/simstudioai/sim.git synced 2026-09-24 15:45:35 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix(notion): align integration with live API docs, add block retrieval coverage (#5491)

Browse Source 
* fix(notion): align integration with live API docs, add block retrieval coverage

- wire up notion_update_page in the block (was registered but unreachable — no dropdown option or subBlocks)
- fix legacy NotionBlock outputs to cover all 17 operations, not just content/metadata
- trim ID params (pageId, databaseId, parentId) before use in request URLs across 8 tool files
- remove content required:true on create_page (Notion allows title-only pages)
- remove dead unused NotionReadDatabaseParams interface
- add notion_retrieve_block/_v2 tool for GET /v1/blocks/{id}, filling a gap in block CRUD coverage

* fix(notion): second validation pass — pagination gaps, phantom outputs, dead types, regen docs

- add missing startCursor/start_cursor pagination param to notion_query_database and notion_search
- fix notion_search missing from the shared pageSize/startCursor field's operation condition in NotionBlock
- fix NotionV2Block title/url/created_time/last_edited_time outputs rendering unconditionally for every operation instead of only the ones that return them
- remove 153 lines of dead unused output-shape constants from types.ts
- regenerate integration docs

* fix(notion): expose retrieve-block outputs in legacy block picker

type/block/archived only conditioned on notion_update_block/notion_delete_block,
and has_children was missing entirely — Retrieve Block's payload was invisible
in the legacy NotionBlock output picker (Greptile P1 on PR #5491).

* fix(notion): document type-specific content gap on retrieve_block output

block.properties (BLOCK_OUTPUT_PROPERTIES) only covers common block fields,
not the type-specific sub-object (paragraph.rich_text, image.file, etc.) —
that varies per block type and isn't enumerable. Documented in the
description per Greptile P2 on PR #5491; no functional change, block: data
already carries the full object at runtime.
This commit is contained in:
Waleed
2026-07-07 13:57:33 -07:00
committed by GitHub
parent ed1492bcbd
commit 61ceedc5b9
15 changed files with 458 additions and 197 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/docs/content/docs/en/integrations/notion.mdx
+61 -16
View File
@@ -145,6 +145,7 @@ Query and filter Notion database entries with advanced filtering
| `filter` | string | No | Filter conditions as JSON \(optional\) |
| `sorts` | string | No | Sort criteria as JSON array \(optional\) |
| `pageSize` | number | No | Number of results to return \(default: 100, max: 100\) |
| `startCursor` | string | No | Pagination cursor returned by a previous request |
#### Output
@@ -200,6 +201,7 @@ Search across all pages and databases in Notion workspace
| `query` | string | No | Search terms to find pages and databases \(leave empty to get all pages\) |
| `filterType` | string | No | Filter by object type: "page", "database", or leave empty for all |
| `pageSize` | number | No | Number of results to return \(default: 100, max: 100\) |
| `startCursor` | string | No | Pagination cursor returned by a previous request |
#### Output
@@ -302,8 +304,44 @@ Append new block children (content) to a Notion page or block
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `block` | json | The full Notion block object |
| `has_children` | boolean | Whether the block has nested blocks |
| `archived` | boolean | Whether the block is archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
| `email` | string | User email address \(person users only\) |
### `notion_retrieve_block`
Retrieve a single Notion block by its UUID, including its type-specific content
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `blockId` | string | Yes | The UUID of the block to retrieve |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Page content in markdown format, or comment text for create comment |
| `title` | string | Page or database title |
| `url` | string | Notion URL |
| `id` | string | Page, database, block, comment, or user ID |
| `created_time` | string | Creation timestamp |
| `last_edited_time` | string | Last edit timestamp |
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
| `has_more` | boolean | Whether more results are available |
| `next_cursor` | string | Cursor for pagination |
| `total_results` | number | Number of results returned |
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full Notion block object |
| `has_children` | boolean | Whether the block has nested blocks |
| `archived` | boolean | Whether the block is archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
@@ -338,8 +376,9 @@ Retrieve the block children (content) of a Notion page or block
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `block` | json | The full Notion block object |
| `has_children` | boolean | Whether the block has nested blocks |
| `archived` | boolean | Whether the block is archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
@@ -374,8 +413,9 @@ Update the content or archived state of a single Notion block
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `block` | json | The full Notion block object |
| `has_children` | boolean | Whether the block has nested blocks |
| `archived` | boolean | Whether the block is archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
@@ -408,8 +448,9 @@ Delete (move to trash) a single Notion block
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `block` | json | The full Notion block object |
| `has_children` | boolean | Whether the block has nested blocks |
| `archived` | boolean | Whether the block is archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
@@ -444,8 +485,9 @@ Create a comment on a Notion page or within an existing discussion thread
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `block` | json | The full Notion block object |
| `has_children` | boolean | Whether the block has nested blocks |
| `archived` | boolean | Whether the block is archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
@@ -480,8 +522,9 @@ List unresolved comments on a Notion page or block
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `block` | json | The full Notion block object |
| `has_children` | boolean | Whether the block has nested blocks |
| `archived` | boolean | Whether the block is archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
@@ -515,8 +558,9 @@ List all users (members and bots) in the Notion workspace
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `block` | json | The full Notion block object |
| `has_children` | boolean | Whether the block has nested blocks |
| `archived` | boolean | Whether the block is archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |
@@ -549,8 +593,9 @@ Retrieve a single Notion user by their UUID
| `properties` | json | Database properties schema |
| `appended` | boolean | Whether content was successfully appended |
| `type` | string | Block type |
| `block` | json | The full updated Notion block object |
| `archived` | boolean | Whether the block was archived |
| `block` | json | The full Notion block object |
| `has_children` | boolean | Whether the block has nested blocks |
| `archived` | boolean | Whether the block is archived |
| `discussion_id` | string | Discussion thread ID |
| `name` | string | User display name |
| `avatar_url` | string | User avatar image URL |