Skip to content

Commit 9b508bd

Browse files
waleedlatif1waleedlatif1
committed
docs(integrations): regenerate docs + catalog for telegram, outlook, notion tools
1 parent af1aac9 commit 9b508bd

4 files changed

Lines changed: 872 additions & 19 deletions

File tree

‎apps/docs/content/docs/en/integrations/notion.mdx‎

Lines changed: 283 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -273,6 +273,289 @@ Create a new database in Notion with custom properties
273273
| `last_edited_time` | string | ISO 8601 last edit timestamp |
274274
| `title` | string | Row title |
275275

276+
### `notion_append_blocks`
277+
278+
Append new block children (content) to a Notion page or block
279+
280+
#### Input
281+
282+
| Parameter | Type | Required | Description |
283+
| --------- | ---- | -------- | ----------- |
284+
| `blockId` | string | Yes | The UUID of the page or block to append children to |
285+
| `children` | json | Yes | Array of Notion block objects to append \(max 100\) |
286+
| `after` | string | No | UUID of an existing block to append the new children after |
287+
288+
#### Output
289+
290+
| Parameter | Type | Description |
291+
| --------- | ---- | ----------- |
292+
| `content` | string | Page content in markdown format, or comment text for create comment |
293+
| `title` | string | Page or database title |
294+
| `url` | string | Notion URL |
295+
| `id` | string | Page, database, block, comment, or user ID |
296+
| `created_time` | string | Creation timestamp |
297+
| `last_edited_time` | string | Last edit timestamp |
298+
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
299+
| `has_more` | boolean | Whether more results are available |
300+
| `next_cursor` | string | Cursor for pagination |
301+
| `total_results` | number | Number of results returned |
302+
| `properties` | json | Database properties schema |
303+
| `appended` | boolean | Whether content was successfully appended |
304+
| `type` | string | Block type |
305+
| `block` | json | The full updated Notion block object |
306+
| `archived` | boolean | Whether the block was archived |
307+
| `discussion_id` | string | Discussion thread ID |
308+
| `name` | string | User display name |
309+
| `avatar_url` | string | User avatar image URL |
310+
| `email` | string | User email address \(person users only\) |
311+
312+
### `notion_retrieve_block_children`
313+
314+
Retrieve the block children (content) of a Notion page or block
315+
316+
#### Input
317+
318+
| Parameter | Type | Required | Description |
319+
| --------- | ---- | -------- | ----------- |
320+
| `blockId` | string | Yes | The UUID of the page or block whose children to retrieve |
321+
| `startCursor` | string | No | Pagination cursor returned by a previous request |
322+
| `pageSize` | number | No | Number of results to return \(1-100, default 100\) |
323+
324+
#### Output
325+
326+
| Parameter | Type | Description |
327+
| --------- | ---- | ----------- |
328+
| `content` | string | Page content in markdown format, or comment text for create comment |
329+
| `title` | string | Page or database title |
330+
| `url` | string | Notion URL |
331+
| `id` | string | Page, database, block, comment, or user ID |
332+
| `created_time` | string | Creation timestamp |
333+
| `last_edited_time` | string | Last edit timestamp |
334+
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
335+
| `has_more` | boolean | Whether more results are available |
336+
| `next_cursor` | string | Cursor for pagination |
337+
| `total_results` | number | Number of results returned |
338+
| `properties` | json | Database properties schema |
339+
| `appended` | boolean | Whether content was successfully appended |
340+
| `type` | string | Block type |
341+
| `block` | json | The full updated Notion block object |
342+
| `archived` | boolean | Whether the block was archived |
343+
| `discussion_id` | string | Discussion thread ID |
344+
| `name` | string | User display name |
345+
| `avatar_url` | string | User avatar image URL |
346+
| `email` | string | User email address \(person users only\) |
347+
348+
### `notion_update_block`
349+
350+
Update the content or archived state of a single Notion block
351+
352+
#### Input
353+
354+
| Parameter | Type | Required | Description |
355+
| --------- | ---- | -------- | ----------- |
356+
| `blockId` | string | Yes | The UUID of the block to update |
357+
| `block` | json | Yes | Block-type object with the fields to update, e.g. \{"paragraph": \{"rich_text": \[...\]\}\} |
358+
| `archived` | boolean | No | Set to true to archive \(delete\) the block, or false to restore it |
359+
360+
#### Output
361+
362+
| Parameter | Type | Description |
363+
| --------- | ---- | ----------- |
364+
| `content` | string | Page content in markdown format, or comment text for create comment |
365+
| `title` | string | Page or database title |
366+
| `url` | string | Notion URL |
367+
| `id` | string | Page, database, block, comment, or user ID |
368+
| `created_time` | string | Creation timestamp |
369+
| `last_edited_time` | string | Last edit timestamp |
370+
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
371+
| `has_more` | boolean | Whether more results are available |
372+
| `next_cursor` | string | Cursor for pagination |
373+
| `total_results` | number | Number of results returned |
374+
| `properties` | json | Database properties schema |
375+
| `appended` | boolean | Whether content was successfully appended |
376+
| `type` | string | Block type |
377+
| `block` | json | The full updated Notion block object |
378+
| `archived` | boolean | Whether the block was archived |
379+
| `discussion_id` | string | Discussion thread ID |
380+
| `name` | string | User display name |
381+
| `avatar_url` | string | User avatar image URL |
382+
| `email` | string | User email address \(person users only\) |
383+
384+
### `notion_delete_block`
385+
386+
Delete (move to trash) a single Notion block
387+
388+
#### Input
389+
390+
| Parameter | Type | Required | Description |
391+
| --------- | ---- | -------- | ----------- |
392+
| `blockId` | string | Yes | The UUID of the block to delete |
393+
394+
#### Output
395+
396+
| Parameter | Type | Description |
397+
| --------- | ---- | ----------- |
398+
| `content` | string | Page content in markdown format, or comment text for create comment |
399+
| `title` | string | Page or database title |
400+
| `url` | string | Notion URL |
401+
| `id` | string | Page, database, block, comment, or user ID |
402+
| `created_time` | string | Creation timestamp |
403+
| `last_edited_time` | string | Last edit timestamp |
404+
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
405+
| `has_more` | boolean | Whether more results are available |
406+
| `next_cursor` | string | Cursor for pagination |
407+
| `total_results` | number | Number of results returned |
408+
| `properties` | json | Database properties schema |
409+
| `appended` | boolean | Whether content was successfully appended |
410+
| `type` | string | Block type |
411+
| `block` | json | The full updated Notion block object |
412+
| `archived` | boolean | Whether the block was archived |
413+
| `discussion_id` | string | Discussion thread ID |
414+
| `name` | string | User display name |
415+
| `avatar_url` | string | User avatar image URL |
416+
| `email` | string | User email address \(person users only\) |
417+
418+
### `notion_create_comment`
419+
420+
Create a comment on a Notion page or within an existing discussion thread
421+
422+
#### Input
423+
424+
| Parameter | Type | Required | Description |
425+
| --------- | ---- | -------- | ----------- |
426+
| `pageId` | string | No | UUID of the page to comment on \(provide either pageId or discussionId\) |
427+
| `discussionId` | string | No | UUID of an existing discussion thread to reply to |
428+
| `content` | string | Yes | The text content of the comment |
429+
430+
#### Output
431+
432+
| Parameter | Type | Description |
433+
| --------- | ---- | ----------- |
434+
| `content` | string | Page content in markdown format, or comment text for create comment |
435+
| `title` | string | Page or database title |
436+
| `url` | string | Notion URL |
437+
| `id` | string | Page, database, block, comment, or user ID |
438+
| `created_time` | string | Creation timestamp |
439+
| `last_edited_time` | string | Last edit timestamp |
440+
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
441+
| `has_more` | boolean | Whether more results are available |
442+
| `next_cursor` | string | Cursor for pagination |
443+
| `total_results` | number | Number of results returned |
444+
| `properties` | json | Database properties schema |
445+
| `appended` | boolean | Whether content was successfully appended |
446+
| `type` | string | Block type |
447+
| `block` | json | The full updated Notion block object |
448+
| `archived` | boolean | Whether the block was archived |
449+
| `discussion_id` | string | Discussion thread ID |
450+
| `name` | string | User display name |
451+
| `avatar_url` | string | User avatar image URL |
452+
| `email` | string | User email address \(person users only\) |
453+
454+
### `notion_list_comments`
455+
456+
List unresolved comments on a Notion page or block
457+
458+
#### Input
459+
460+
| Parameter | Type | Required | Description |
461+
| --------- | ---- | -------- | ----------- |
462+
| `blockId` | string | Yes | The UUID of the page or block whose comments to list |
463+
| `startCursor` | string | No | Pagination cursor returned by a previous request |
464+
| `pageSize` | number | No | Number of results to return \(1-100, default 100\) |
465+
466+
#### Output
467+
468+
| Parameter | Type | Description |
469+
| --------- | ---- | ----------- |
470+
| `content` | string | Page content in markdown format, or comment text for create comment |
471+
| `title` | string | Page or database title |
472+
| `url` | string | Notion URL |
473+
| `id` | string | Page, database, block, comment, or user ID |
474+
| `created_time` | string | Creation timestamp |
475+
| `last_edited_time` | string | Last edit timestamp |
476+
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
477+
| `has_more` | boolean | Whether more results are available |
478+
| `next_cursor` | string | Cursor for pagination |
479+
| `total_results` | number | Number of results returned |
480+
| `properties` | json | Database properties schema |
481+
| `appended` | boolean | Whether content was successfully appended |
482+
| `type` | string | Block type |
483+
| `block` | json | The full updated Notion block object |
484+
| `archived` | boolean | Whether the block was archived |
485+
| `discussion_id` | string | Discussion thread ID |
486+
| `name` | string | User display name |
487+
| `avatar_url` | string | User avatar image URL |
488+
| `email` | string | User email address \(person users only\) |
489+
490+
### `notion_list_users`
491+
492+
List all users (members and bots) in the Notion workspace
493+
494+
#### Input
495+
496+
| Parameter | Type | Required | Description |
497+
| --------- | ---- | -------- | ----------- |
498+
| `startCursor` | string | No | Pagination cursor returned by a previous request |
499+
| `pageSize` | number | No | Number of results to return \(1-100, default 100\) |
500+
501+
#### Output
502+
503+
| Parameter | Type | Description |
504+
| --------- | ---- | ----------- |
505+
| `content` | string | Page content in markdown format, or comment text for create comment |
506+
| `title` | string | Page or database title |
507+
| `url` | string | Notion URL |
508+
| `id` | string | Page, database, block, comment, or user ID |
509+
| `created_time` | string | Creation timestamp |
510+
| `last_edited_time` | string | Last edit timestamp |
511+
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
512+
| `has_more` | boolean | Whether more results are available |
513+
| `next_cursor` | string | Cursor for pagination |
514+
| `total_results` | number | Number of results returned |
515+
| `properties` | json | Database properties schema |
516+
| `appended` | boolean | Whether content was successfully appended |
517+
| `type` | string | Block type |
518+
| `block` | json | The full updated Notion block object |
519+
| `archived` | boolean | Whether the block was archived |
520+
| `discussion_id` | string | Discussion thread ID |
521+
| `name` | string | User display name |
522+
| `avatar_url` | string | User avatar image URL |
523+
| `email` | string | User email address \(person users only\) |
524+
525+
### `notion_retrieve_user`
526+
527+
Retrieve a single Notion user by their UUID
528+
529+
#### Input
530+
531+
| Parameter | Type | Required | Description |
532+
| --------- | ---- | -------- | ----------- |
533+
| `userId` | string | Yes | The UUID of the user to retrieve |
534+
535+
#### Output
536+
537+
| Parameter | Type | Description |
538+
| --------- | ---- | ----------- |
539+
| `content` | string | Page content in markdown format, or comment text for create comment |
540+
| `title` | string | Page or database title |
541+
| `url` | string | Notion URL |
542+
| `id` | string | Page, database, block, comment, or user ID |
543+
| `created_time` | string | Creation timestamp |
544+
| `last_edited_time` | string | Last edit timestamp |
545+
| `results` | array | Array of results \(pages, blocks, comments, or users\) |
546+
| `has_more` | boolean | Whether more results are available |
547+
| `next_cursor` | string | Cursor for pagination |
548+
| `total_results` | number | Number of results returned |
549+
| `properties` | json | Database properties schema |
550+
| `appended` | boolean | Whether content was successfully appended |
551+
| `type` | string | Block type |
552+
| `block` | json | The full updated Notion block object |
553+
| `archived` | boolean | Whether the block was archived |
554+
| `discussion_id` | string | Discussion thread ID |
555+
| `name` | string | User display name |
556+
| `avatar_url` | string | User avatar image URL |
557+
| `email` | string | User email address \(person users only\) |
558+
276559

277560

278561
## Triggers

0 commit comments

Comments
 (0)