@devries-cameron20 / composio Mirror · read-only
Fork 0

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

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 04:45 UTC

next
json 676 lines 24.5 KB
Raw
1 {
2 "slug": "NOTION_CREATE_COMMENT",
3 "name": "Create comment",
4 "description": "Adds a comment to a Notion page (via `parent_page_id`) OR to an existing discussion thread (via `discussion_id`); cannot create new discussion threads on specific blocks (inline comments).",
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 "properties": {
14 "comment": {
15 "additionalProperties": false,
16 "description": "Content of the comment as a NotionRichText object or a JSON string. Simplest form: {'content': 'Looks good!'} or {'text': 'Looks good!'} (both 'content' and 'text' are accepted as the field name). Can also be passed as a JSON string: '{\"content\": \"Looks good!\"}'. Optional styling fields: bold, italic, link, etc. Do NOT wrap this in a list or use Notion API block JSON.",
17 "examples": [
18 {
19 "content": "Looks good to me!"
20 },
21 {
22 "text": "Great work!"
23 },
24 {
25 "bold": true,
26 "content": "Fix typo"
27 }
28 ],
29 "properties": {
30 "block_property": {
31 "default": "paragraph",
32 "description": "The block property of the block to be added. Possible properties are `paragraph`, `heading_1`, `heading_2`, `heading_3`, `callout`, `to_do`, `toggle`, `quote`, `bulleted_list_item`, `numbered_list_item`. Other properties possible are `file`, `image`, `video` (link required), and `divider` (creates a horizontal divider line, no content required).",
33 "enum": [
34 "paragraph",
35 "heading_1",
36 "heading_2",
37 "heading_3",
38 "callout",
39 "to_do",
40 "toggle",
41 "quote",
42 "bulleted_list_item",
43 "numbered_list_item",
44 "file",
45 "image",
46 "video",
47 "divider"
48 ],
49 "examples": [
50 "paragraph",
51 "heading_1",
52 "heading_2",
53 "heading_3",
54 "bulleted_list_item",
55 "numbered_list_item",
56 "to_do",
57 "callout",
58 "toggle",
59 "quote",
60 "divider"
61 ],
62 "title": "Block Property",
63 "type": "string"
64 },
65 "bold": {
66 "default": false,
67 "description": "Indicates if the text is bold.",
68 "examples": [true, false],
69 "title": "Bold",
70 "type": "boolean"
71 },
72 "code": {
73 "default": false,
74 "description": "Indicates if the text is formatted as code.",
75 "examples": [true, false],
76 "title": "Code",
77 "type": "boolean"
78 },
79 "color": {
80 "default": "default",
81 "description": "The color of the text background or text itself.",
82 "examples": ["blue_background", "yellow_background", "gray", "purple"],
83 "title": "Color",
84 "type": "string"
85 },
86 "content": {
87 "anyOf": [
88 {
89 "type": "string"
90 },
91 {
92 "type": "null"
93 }
94 ],
95 "default": null,
96 "description": "The textual content of the rich text object. ENHANCED: Now automatically parses markdown formatting including bold (**text**), italic (*text*), strikethrough (~~text~~), inline code (`code`), and links ([text](url)). Required for paragraph, heading_1, heading_2, heading_3, callout, to_do, toggle, quote.",
97 "examples": [
98 "Hello World",
99 "This is **bold** and *italic* text",
100 "Visit [our site](https://example.com)",
101 "Use `code` snippets",
102 "~~Strikethrough~~ text"
103 ],
104 "title": "Content"
105 },
106 "italic": {
107 "default": false,
108 "description": "Indicates if the text is italic.",
109 "examples": [true, false],
110 "title": "Italic",
111 "type": "boolean"
112 },
113 "link": {
114 "anyOf": [
115 {
116 "type": "string"
117 },
118 {
119 "type": "null"
120 }
121 ],
122 "default": null,
123 "description": "The URL of the rich text object or the file to be uploaded or image/video link",
124 "examples": ["https://www.google.com"],
125 "title": "Link"
126 },
127 "strikethrough": {
128 "default": false,
129 "description": "Indicates if the text has strikethrough.",
130 "examples": [true, false],
131 "title": "Strikethrough",
132 "type": "boolean"
133 },
134 "underline": {
135 "default": false,
136 "description": "Indicates if the text is underlined.",
137 "examples": [true, false],
138 "title": "Underline",
139 "type": "boolean"
140 }
141 },
142 "title": "Comment",
143 "type": "object"
144 },
145 "discussion_id": {
146 "anyOf": [
147 {
148 "type": "string"
149 },
150 {
151 "type": "null"
152 }
153 ],
154 "default": null,
155 "description": "The ID of an existing discussion thread to which the comment will be added. This is required if `parent_page_id` is not provided.",
156 "examples": ["yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"],
157 "title": "Discussion Id"
158 },
159 "parent_page_id": {
160 "anyOf": [
161 {
162 "type": "string"
163 },
164 {
165 "type": "null"
166 }
167 ],
168 "default": null,
169 "description": "The ID of the Notion page where the comment will be added. This is required if `discussion_id` is not provided. Page IDs can be obtained using other Notion actions that fetch page details or list pages.",
170 "examples": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],
171 "title": "Parent Page Id"
172 }
173 },
174 "required": ["comment"],
175 "title": "CreateCommentRequest",
176 "type": "object"
177 },
178 "output_parameters": {
179 "properties": {
180 "data": {
181 "additionalProperties": false,
182 "description": "Data from the action execution",
183 "properties": {
184 "attachments": {
185 "anyOf": [
186 {
187 "items": {
188 "description": "File attachment on a comment.",
189 "properties": {
190 "category": {
191 "description": "The category of this attachment. Possible values are: 'audio', 'image', 'pdf', 'productivity', and 'video'.",
192 "title": "Category",
193 "type": "string"
194 },
195 "file": {
196 "description": "File object containing temporary download information.",
197 "properties": {
198 "expiry_time": {
199 "description": "ISO 8601 timestamp indicating when the temporary download URL expires.",
200 "title": "Expiry Time",
201 "type": "string"
202 },
203 "url": {
204 "description": "A temporary download link generated at the time of retrieving the comment.",
205 "title": "Url",
206 "type": "string"
207 }
208 },
209 "required": ["url", "expiry_time"],
210 "title": "NotionCommentAttachmentFile",
211 "type": "object"
212 }
213 },
214 "required": ["category", "file"],
215 "title": "NotionCommentAttachment",
216 "type": "object"
217 },
218 "type": "array"
219 },
220 {
221 "type": "null"
222 }
223 ],
224 "default": null,
225 "description": "Array of file attachments on the comment (maximum 3 attachments).",
226 "title": "Attachments"
227 },
228 "created_by": {
229 "anyOf": [
230 {
231 "description": "Partial user object containing information about the comment author.",
232 "properties": {
233 "id": {
234 "description": "Unique identifier for the user in UUID format.",
235 "title": "Id",
236 "type": "string"
237 },
238 "object": {
239 "const": "user",
240 "default": "user",
241 "description": "Always 'user'.",
242 "title": "Object",
243 "type": "string"
244 }
245 },
246 "required": ["id"],
247 "title": "NotionPartialUser",
248 "type": "object"
249 },
250 {
251 "type": "null"
252 }
253 ],
254 "default": null,
255 "description": "Partial user object containing information about the comment author.",
256 "title": "Created By"
257 },
258 "created_time": {
259 "anyOf": [
260 {
261 "type": "string"
262 },
263 {
264 "type": "null"
265 }
266 ],
267 "default": null,
268 "description": "ISO 8601 timestamp marking when the comment was created.",
269 "title": "Created Time"
270 },
271 "discussion_id": {
272 "anyOf": [
273 {
274 "type": "string"
275 },
276 {
277 "type": "null"
278 }
279 ],
280 "default": null,
281 "description": "Thread identifier associating the comment with a discussion in UUIDv4 format.",
282 "title": "Discussion Id"
283 },
284 "display_name": {
285 "anyOf": [
286 {
287 "description": "Custom display name configuration for the comment author.",
288 "properties": {
289 "resolved_name": {
290 "description": "The finalized display name that is rendered in the comment.",
291 "title": "Resolved Name",
292 "type": "string"
293 },
294 "type": {
295 "description": "Type of display name. One of: 'integration', 'user', or 'custom'.",
296 "title": "Type",
297 "type": "string"
298 }
299 },
300 "required": ["type", "resolved_name"],
301 "title": "NotionDisplayName",
302 "type": "object"
303 },
304 {
305 "type": "null"
306 }
307 ],
308 "default": null,
309 "description": "Custom display name configuration for the comment author, overriding the default author name.",
310 "title": "Display Name"
311 },
312 "id": {
313 "anyOf": [
314 {
315 "type": "string"
316 },
317 {
318 "type": "null"
319 }
320 ],
321 "default": null,
322 "description": "Unique identifier for the comment in UUIDv4 format.",
323 "title": "Id"
324 },
325 "last_edited_time": {
326 "anyOf": [
327 {
328 "type": "string"
329 },
330 {
331 "type": "null"
332 }
333 ],
334 "default": null,
335 "description": "ISO 8601 timestamp of the most recent modification to the comment.",
336 "title": "Last Edited Time"
337 },
338 "object": {
339 "anyOf": [
340 {
341 "const": "comment",
342 "type": "string"
343 },
344 {
345 "type": "null"
346 }
347 ],
348 "default": null,
349 "description": "Always 'comment'.",
350 "title": "Object"
351 },
352 "parent": {
353 "anyOf": [
354 {
355 "description": "Parent reference when the comment is on a page.",
356 "properties": {
357 "page_id": {
358 "description": "Page identifier in UUIDv4 format.",
359 "title": "Page Id",
360 "type": "string"
361 },
362 "type": {
363 "const": "page_id",
364 "default": "page_id",
365 "description": "Type identifier for page parent.",
366 "title": "Type",
367 "type": "string"
368 }
369 },
370 "required": ["page_id"],
371 "title": "NotionCommentParentPage",
372 "type": "object"
373 },
374 {
375 "description": "Parent reference when the comment is on a block.",
376 "properties": {
377 "block_id": {
378 "description": "Block identifier in UUIDv4 format.",
379 "title": "Block Id",
380 "type": "string"
381 },
382 "type": {
383 "const": "block_id",
384 "default": "block_id",
385 "description": "Type identifier for block parent.",
386 "title": "Type",
387 "type": "string"
388 }
389 },
390 "required": ["block_id"],
391 "title": "NotionCommentParentBlock",
392 "type": "object"
393 },
394 {
395 "type": "null"
396 }
397 ],
398 "default": null,
399 "description": "References the comment's parent (page or block).",
400 "title": "Parent"
401 },
402 "rich_text": {
403 "anyOf": [
404 {
405 "items": {
406 "description": "Rich text element supporting text, mention, and equation types.",
407 "properties": {
408 "annotations": {
409 "anyOf": [
410 {
411 "description": "Styling configuration for rich text.",
412 "properties": {
413 "bold": {
414 "anyOf": [
415 {
416 "type": "boolean"
417 },
418 {
419 "type": "null"
420 }
421 ],
422 "default": null,
423 "description": "Whether the text is bold.",
424 "title": "Bold"
425 },
426 "code": {
427 "anyOf": [
428 {
429 "type": "boolean"
430 },
431 {
432 "type": "null"
433 }
434 ],
435 "default": null,
436 "description": "Whether the text is formatted as code.",
437 "title": "Code"
438 },
439 "color": {
440 "anyOf": [
441 {
442 "type": "string"
443 },
444 {
445 "type": "null"
446 }
447 ],
448 "default": null,
449 "description": "Text color. One of: 'default', 'gray', 'brown', 'orange', 'yellow', 'green', 'blue', 'purple', 'pink', 'red', or any of these with '_background' suffix.",
450 "title": "Color"
451 },
452 "italic": {
453 "anyOf": [
454 {
455 "type": "boolean"
456 },
457 {
458 "type": "null"
459 }
460 ],
461 "default": null,
462 "description": "Whether the text is italic.",
463 "title": "Italic"
464 },
465 "strikethrough": {
466 "anyOf": [
467 {
468 "type": "boolean"
469 },
470 {
471 "type": "null"
472 }
473 ],
474 "default": null,
475 "description": "Whether the text has strikethrough.",
476 "title": "Strikethrough"
477 },
478 "underline": {
479 "anyOf": [
480 {
481 "type": "boolean"
482 },
483 {
484 "type": "null"
485 }
486 ],
487 "default": null,
488 "description": "Whether the text is underlined.",
489 "title": "Underline"
490 }
491 },
492 "title": "RichTextAnnotations",
493 "type": "object"
494 },
495 {
496 "type": "null"
497 }
498 ],
499 "default": null,
500 "description": "Styling configuration for the rich text."
501 },
502 "equation": {
503 "anyOf": [
504 {
505 "description": "Equation content for an equation-type rich text element.",
506 "properties": {
507 "expression": {
508 "description": "LaTeX formula expression.",
509 "title": "Expression",
510 "type": "string"
511 }
512 },
513 "required": ["expression"],
514 "title": "RichTextEquation",
515 "type": "object"
516 },
517 {
518 "type": "null"
519 }
520 ],
521 "default": null,
522 "description": "Present when type is 'equation'. Contains the LaTeX expression."
523 },
524 "href": {
525 "anyOf": [
526 {
527 "type": "string"
528 },
529 {
530 "type": "null"
531 }
532 ],
533 "default": null,
534 "description": "URL if the text is a link, otherwise null.",
535 "title": "Href"
536 },
537 "mention": {
538 "anyOf": [
539 {
540 "additionalProperties": true,
541 "type": "object"
542 },
543 {
544 "type": "null"
545 }
546 ],
547 "default": null,
548 "description": "Present when type is 'mention'. Contains mention-specific properties for database, date, link_preview, page, user, or template_mention types.",
549 "title": "Mention"
550 },
551 "plain_text": {
552 "anyOf": [
553 {
554 "type": "string"
555 },
556 {
557 "type": "null"
558 }
559 ],
560 "default": null,
561 "description": "Unformatted text content, providing a convenient way to access text without styling.",
562 "title": "Plain Text"
563 },
564 "text": {
565 "anyOf": [
566 {
567 "description": "Text content for a text-type rich text element.",
568 "properties": {
569 "content": {
570 "description": "The actual text content.",
571 "title": "Content",
572 "type": "string"
573 },
574 "link": {
575 "anyOf": [
576 {
577 "description": "Link object within text content.",
578 "properties": {
579 "url": {
580 "description": "The URL of the link.",
581 "title": "Url",
582 "type": "string"
583 }
584 },
585 "required": ["url"],
586 "title": "RichTextLink",
587 "type": "object"
588 },
589 {
590 "type": "null"
591 }
592 ],
593 "default": null,
594 "description": "Link object containing URL, or null if no link."
595 }
596 },
597 "required": ["content"],
598 "title": "RichTextTextContent",
599 "type": "object"
600 },
601 {
602 "type": "null"
603 }
604 ],
605 "default": null,
606 "description": "Present when type is 'text'. Contains the text content and optional link."
607 },
608 "type": {
609 "anyOf": [
610 {
611 "type": "string"
612 },
613 {
614 "type": "null"
615 }
616 ],
617 "default": null,
618 "description": "Type of rich text element. One of: 'text', 'mention', 'equation'.",
619 "title": "Type"
620 }
621 },
622 "title": "RichTextElement",
623 "type": "object"
624 },
625 "type": "array"
626 },
627 {
628 "type": "null"
629 }
630 ],
631 "default": null,
632 "description": "Array of rich text objects representing the content of the comment, which supports rich text formatting and links.",
633 "title": "Rich Text"
634 }
635 },
636 "title": "Data",
637 "type": "object"
638 },
639 "error": {
640 "anyOf": [
641 {
642 "type": "string"
643 },
644 {
645 "type": "null"
646 }
647 ],
648 "default": null,
649 "description": "Error if any occurred during the execution of the action",
650 "title": "Error"
651 },
652 "successful": {
653 "description": "Whether or not the action execution was successful or not",
654 "title": "Successful",
655 "type": "boolean"
656 }
657 },
658 "required": ["data", "successful"],
659 "title": "CreateCommentResponseWrapper",
660 "type": "object"
661 },
662 "scopes": ["comment:write"],
663 "tags": ["important", "openWorldHint"],
664 "no_auth": false,
665 "status": "active",
666 "is_deprecated": false,
667 "deprecated": {
668 "displayName": "Create comment",
669 "version": "20260113_00",
670 "available_versions": ["20260113_00"],
671 "is_deprecated": false,
672 "toolkit": {
673 "logo": "https://logos.composio.dev/api/notion"
674 }
675 }
676 }