Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
json 1,563 lines 67.8 KB
Raw
1 {
2 "slug": "NOTION_APPEND_TEXT_BLOCKS",
3 "name": "Append text blocks (paragraphs, headings, lists)",
4 "description": "Append text blocks (paragraphs, headings, lists) to a Notion page. This is the most commonly used action for adding content to Notion. Use for: documentation, notes, articles, outlines, lists. Supported block types: - paragraph: Regular text - heading_1, heading_2, heading_3: Section headers - bulleted_list_item: Bullet points - numbered_list_item: Numbered lists ⚠️ Text content is limited to 2000 characters per text.content field. For other block types, use specialized actions: - append_task_blocks: to-do, toggle, callout - append_code_blocks: code, quote, equation - append_media_blocks: image, video, audio, files - append_layout_blocks: divider, columns, TOC - append_table_blocks: tables",
5 "available_versions": ["20260113_00"],
6 "version": "20260113_00",
7 "toolkit": {
8 "slug": "notion",
9 "name": "notion",
10 "logo": "https://logos.composio.dev/api/notion"
11 },
12 "input_parameters": {
13 "description": "Request model for appending text blocks to a Notion page.",
14 "properties": {
15 "after": {
16 "anyOf": [
17 {
18 "type": "string"
19 },
20 {
21 "type": "null"
22 }
23 ],
24 "default": null,
25 "description": "Optional UUID of an existing child block. New blocks will be inserted after this block.",
26 "examples": ["9bc30ad4-9373-46a5-84ab-0a7845ee52e6"],
27 "title": "After"
28 },
29 "block_id": {
30 "description": "The UUID of the parent block or page to append children to.",
31 "examples": ["b55c9c91-384d-452b-81db-d1ef79372b75", "b55c9c91384d452b81dbd1ef79372b75"],
32 "title": "Block Id",
33 "type": "string"
34 },
35 "children": {
36 "description": "Array of text block objects to append (also accepts 'blocks' as parameter name). Supported types:\n- paragraph: Regular text paragraph\n- heading_1, heading_2, heading_3: Section headings\n- bulleted_list_item: Bullet point\n- numbered_list_item: Numbered list item\n\n⚠️ Text content limited to 2000 characters per rich_text text.content field.\nMax 100 blocks per request.",
37 "examples": [
38 [
39 {
40 "heading_2": {
41 "rich_text": [
42 {
43 "text": {
44 "content": "Section Title"
45 },
46 "type": "text"
47 }
48 ]
49 },
50 "object": "block",
51 "type": "heading_2"
52 }
53 ],
54 [
55 {
56 "object": "block",
57 "paragraph": {
58 "rich_text": [
59 {
60 "text": {
61 "content": "This is a paragraph."
62 },
63 "type": "text"
64 }
65 ]
66 },
67 "type": "paragraph"
68 }
69 ]
70 ],
71 "items": {
72 "discriminator": {
73 "mapping": {
74 "bulleted_list_item": "#/$defs/BulletedListItemBlockInput",
75 "heading_1": "#/$defs/Heading1BlockInput",
76 "heading_2": "#/$defs/Heading2BlockInput",
77 "heading_3": "#/$defs/Heading3BlockInput",
78 "numbered_list_item": "#/$defs/NumberedListItemBlockInput",
79 "paragraph": "#/$defs/ParagraphBlockInput"
80 },
81 "propertyName": "type"
82 },
83 "oneOf": [
84 {
85 "description": "A paragraph block object.",
86 "properties": {
87 "object": {
88 "const": "block",
89 "default": "block",
90 "description": "Always 'block'.",
91 "title": "Object",
92 "type": "string"
93 },
94 "paragraph": {
95 "description": "Paragraph content.",
96 "properties": {
97 "color": {
98 "default": "default",
99 "description": "Color of the paragraph text or background.",
100 "enum": [
101 "default",
102 "gray",
103 "brown",
104 "orange",
105 "yellow",
106 "green",
107 "blue",
108 "purple",
109 "pink",
110 "red",
111 "gray_background",
112 "brown_background",
113 "orange_background",
114 "yellow_background",
115 "green_background",
116 "blue_background",
117 "purple_background",
118 "pink_background",
119 "red_background"
120 ],
121 "title": "BlockColor",
122 "type": "string"
123 },
124 "rich_text": {
125 "description": "Array of rich text objects. Each text.content is limited to 2000 chars.",
126 "items": {
127 "description": "Rich text object for creating text content in blocks.",
128 "properties": {
129 "annotations": {
130 "anyOf": [
131 {
132 "description": "Text styling annotations for rich text.",
133 "properties": {
134 "bold": {
135 "default": false,
136 "description": "Whether the text is bold.",
137 "title": "Bold",
138 "type": "boolean"
139 },
140 "code": {
141 "default": false,
142 "description": "Whether the text is formatted as inline code.",
143 "title": "Code",
144 "type": "boolean"
145 },
146 "color": {
147 "default": "default",
148 "description": "Color of the text or background.",
149 "enum": [
150 "default",
151 "gray",
152 "brown",
153 "orange",
154 "yellow",
155 "green",
156 "blue",
157 "purple",
158 "pink",
159 "red",
160 "gray_background",
161 "brown_background",
162 "orange_background",
163 "yellow_background",
164 "green_background",
165 "blue_background",
166 "purple_background",
167 "pink_background",
168 "red_background"
169 ],
170 "title": "BlockColor",
171 "type": "string"
172 },
173 "italic": {
174 "default": false,
175 "description": "Whether the text is italic.",
176 "title": "Italic",
177 "type": "boolean"
178 },
179 "strikethrough": {
180 "default": false,
181 "description": "Whether the text has strikethrough.",
182 "title": "Strikethrough",
183 "type": "boolean"
184 },
185 "underline": {
186 "default": false,
187 "description": "Whether the text is underlined.",
188 "title": "Underline",
189 "type": "boolean"
190 }
191 },
192 "title": "TextAnnotations",
193 "type": "object"
194 },
195 {
196 "type": "null"
197 }
198 ],
199 "default": null,
200 "description": "Optional text styling annotations (bold, italic, etc.)."
201 },
202 "text": {
203 "description": "The text content object.",
204 "properties": {
205 "content": {
206 "description": "The actual text content. CRITICAL: Maximum 2000 characters per text object.",
207 "examples": ["Hello, World!", "This is a paragraph of text."],
208 "maxLength": 2000,
209 "title": "Content",
210 "type": "string"
211 },
212 "link": {
213 "anyOf": [
214 {
215 "description": "Link object for hyperlinked text.",
216 "properties": {
217 "url": {
218 "description": "The URL the text links to.",
219 "examples": [
220 "https://www.notion.so",
221 "https://example.com"
222 ],
223 "title": "Url",
224 "type": "string"
225 }
226 },
227 "required": ["url"],
228 "title": "TextLink",
229 "type": "object"
230 },
231 {
232 "type": "null"
233 }
234 ],
235 "default": null,
236 "description": "Optional link for the text."
237 }
238 },
239 "required": ["content"],
240 "title": "TextContent",
241 "type": "object"
242 },
243 "type": {
244 "const": "text",
245 "default": "text",
246 "description": "Type of rich text. Currently only 'text' is supported for input.",
247 "title": "Type",
248 "type": "string"
249 }
250 },
251 "required": ["text"],
252 "title": "RichTextInput",
253 "type": "object"
254 },
255 "minItems": 1,
256 "title": "Rich Text",
257 "type": "array"
258 }
259 },
260 "required": ["rich_text"],
261 "title": "ParagraphInput",
262 "type": "object"
263 },
264 "type": {
265 "const": "paragraph",
266 "default": "paragraph",
267 "description": "Block type.",
268 "title": "Type",
269 "type": "string"
270 }
271 },
272 "required": ["paragraph"],
273 "title": "ParagraphBlockInput",
274 "type": "object"
275 },
276 {
277 "description": "A heading 1 block object (largest heading).",
278 "properties": {
279 "heading_1": {
280 "description": "Heading 1 content.",
281 "properties": {
282 "color": {
283 "default": "default",
284 "description": "Color of the heading.",
285 "enum": [
286 "default",
287 "gray",
288 "brown",
289 "orange",
290 "yellow",
291 "green",
292 "blue",
293 "purple",
294 "pink",
295 "red",
296 "gray_background",
297 "brown_background",
298 "orange_background",
299 "yellow_background",
300 "green_background",
301 "blue_background",
302 "purple_background",
303 "pink_background",
304 "red_background"
305 ],
306 "title": "BlockColor",
307 "type": "string"
308 },
309 "is_toggleable": {
310 "default": false,
311 "description": "Whether the heading can be toggled to show/hide content.",
312 "title": "Is Toggleable",
313 "type": "boolean"
314 },
315 "rich_text": {
316 "description": "Array of rich text objects for the heading text.",
317 "items": {
318 "description": "Rich text object for creating text content in blocks.",
319 "properties": {
320 "annotations": {
321 "anyOf": [
322 {
323 "description": "Text styling annotations for rich text.",
324 "properties": {
325 "bold": {
326 "default": false,
327 "description": "Whether the text is bold.",
328 "title": "Bold",
329 "type": "boolean"
330 },
331 "code": {
332 "default": false,
333 "description": "Whether the text is formatted as inline code.",
334 "title": "Code",
335 "type": "boolean"
336 },
337 "color": {
338 "default": "default",
339 "description": "Color of the text or background.",
340 "enum": [
341 "default",
342 "gray",
343 "brown",
344 "orange",
345 "yellow",
346 "green",
347 "blue",
348 "purple",
349 "pink",
350 "red",
351 "gray_background",
352 "brown_background",
353 "orange_background",
354 "yellow_background",
355 "green_background",
356 "blue_background",
357 "purple_background",
358 "pink_background",
359 "red_background"
360 ],
361 "title": "BlockColor",
362 "type": "string"
363 },
364 "italic": {
365 "default": false,
366 "description": "Whether the text is italic.",
367 "title": "Italic",
368 "type": "boolean"
369 },
370 "strikethrough": {
371 "default": false,
372 "description": "Whether the text has strikethrough.",
373 "title": "Strikethrough",
374 "type": "boolean"
375 },
376 "underline": {
377 "default": false,
378 "description": "Whether the text is underlined.",
379 "title": "Underline",
380 "type": "boolean"
381 }
382 },
383 "title": "TextAnnotations",
384 "type": "object"
385 },
386 {
387 "type": "null"
388 }
389 ],
390 "default": null,
391 "description": "Optional text styling annotations (bold, italic, etc.)."
392 },
393 "text": {
394 "description": "The text content object.",
395 "properties": {
396 "content": {
397 "description": "The actual text content. CRITICAL: Maximum 2000 characters per text object.",
398 "examples": ["Hello, World!", "This is a paragraph of text."],
399 "maxLength": 2000,
400 "title": "Content",
401 "type": "string"
402 },
403 "link": {
404 "anyOf": [
405 {
406 "description": "Link object for hyperlinked text.",
407 "properties": {
408 "url": {
409 "description": "The URL the text links to.",
410 "examples": [
411 "https://www.notion.so",
412 "https://example.com"
413 ],
414 "title": "Url",
415 "type": "string"
416 }
417 },
418 "required": ["url"],
419 "title": "TextLink",
420 "type": "object"
421 },
422 {
423 "type": "null"
424 }
425 ],
426 "default": null,
427 "description": "Optional link for the text."
428 }
429 },
430 "required": ["content"],
431 "title": "TextContent",
432 "type": "object"
433 },
434 "type": {
435 "const": "text",
436 "default": "text",
437 "description": "Type of rich text. Currently only 'text' is supported for input.",
438 "title": "Type",
439 "type": "string"
440 }
441 },
442 "required": ["text"],
443 "title": "RichTextInput",
444 "type": "object"
445 },
446 "minItems": 1,
447 "title": "Rich Text",
448 "type": "array"
449 }
450 },
451 "required": ["rich_text"],
452 "title": "HeadingInput",
453 "type": "object"
454 },
455 "object": {
456 "const": "block",
457 "default": "block",
458 "description": "Always 'block'.",
459 "title": "Object",
460 "type": "string"
461 },
462 "type": {
463 "const": "heading_1",
464 "default": "heading_1",
465 "description": "Block type.",
466 "title": "Type",
467 "type": "string"
468 }
469 },
470 "required": ["heading_1"],
471 "title": "Heading1BlockInput",
472 "type": "object"
473 },
474 {
475 "description": "A heading 2 block object (medium heading).",
476 "properties": {
477 "heading_2": {
478 "description": "Heading 2 content.",
479 "properties": {
480 "color": {
481 "default": "default",
482 "description": "Color of the heading.",
483 "enum": [
484 "default",
485 "gray",
486 "brown",
487 "orange",
488 "yellow",
489 "green",
490 "blue",
491 "purple",
492 "pink",
493 "red",
494 "gray_background",
495 "brown_background",
496 "orange_background",
497 "yellow_background",
498 "green_background",
499 "blue_background",
500 "purple_background",
501 "pink_background",
502 "red_background"
503 ],
504 "title": "BlockColor",
505 "type": "string"
506 },
507 "is_toggleable": {
508 "default": false,
509 "description": "Whether the heading can be toggled to show/hide content.",
510 "title": "Is Toggleable",
511 "type": "boolean"
512 },
513 "rich_text": {
514 "description": "Array of rich text objects for the heading text.",
515 "items": {
516 "description": "Rich text object for creating text content in blocks.",
517 "properties": {
518 "annotations": {
519 "anyOf": [
520 {
521 "description": "Text styling annotations for rich text.",
522 "properties": {
523 "bold": {
524 "default": false,
525 "description": "Whether the text is bold.",
526 "title": "Bold",
527 "type": "boolean"
528 },
529 "code": {
530 "default": false,
531 "description": "Whether the text is formatted as inline code.",
532 "title": "Code",
533 "type": "boolean"
534 },
535 "color": {
536 "default": "default",
537 "description": "Color of the text or background.",
538 "enum": [
539 "default",
540 "gray",
541 "brown",
542 "orange",
543 "yellow",
544 "green",
545 "blue",
546 "purple",
547 "pink",
548 "red",
549 "gray_background",
550 "brown_background",
551 "orange_background",
552 "yellow_background",
553 "green_background",
554 "blue_background",
555 "purple_background",
556 "pink_background",
557 "red_background"
558 ],
559 "title": "BlockColor",
560 "type": "string"
561 },
562 "italic": {
563 "default": false,
564 "description": "Whether the text is italic.",
565 "title": "Italic",
566 "type": "boolean"
567 },
568 "strikethrough": {
569 "default": false,
570 "description": "Whether the text has strikethrough.",
571 "title": "Strikethrough",
572 "type": "boolean"
573 },
574 "underline": {
575 "default": false,
576 "description": "Whether the text is underlined.",
577 "title": "Underline",
578 "type": "boolean"
579 }
580 },
581 "title": "TextAnnotations",
582 "type": "object"
583 },
584 {
585 "type": "null"
586 }
587 ],
588 "default": null,
589 "description": "Optional text styling annotations (bold, italic, etc.)."
590 },
591 "text": {
592 "description": "The text content object.",
593 "properties": {
594 "content": {
595 "description": "The actual text content. CRITICAL: Maximum 2000 characters per text object.",
596 "examples": ["Hello, World!", "This is a paragraph of text."],
597 "maxLength": 2000,
598 "title": "Content",
599 "type": "string"
600 },
601 "link": {
602 "anyOf": [
603 {
604 "description": "Link object for hyperlinked text.",
605 "properties": {
606 "url": {
607 "description": "The URL the text links to.",
608 "examples": [
609 "https://www.notion.so",
610 "https://example.com"
611 ],
612 "title": "Url",
613 "type": "string"
614 }
615 },
616 "required": ["url"],
617 "title": "TextLink",
618 "type": "object"
619 },
620 {
621 "type": "null"
622 }
623 ],
624 "default": null,
625 "description": "Optional link for the text."
626 }
627 },
628 "required": ["content"],
629 "title": "TextContent",
630 "type": "object"
631 },
632 "type": {
633 "const": "text",
634 "default": "text",
635 "description": "Type of rich text. Currently only 'text' is supported for input.",
636 "title": "Type",
637 "type": "string"
638 }
639 },
640 "required": ["text"],
641 "title": "RichTextInput",
642 "type": "object"
643 },
644 "minItems": 1,
645 "title": "Rich Text",
646 "type": "array"
647 }
648 },
649 "required": ["rich_text"],
650 "title": "HeadingInput",
651 "type": "object"
652 },
653 "object": {
654 "const": "block",
655 "default": "block",
656 "description": "Always 'block'.",
657 "title": "Object",
658 "type": "string"
659 },
660 "type": {
661 "const": "heading_2",
662 "default": "heading_2",
663 "description": "Block type.",
664 "title": "Type",
665 "type": "string"
666 }
667 },
668 "required": ["heading_2"],
669 "title": "Heading2BlockInput",
670 "type": "object"
671 },
672 {
673 "description": "A heading 3 block object (smallest heading).",
674 "properties": {
675 "heading_3": {
676 "description": "Heading 3 content.",
677 "properties": {
678 "color": {
679 "default": "default",
680 "description": "Color of the heading.",
681 "enum": [
682 "default",
683 "gray",
684 "brown",
685 "orange",
686 "yellow",
687 "green",
688 "blue",
689 "purple",
690 "pink",
691 "red",
692 "gray_background",
693 "brown_background",
694 "orange_background",
695 "yellow_background",
696 "green_background",
697 "blue_background",
698 "purple_background",
699 "pink_background",
700 "red_background"
701 ],
702 "title": "BlockColor",
703 "type": "string"
704 },
705 "is_toggleable": {
706 "default": false,
707 "description": "Whether the heading can be toggled to show/hide content.",
708 "title": "Is Toggleable",
709 "type": "boolean"
710 },
711 "rich_text": {
712 "description": "Array of rich text objects for the heading text.",
713 "items": {
714 "description": "Rich text object for creating text content in blocks.",
715 "properties": {
716 "annotations": {
717 "anyOf": [
718 {
719 "description": "Text styling annotations for rich text.",
720 "properties": {
721 "bold": {
722 "default": false,
723 "description": "Whether the text is bold.",
724 "title": "Bold",
725 "type": "boolean"
726 },
727 "code": {
728 "default": false,
729 "description": "Whether the text is formatted as inline code.",
730 "title": "Code",
731 "type": "boolean"
732 },
733 "color": {
734 "default": "default",
735 "description": "Color of the text or background.",
736 "enum": [
737 "default",
738 "gray",
739 "brown",
740 "orange",
741 "yellow",
742 "green",
743 "blue",
744 "purple",
745 "pink",
746 "red",
747 "gray_background",
748 "brown_background",
749 "orange_background",
750 "yellow_background",
751 "green_background",
752 "blue_background",
753 "purple_background",
754 "pink_background",
755 "red_background"
756 ],
757 "title": "BlockColor",
758 "type": "string"
759 },
760 "italic": {
761 "default": false,
762 "description": "Whether the text is italic.",
763 "title": "Italic",
764 "type": "boolean"
765 },
766 "strikethrough": {
767 "default": false,
768 "description": "Whether the text has strikethrough.",
769 "title": "Strikethrough",
770 "type": "boolean"
771 },
772 "underline": {
773 "default": false,
774 "description": "Whether the text is underlined.",
775 "title": "Underline",
776 "type": "boolean"
777 }
778 },
779 "title": "TextAnnotations",
780 "type": "object"
781 },
782 {
783 "type": "null"
784 }
785 ],
786 "default": null,
787 "description": "Optional text styling annotations (bold, italic, etc.)."
788 },
789 "text": {
790 "description": "The text content object.",
791 "properties": {
792 "content": {
793 "description": "The actual text content. CRITICAL: Maximum 2000 characters per text object.",
794 "examples": ["Hello, World!", "This is a paragraph of text."],
795 "maxLength": 2000,
796 "title": "Content",
797 "type": "string"
798 },
799 "link": {
800 "anyOf": [
801 {
802 "description": "Link object for hyperlinked text.",
803 "properties": {
804 "url": {
805 "description": "The URL the text links to.",
806 "examples": [
807 "https://www.notion.so",
808 "https://example.com"
809 ],
810 "title": "Url",
811 "type": "string"
812 }
813 },
814 "required": ["url"],
815 "title": "TextLink",
816 "type": "object"
817 },
818 {
819 "type": "null"
820 }
821 ],
822 "default": null,
823 "description": "Optional link for the text."
824 }
825 },
826 "required": ["content"],
827 "title": "TextContent",
828 "type": "object"
829 },
830 "type": {
831 "const": "text",
832 "default": "text",
833 "description": "Type of rich text. Currently only 'text' is supported for input.",
834 "title": "Type",
835 "type": "string"
836 }
837 },
838 "required": ["text"],
839 "title": "RichTextInput",
840 "type": "object"
841 },
842 "minItems": 1,
843 "title": "Rich Text",
844 "type": "array"
845 }
846 },
847 "required": ["rich_text"],
848 "title": "HeadingInput",
849 "type": "object"
850 },
851 "object": {
852 "const": "block",
853 "default": "block",
854 "description": "Always 'block'.",
855 "title": "Object",
856 "type": "string"
857 },
858 "type": {
859 "const": "heading_3",
860 "default": "heading_3",
861 "description": "Block type.",
862 "title": "Type",
863 "type": "string"
864 }
865 },
866 "required": ["heading_3"],
867 "title": "Heading3BlockInput",
868 "type": "object"
869 },
870 {
871 "description": "A bulleted list item block object.",
872 "properties": {
873 "bulleted_list_item": {
874 "description": "Bulleted list item content.",
875 "properties": {
876 "color": {
877 "default": "default",
878 "description": "Color of the list item.",
879 "enum": [
880 "default",
881 "gray",
882 "brown",
883 "orange",
884 "yellow",
885 "green",
886 "blue",
887 "purple",
888 "pink",
889 "red",
890 "gray_background",
891 "brown_background",
892 "orange_background",
893 "yellow_background",
894 "green_background",
895 "blue_background",
896 "purple_background",
897 "pink_background",
898 "red_background"
899 ],
900 "title": "BlockColor",
901 "type": "string"
902 },
903 "rich_text": {
904 "description": "Array of rich text objects for the list item text.",
905 "items": {
906 "description": "Rich text object for creating text content in blocks.",
907 "properties": {
908 "annotations": {
909 "anyOf": [
910 {
911 "description": "Text styling annotations for rich text.",
912 "properties": {
913 "bold": {
914 "default": false,
915 "description": "Whether the text is bold.",
916 "title": "Bold",
917 "type": "boolean"
918 },
919 "code": {
920 "default": false,
921 "description": "Whether the text is formatted as inline code.",
922 "title": "Code",
923 "type": "boolean"
924 },
925 "color": {
926 "default": "default",
927 "description": "Color of the text or background.",
928 "enum": [
929 "default",
930 "gray",
931 "brown",
932 "orange",
933 "yellow",
934 "green",
935 "blue",
936 "purple",
937 "pink",
938 "red",
939 "gray_background",
940 "brown_background",
941 "orange_background",
942 "yellow_background",
943 "green_background",
944 "blue_background",
945 "purple_background",
946 "pink_background",
947 "red_background"
948 ],
949 "title": "BlockColor",
950 "type": "string"
951 },
952 "italic": {
953 "default": false,
954 "description": "Whether the text is italic.",
955 "title": "Italic",
956 "type": "boolean"
957 },
958 "strikethrough": {
959 "default": false,
960 "description": "Whether the text has strikethrough.",
961 "title": "Strikethrough",
962 "type": "boolean"
963 },
964 "underline": {
965 "default": false,
966 "description": "Whether the text is underlined.",
967 "title": "Underline",
968 "type": "boolean"
969 }
970 },
971 "title": "TextAnnotations",
972 "type": "object"
973 },
974 {
975 "type": "null"
976 }
977 ],
978 "default": null,
979 "description": "Optional text styling annotations (bold, italic, etc.)."
980 },
981 "text": {
982 "description": "The text content object.",
983 "properties": {
984 "content": {
985 "description": "The actual text content. CRITICAL: Maximum 2000 characters per text object.",
986 "examples": ["Hello, World!", "This is a paragraph of text."],
987 "maxLength": 2000,
988 "title": "Content",
989 "type": "string"
990 },
991 "link": {
992 "anyOf": [
993 {
994 "description": "Link object for hyperlinked text.",
995 "properties": {
996 "url": {
997 "description": "The URL the text links to.",
998 "examples": [
999 "https://www.notion.so",
1000 "https://example.com"
1001 ],
1002 "title": "Url",
1003 "type": "string"
1004 }
1005 },
1006 "required": ["url"],
1007 "title": "TextLink",
1008 "type": "object"
1009 },
1010 {
1011 "type": "null"
1012 }
1013 ],
1014 "default": null,
1015 "description": "Optional link for the text."
1016 }
1017 },
1018 "required": ["content"],
1019 "title": "TextContent",
1020 "type": "object"
1021 },
1022 "type": {
1023 "const": "text",
1024 "default": "text",
1025 "description": "Type of rich text. Currently only 'text' is supported for input.",
1026 "title": "Type",
1027 "type": "string"
1028 }
1029 },
1030 "required": ["text"],
1031 "title": "RichTextInput",
1032 "type": "object"
1033 },
1034 "minItems": 1,
1035 "title": "Rich Text",
1036 "type": "array"
1037 }
1038 },
1039 "required": ["rich_text"],
1040 "title": "ListItemInput",
1041 "type": "object"
1042 },
1043 "object": {
1044 "const": "block",
1045 "default": "block",
1046 "description": "Always 'block'.",
1047 "title": "Object",
1048 "type": "string"
1049 },
1050 "type": {
1051 "const": "bulleted_list_item",
1052 "default": "bulleted_list_item",
1053 "description": "Block type.",
1054 "title": "Type",
1055 "type": "string"
1056 }
1057 },
1058 "required": ["bulleted_list_item"],
1059 "title": "BulletedListItemBlockInput",
1060 "type": "object"
1061 },
1062 {
1063 "description": "A numbered list item block object.",
1064 "properties": {
1065 "numbered_list_item": {
1066 "description": "Numbered list item content.",
1067 "properties": {
1068 "color": {
1069 "default": "default",
1070 "description": "Color of the list item.",
1071 "enum": [
1072 "default",
1073 "gray",
1074 "brown",
1075 "orange",
1076 "yellow",
1077 "green",
1078 "blue",
1079 "purple",
1080 "pink",
1081 "red",
1082 "gray_background",
1083 "brown_background",
1084 "orange_background",
1085 "yellow_background",
1086 "green_background",
1087 "blue_background",
1088 "purple_background",
1089 "pink_background",
1090 "red_background"
1091 ],
1092 "title": "BlockColor",
1093 "type": "string"
1094 },
1095 "rich_text": {
1096 "description": "Array of rich text objects for the list item text.",
1097 "items": {
1098 "description": "Rich text object for creating text content in blocks.",
1099 "properties": {
1100 "annotations": {
1101 "anyOf": [
1102 {
1103 "description": "Text styling annotations for rich text.",
1104 "properties": {
1105 "bold": {
1106 "default": false,
1107 "description": "Whether the text is bold.",
1108 "title": "Bold",
1109 "type": "boolean"
1110 },
1111 "code": {
1112 "default": false,
1113 "description": "Whether the text is formatted as inline code.",
1114 "title": "Code",
1115 "type": "boolean"
1116 },
1117 "color": {
1118 "default": "default",
1119 "description": "Color of the text or background.",
1120 "enum": [
1121 "default",
1122 "gray",
1123 "brown",
1124 "orange",
1125 "yellow",
1126 "green",
1127 "blue",
1128 "purple",
1129 "pink",
1130 "red",
1131 "gray_background",
1132 "brown_background",
1133 "orange_background",
1134 "yellow_background",
1135 "green_background",
1136 "blue_background",
1137 "purple_background",
1138 "pink_background",
1139 "red_background"
1140 ],
1141 "title": "BlockColor",
1142 "type": "string"
1143 },
1144 "italic": {
1145 "default": false,
1146 "description": "Whether the text is italic.",
1147 "title": "Italic",
1148 "type": "boolean"
1149 },
1150 "strikethrough": {
1151 "default": false,
1152 "description": "Whether the text has strikethrough.",
1153 "title": "Strikethrough",
1154 "type": "boolean"
1155 },
1156 "underline": {
1157 "default": false,
1158 "description": "Whether the text is underlined.",
1159 "title": "Underline",
1160 "type": "boolean"
1161 }
1162 },
1163 "title": "TextAnnotations",
1164 "type": "object"
1165 },
1166 {
1167 "type": "null"
1168 }
1169 ],
1170 "default": null,
1171 "description": "Optional text styling annotations (bold, italic, etc.)."
1172 },
1173 "text": {
1174 "description": "The text content object.",
1175 "properties": {
1176 "content": {
1177 "description": "The actual text content. CRITICAL: Maximum 2000 characters per text object.",
1178 "examples": ["Hello, World!", "This is a paragraph of text."],
1179 "maxLength": 2000,
1180 "title": "Content",
1181 "type": "string"
1182 },
1183 "link": {
1184 "anyOf": [
1185 {
1186 "description": "Link object for hyperlinked text.",
1187 "properties": {
1188 "url": {
1189 "description": "The URL the text links to.",
1190 "examples": [
1191 "https://www.notion.so",
1192 "https://example.com"
1193 ],
1194 "title": "Url",
1195 "type": "string"
1196 }
1197 },
1198 "required": ["url"],
1199 "title": "TextLink",
1200 "type": "object"
1201 },
1202 {
1203 "type": "null"
1204 }
1205 ],
1206 "default": null,
1207 "description": "Optional link for the text."
1208 }
1209 },
1210 "required": ["content"],
1211 "title": "TextContent",
1212 "type": "object"
1213 },
1214 "type": {
1215 "const": "text",
1216 "default": "text",
1217 "description": "Type of rich text. Currently only 'text' is supported for input.",
1218 "title": "Type",
1219 "type": "string"
1220 }
1221 },
1222 "required": ["text"],
1223 "title": "RichTextInput",
1224 "type": "object"
1225 },
1226 "minItems": 1,
1227 "title": "Rich Text",
1228 "type": "array"
1229 }
1230 },
1231 "required": ["rich_text"],
1232 "title": "ListItemInput",
1233 "type": "object"
1234 },
1235 "object": {
1236 "const": "block",
1237 "default": "block",
1238 "description": "Always 'block'.",
1239 "title": "Object",
1240 "type": "string"
1241 },
1242 "type": {
1243 "const": "numbered_list_item",
1244 "default": "numbered_list_item",
1245 "description": "Block type.",
1246 "title": "Type",
1247 "type": "string"
1248 }
1249 },
1250 "required": ["numbered_list_item"],
1251 "title": "NumberedListItemBlockInput",
1252 "type": "object"
1253 }
1254 ],
1255 "properties": {}
1256 },
1257 "maxItems": 100,
1258 "title": "Children",
1259 "type": "array"
1260 }
1261 },
1262 "required": ["block_id", "children"],
1263 "title": "AppendTextBlocksRequest",
1264 "type": "object"
1265 },
1266 "output_parameters": {
1267 "properties": {
1268 "data": {
1269 "additionalProperties": false,
1270 "description": "Data from the action execution",
1271 "properties": {
1272 "block": {
1273 "additionalProperties": {
1274 "type": "string"
1275 },
1276 "description": "Empty object corresponding to the type field.",
1277 "title": "Block",
1278 "type": "object"
1279 },
1280 "has_more": {
1281 "description": "Whether there are more results available beyond this page.",
1282 "title": "Has More",
1283 "type": "boolean"
1284 },
1285 "next_cursor": {
1286 "anyOf": [
1287 {
1288 "type": "string"
1289 },
1290 {
1291 "type": "null"
1292 }
1293 ],
1294 "default": null,
1295 "description": "Cursor for pagination. Null if there are no more results.",
1296 "title": "Next Cursor"
1297 },
1298 "object": {
1299 "description": "Always 'list' for paginated responses.",
1300 "title": "Object",
1301 "type": "string"
1302 },
1303 "results": {
1304 "description": "Array of newly created block objects that were appended as children.",
1305 "items": {
1306 "additionalProperties": true,
1307 "description": "Notion block object returned in the results array.",
1308 "properties": {
1309 "archived": {
1310 "anyOf": [
1311 {
1312 "type": "boolean"
1313 },
1314 {
1315 "type": "null"
1316 }
1317 ],
1318 "default": null,
1319 "description": "Whether the block is archived.",
1320 "title": "Archived"
1321 },
1322 "created_by": {
1323 "anyOf": [
1324 {
1325 "description": "Partial user object representing a Notion user.",
1326 "properties": {
1327 "id": {
1328 "description": "Unique identifier for the user (UUID format).",
1329 "title": "Id",
1330 "type": "string"
1331 },
1332 "object": {
1333 "description": "Always 'user'.",
1334 "title": "Object",
1335 "type": "string"
1336 }
1337 },
1338 "required": ["object", "id"],
1339 "title": "PartialUser",
1340 "type": "object"
1341 },
1342 {
1343 "type": "null"
1344 }
1345 ],
1346 "default": null,
1347 "description": "Partial user object representing the user who created the block.",
1348 "title": "Created By"
1349 },
1350 "created_time": {
1351 "anyOf": [
1352 {
1353 "type": "string"
1354 },
1355 {
1356 "type": "null"
1357 }
1358 ],
1359 "default": null,
1360 "description": "ISO 8601 timestamp of when the block was created.",
1361 "title": "Created Time"
1362 },
1363 "has_children": {
1364 "anyOf": [
1365 {
1366 "type": "boolean"
1367 },
1368 {
1369 "type": "null"
1370 }
1371 ],
1372 "default": null,
1373 "description": "Whether the block has child blocks nested within it.",
1374 "title": "Has Children"
1375 },
1376 "id": {
1377 "description": "Unique identifier for the block (UUID v4 format).",
1378 "title": "Id",
1379 "type": "string"
1380 },
1381 "in_trash": {
1382 "anyOf": [
1383 {
1384 "type": "boolean"
1385 },
1386 {
1387 "type": "null"
1388 }
1389 ],
1390 "default": null,
1391 "description": "Whether the block is in the trash.",
1392 "title": "In Trash"
1393 },
1394 "last_edited_by": {
1395 "anyOf": [
1396 {
1397 "description": "Partial user object representing a Notion user.",
1398 "properties": {
1399 "id": {
1400 "description": "Unique identifier for the user (UUID format).",
1401 "title": "Id",
1402 "type": "string"
1403 },
1404 "object": {
1405 "description": "Always 'user'.",
1406 "title": "Object",
1407 "type": "string"
1408 }
1409 },
1410 "required": ["object", "id"],
1411 "title": "PartialUser",
1412 "type": "object"
1413 },
1414 {
1415 "type": "null"
1416 }
1417 ],
1418 "default": null,
1419 "description": "Partial user object representing the user who last edited the block.",
1420 "title": "Last Edited By"
1421 },
1422 "last_edited_time": {
1423 "anyOf": [
1424 {
1425 "type": "string"
1426 },
1427 {
1428 "type": "null"
1429 }
1430 ],
1431 "default": null,
1432 "description": "ISO 8601 timestamp of when the block was last edited.",
1433 "title": "Last Edited Time"
1434 },
1435 "object": {
1436 "description": "Always 'block'.",
1437 "title": "Object",
1438 "type": "string"
1439 },
1440 "parent": {
1441 "anyOf": [
1442 {
1443 "description": "Information about a block's parent.",
1444 "properties": {
1445 "block_id": {
1446 "anyOf": [
1447 {
1448 "type": "string"
1449 },
1450 {
1451 "type": "null"
1452 }
1453 ],
1454 "default": null,
1455 "description": "UUID of the parent block (when type is 'block_id').",
1456 "title": "Block Id"
1457 },
1458 "data_source_id": {
1459 "anyOf": [
1460 {
1461 "type": "string"
1462 },
1463 {
1464 "type": "null"
1465 }
1466 ],
1467 "default": null,
1468 "description": "UUID of the parent data source (when type is 'data_source_id').",
1469 "title": "Data Source Id"
1470 },
1471 "page_id": {
1472 "anyOf": [
1473 {
1474 "type": "string"
1475 },
1476 {
1477 "type": "null"
1478 }
1479 ],
1480 "default": null,
1481 "description": "UUID of the parent page (when type is 'page_id').",
1482 "title": "Page Id"
1483 },
1484 "type": {
1485 "description": "Type of parent: 'page_id', 'block_id', or 'data_source_id'.",
1486 "enum": ["page_id", "block_id", "data_source_id"],
1487 "title": "Type",
1488 "type": "string"
1489 }
1490 },
1491 "required": ["type"],
1492 "title": "BlockParent",
1493 "type": "object"
1494 },
1495 {
1496 "type": "null"
1497 }
1498 ],
1499 "default": null,
1500 "description": "Information about the block's parent.",
1501 "title": "Parent"
1502 },
1503 "type": {
1504 "description": "The type of block.",
1505 "title": "Type",
1506 "type": "string"
1507 }
1508 },
1509 "required": ["object", "id", "type"],
1510 "title": "Block",
1511 "type": "object"
1512 },
1513 "title": "Results",
1514 "type": "array"
1515 },
1516 "type": {
1517 "description": "The type of items in the results array. Always 'block'.",
1518 "title": "Type",
1519 "type": "string"
1520 }
1521 },
1522 "required": ["object", "results", "has_more", "type", "block"],
1523 "title": "Data",
1524 "type": "object"
1525 },
1526 "error": {
1527 "anyOf": [
1528 {
1529 "type": "string"
1530 },
1531 {
1532 "type": "null"
1533 }
1534 ],
1535 "default": null,
1536 "description": "Error if any occurred during the execution of the action",
1537 "title": "Error"
1538 },
1539 "successful": {
1540 "description": "Whether or not the action execution was successful or not",
1541 "title": "Successful",
1542 "type": "boolean"
1543 }
1544 },
1545 "required": ["data", "successful"],
1546 "title": "AppendBlocksResponseWrapper",
1547 "type": "object"
1548 },
1549 "scopes": [],
1550 "tags": ["blocks", "text"],
1551 "no_auth": false,
1552 "status": "active",
1553 "is_deprecated": false,
1554 "deprecated": {
1555 "displayName": "Append text blocks (paragraphs, headings, lists)",
1556 "version": "20260113_00",
1557 "available_versions": ["20260113_00"],
1558 "is_deprecated": false,
1559 "toolkit": {
1560 "logo": "https://logos.composio.dev/api/notion"
1561 }
1562 }
1563 }