@devries-cameron20 / composio Mirror · read-only / commits / 93fc6654c
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, 07:15 UTC

docs: update toolkits and API data

Sushmithamallesh committed Nov 3, 2026 at 10:06 UTC 93fc6654c5dd5972826a9d5be2274e276dcdb0dc
6 files changed +138177 -109028
docs/content/reference/api-reference/toolkits/index.mdx
+1 -1
@@ -25,4 +25,4 @@ To browse toolkits visually, see the [toolkits catalog](/toolkits). For the conc
25
26 ## Endpoints
27
28 -<ApiEndpointsTable endpoints={[{"method":"DELETE","pathV31":"/api/v3.1/custom/toolkits/{slug}","pathV3":"/api/v3/custom/toolkits/{slug}","summary":"Delete a custom toolkit","href":"/reference/api-reference/toolkits/deleteCustomToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/{toolkit_slug}/scopes/recommended","pathV3":"/api/v3/toolkits/{toolkit_slug}/scopes/recommended","summary":"Get required scopes","href":"/reference/api-reference/toolkits/recommendToolkitScopes"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{toolkit_slug}/scopes/grant_context","pathV3":"/api/v3/toolkits/{toolkit_slug}/scopes/grant_context","summary":"List grant contexts","href":"/reference/api-reference/toolkits/recommendToolkitScopesGrantContext"},{"method":"GET","pathV31":"/api/v3.1/toolkits","pathV3":"/api/v3/toolkits","summary":"List available toolkits","href":"/reference/api-reference/toolkits/getToolkits"},{"method":"GET","pathV31":"/api/v3.1/toolkits/categories","pathV3":"/api/v3/toolkits/categories","summary":"List toolkit categories","href":"/reference/api-reference/toolkits/getToolkitsCategories"},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/upsert","pathV3":"/api/v3/custom/toolkits/upsert","summary":"Upsert a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkitsUpsert"},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/sync","pathV3":"/api/v3/custom/toolkits/sync","summary":"Sync a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkitsSync"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{slug}","pathV3":"/api/v3/toolkits/{slug}","summary":"Get toolkit by slug","href":"/reference/api-reference/toolkits/getToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/multi","pathV3":"/api/v3/toolkits/multi","summary":"Fetch multiple toolkits","href":"/reference/api-reference/toolkits/postToolkitsMulti"},{"method":"GET","pathV31":"/api/v3.1/toolkits/changelog","pathV3":"/api/v3/toolkits/changelog","summary":"Get toolkits changelog","href":"/reference/api-reference/toolkits/getToolkitsChangelog"}]} />
28 +<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/custom/toolkits","pathV3":"/api/v3/custom/toolkits","summary":"Create a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkits"},{"method":"DELETE","pathV31":"/api/v3.1/custom/toolkits/{slug}","pathV3":"/api/v3/custom/toolkits/{slug}","summary":"Delete a custom toolkit","href":"/reference/api-reference/toolkits/deleteCustomToolkitsBySlug"},{"method":"PATCH","pathV31":"/api/v3.1/custom/toolkits/{slug}","pathV3":"/api/v3/custom/toolkits/{slug}","summary":"Update a custom toolkit","href":"/reference/api-reference/toolkits/patchCustomToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/{toolkit_slug}/scopes/recommended","pathV3":"/api/v3/toolkits/{toolkit_slug}/scopes/recommended","summary":"Get required scopes","href":"/reference/api-reference/toolkits/recommendToolkitScopes"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{toolkit_slug}/scopes/grant_context","pathV3":"/api/v3/toolkits/{toolkit_slug}/scopes/grant_context","summary":"List grant contexts","href":"/reference/api-reference/toolkits/recommendToolkitScopesGrantContext"},{"method":"GET","pathV31":"/api/v3.1/toolkits","pathV3":"/api/v3/toolkits","summary":"List available toolkits","href":"/reference/api-reference/toolkits/getToolkits"},{"method":"GET","pathV31":"/api/v3.1/toolkits/categories","pathV3":"/api/v3/toolkits/categories","summary":"List toolkit categories","href":"/reference/api-reference/toolkits/getToolkitsCategories"},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/upsert","pathV3":"/api/v3/custom/toolkits/upsert","summary":"Upsert a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkitsUpsert"},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/sync","pathV3":"/api/v3/custom/toolkits/sync","summary":"Sync a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkitsSync"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{slug}","pathV3":"/api/v3/toolkits/{slug}","summary":"Get toolkit by slug","href":"/reference/api-reference/toolkits/getToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/multi","pathV3":"/api/v3/toolkits/multi","summary":"Fetch multiple toolkits","href":"/reference/api-reference/toolkits/postToolkitsMulti"},{"method":"GET","pathV31":"/api/v3.1/toolkits/changelog","pathV3":"/api/v3/toolkits/changelog","summary":"Get toolkits changelog","href":"/reference/api-reference/toolkits/getToolkitsChangelog"}]} />
docs/public/data/toolkits-list.json
+254 -44
@@ -60,7 +60,7 @@
60 "name": "Supabase",
61 "logo": "https://logos.composio.dev/api/supabase",
62 "category": "developer tools",
63 - "toolCount": 133,
63 + "toolCount": 235,
64 "triggerCount": 0
65 },
66 {
@@ -68,7 +68,7 @@
68 "name": "Outlook",
69 "logo": "https://logos.composio.dev/api/outlook",
70 "category": "email",
71 - "toolCount": 329,
71 + "toolCount": 331,
72 "triggerCount": 5
73 },
74 {
@@ -108,7 +108,7 @@
108 "name": "HubSpot",
109 "logo": "https://logos.composio.dev/api/hubspot",
110 "category": "crm",
111 - "toolCount": 324,
111 + "toolCount": 336,
112 "triggerCount": 2
113 },
114 {
@@ -143,7 +143,7 @@
143 "name": "Jira",
144 "logo": "https://logos.composio.dev/api/jira",
145 "category": "project management",
146 - "toolCount": 119,
146 + "toolCount": 125,
147 "triggerCount": 17
148 },
149 {
@@ -296,7 +296,7 @@
296 "name": "ElevenLabs",
297 "logo": "https://logos.composio.dev/api/elevenlabs",
298 "category": "audio & speech",
299 - "toolCount": 167,
299 + "toolCount": 396,
300 "triggerCount": 0,
301 "instant": {
302 "supported": true
@@ -307,7 +307,7 @@
307 "name": "Microsoft Teams",
308 "logo": "https://logos.composio.dev/api/microsoft_teams",
309 "category": "team chat",
310 - "toolCount": 238,
310 + "toolCount": 246,
311 "triggerCount": 0
312 },
313 {
@@ -361,7 +361,7 @@
361 "name": "OneDrive",
362 "logo": "https://logos.composio.dev/api/one_drive",
363 "category": "file management & storage",
364 - "toolCount": 98,
364 + "toolCount": 102,
365 "triggerCount": 9
366 },
367 {
@@ -385,7 +385,7 @@
385 "name": "Salesforce",
386 "logo": "https://logos.composio.dev/api/salesforce",
387 "category": "crm",
388 - "toolCount": 324,
388 + "toolCount": 325,
389 "triggerCount": 7
390 },
391 {
@@ -419,9 +419,12 @@
419 "slug": "semrush",
420 "name": "Semrush",
421 "logo": "https://logos.composio.dev/api/semrush",
422 - "category": "seo & ai visibility",
423 - "toolCount": 37,
424 - "triggerCount": 0
422 + "category": "marketing",
423 + "toolCount": 98,
424 + "triggerCount": 0,
425 + "instant": {
426 + "supported": true
427 + }
428 },
429 {
430 "slug": "mem0",
@@ -532,7 +535,7 @@
535 "name": "Zoho",
536 "logo": "https://logos.composio.dev/api/zoho",
537 "category": "crm",
535 - "toolCount": 102,
538 + "toolCount": 103,
539 "triggerCount": 0
540 },
541 {
@@ -767,7 +770,7 @@
770 "name": "Meta Ads",
771 "logo": "https://logos.composio.dev/api/metaads",
772 "category": "ads & conversion",
770 - "toolCount": 93,
773 + "toolCount": 95,
774 "triggerCount": 0
775 },
776 {
@@ -949,7 +952,7 @@
952 "name": "Miro",
953 "logo": "https://logos.composio.dev/api/miro",
954 "category": "team collaboration",
952 - "toolCount": 85,
955 + "toolCount": 89,
956 "triggerCount": 0
957 },
958 {
@@ -957,7 +960,7 @@
960 "name": "SharePoint",
961 "logo": "https://logos.composio.dev/api/share_point",
962 "category": "documents",
960 - "toolCount": 148,
963 + "toolCount": 149,
964 "triggerCount": 0
965 },
966 {
@@ -1101,7 +1104,7 @@
1104 "name": "Zoho Books",
1105 "logo": "https://logos.composio.dev/api/zoho_books",
1106 "category": "accounting",
1104 - "toolCount": 267,
1107 + "toolCount": 270,
1108 "triggerCount": 0
1109 },
1110 {
@@ -1109,7 +1112,7 @@
1112 "name": "Zoho Inventory",
1113 "logo": "https://logos.composio.dev/api/zoho_inventory",
1114 "category": "accounting",
1112 - "toolCount": 79,
1115 + "toolCount": 83,
1116 "triggerCount": 0
1117 },
1118 {
@@ -1117,7 +1120,7 @@
1120 "name": "Facebook",
1121 "logo": "https://logos.composio.dev/api/facebook",
1122 "category": "social media accounts",
1120 - "toolCount": 63,
1123 + "toolCount": 64,
1124 "triggerCount": 0
1125 },
1126 {
@@ -1187,6 +1190,14 @@
1190 "toolCount": 101,
1191 "triggerCount": 0
1192 },
1193 + {
1194 + "slug": "amazon",
1195 + "name": "Amazon",
1196 + "logo": "https://logos.composio.dev/api/amazon",
1197 + "category": "ecommerce",
1198 + "toolCount": 0,
1199 + "triggerCount": 0
1200 + },
1201 {
1202 "slug": "dailybot",
1203 "name": "Dailybot",
@@ -1408,7 +1419,7 @@
1419 "name": "Gorgias",
1420 "logo": "https://logos.composio.dev/api/gorgias",
1421 "category": "crm",
1411 - "toolCount": 44,
1422 + "toolCount": 51,
1423 "triggerCount": 0
1424 },
1425 {
@@ -1432,7 +1443,7 @@
1443 "name": "Zoho Desk",
1444 "logo": "https://logos.composio.dev/api/zoho_desk",
1445 "category": "crm",
1435 - "toolCount": 33,
1446 + "toolCount": 36,
1447 "triggerCount": 0
1448 },
1449 {
@@ -1672,7 +1683,7 @@
1683 "name": "Servicem8",
1684 "logo": "https://logos.composio.dev/api/servicem8",
1685 "category": "scheduling & booking",
1675 - "toolCount": 57,
1686 + "toolCount": 61,
1687 "triggerCount": 0
1688 },
1689 {
@@ -2074,8 +2085,8 @@
2085 "slug": "agent_mail",
2086 "name": "Agent Mail",
2087 "logo": "https://logos.composio.dev/api/agent_mail",
2077 - "category": "ai agents",
2078 - "toolCount": 23,
2088 + "category": "email",
2089 + "toolCount": 93,
2090 "triggerCount": 1
2091 },
2092 {
@@ -2380,6 +2391,14 @@
2391 "toolCount": 3,
2392 "triggerCount": 0
2393 },
2394 + {
2395 + "slug": "anyapi",
2396 + "name": "AnyAPI",
2397 + "logo": "https://logos.composio.dev/api/anyapi",
2398 + "category": "developer tools",
2399 + "toolCount": 21,
2400 + "triggerCount": 0
2401 + },
2402 {
2403 "slug": "any_db",
2404 "name": "AnyDB",
@@ -3224,7 +3243,7 @@
3243 "name": "Bright Data",
3244 "logo": "https://logos.composio.dev/api/brightdata",
3245 "category": "web scraping & browser",
3227 - "toolCount": 29,
3246 + "toolCount": 167,
3247 "triggerCount": 0,
3248 "instant": {
3249 "supported": true
@@ -3938,6 +3957,14 @@
3957 "toolCount": 114,
3958 "triggerCount": 0
3959 },
3960 + {
3961 + "slug": "cloud_66",
3962 + "name": "Cloud 66",
3963 + "logo": "https://logos.composio.dev/api/cloud_66",
3964 + "category": "it operations",
3965 + "toolCount": 102,
3966 + "triggerCount": 0
3967 + },
3968 {
3969 "slug": "cloudcart",
3970 "name": "Cloudcart",
@@ -3959,8 +3986,11 @@
3986 "name": "Cloudflare Api Key",
3987 "logo": "https://www.cloudflare.com/img/logo-cloudflare.svg",
3988 "category": "security & identity tools",
3962 - "toolCount": 25,
3963 - "triggerCount": 0
3989 + "toolCount": 40,
3990 + "triggerCount": 0,
3991 + "instant": {
3992 + "supported": true
3993 + }
3994 },
3995 {
3996 "slug": "cloudflare_browser_rendering",
@@ -5631,7 +5661,7 @@
5661 "name": "Excel",
5662 "logo": "https://logos.composio.dev/api/excel",
5663 "category": "spreadsheets",
5634 - "toolCount": 118,
5664 + "toolCount": 125,
5665 "triggerCount": 0
5666 },
5667 {
@@ -5757,6 +5787,14 @@
5787 "toolCount": 15,
5788 "triggerCount": 0
5789 },
5790 + {
5791 + "slug": "fiber",
5792 + "name": "Fiber",
5793 + "logo": "https://logos.composio.dev/api/fiber",
5794 + "category": "hr talent & recruitment",
5795 + "toolCount": 247,
5796 + "triggerCount": 0
5797 + },
5798 {
5799 "slug": "fibery",
5800 "name": "Fibery",
@@ -6067,6 +6105,14 @@
6105 "toolCount": 1,
6106 "triggerCount": 0
6107 },
6108 + {
6109 + "slug": "frame_io_v4",
6110 + "name": "Frame.io V4",
6111 + "logo": "https://logos.composio.dev/api/frame_io_v4",
6112 + "category": "video & audio",
6113 + "toolCount": 97,
6114 + "triggerCount": 0
6115 + },
6116 {
6117 "slug": "framer",
6118 "name": "Framer",
@@ -6355,7 +6401,7 @@
6401 "name": "GitLab",
6402 "logo": "https://logos.composio.dev/api/gitlab",
6403 "category": "developer tools",
6358 - "toolCount": 131,
6404 + "toolCount": 316,
6405 "triggerCount": 0
6406 },
6407 {
@@ -6502,6 +6548,14 @@
6548 "toolCount": 33,
6549 "triggerCount": 0
6550 },
6551 + {
6552 + "slug": "google_business_profile",
6553 + "name": "Google Business Profile",
6554 + "logo": "https://logos.composio.dev/api/google_business_profile",
6555 + "category": "marketing",
6556 + "toolCount": 56,
6557 + "triggerCount": 0
6558 + },
6559 {
6560 "slug": "google_chat",
6561 "name": "Google Chat",
@@ -6654,6 +6708,14 @@
6708 "toolCount": 28,
6709 "triggerCount": 0
6710 },
6711 + {
6712 + "slug": "grain",
6713 + "name": "Grain",
6714 + "logo": "https://logos.composio.dev/api/grain",
6715 + "category": "ai meeting assistants",
6716 + "toolCount": 17,
6717 + "triggerCount": 0
6718 + },
6719 {
6720 "slug": "granola_mcp",
6721 "name": "Granola MCP",
@@ -6801,6 +6863,14 @@
6863 "toolCount": 7,
6864 "triggerCount": 0
6865 },
6866 + {
6867 + "slug": "harvey",
6868 + "name": "Harvey",
6869 + "logo": "https://logos.composio.dev/api/harvey",
6870 + "category": "artificial intelligence",
6871 + "toolCount": 35,
6872 + "triggerCount": 0
6873 + },
6874 {
6875 "slug": "hashnode",
6876 "name": "Hashnode",
@@ -7531,6 +7601,14 @@
7601 "toolCount": 10,
7602 "triggerCount": 0
7603 },
7604 + {
7605 + "slug": "ironclad",
7606 + "name": "Ironclad",
7607 + "logo": "https://logos.composio.dev/api/ironclad",
7608 + "category": "documents",
7609 + "toolCount": 80,
7610 + "triggerCount": 0
7611 + },
7612 {
7613 "slug": "iterable",
7614 "name": "Iterable",
@@ -7748,6 +7826,14 @@
7826 "toolCount": 4,
7827 "triggerCount": 0
7828 },
7829 + {
7830 + "slug": "kernel",
7831 + "name": "Kernel",
7832 + "logo": "https://logos.composio.dev/api/kernel",
7833 + "category": "developer tools",
7834 + "toolCount": 35,
7835 + "triggerCount": 0
7836 + },
7837 {
7838 "slug": "kernel_mcp",
7839 "name": "Kernel MCP",
@@ -8170,6 +8256,14 @@
8256 "toolCount": 10,
8257 "triggerCount": 0
8258 },
8259 + {
8260 + "slug": "linode",
8261 + "name": "Linode",
8262 + "logo": "https://logos.composio.dev/api/linode",
8263 + "category": "it operations",
8264 + "toolCount": 418,
8265 + "triggerCount": 0
8266 + },
8267 {
8268 "slug": "linq",
8269 "name": "Linq",
@@ -8317,7 +8411,7 @@
8411 "name": "Lusha",
8412 "logo": "https://logos.composio.dev/api/lusha",
8413 "category": "people & contact data",
8320 - "toolCount": 13,
8414 + "toolCount": 67,
8415 "triggerCount": 0,
8416 "instant": {
8417 "supported": true
@@ -8641,8 +8735,11 @@
8735 "name": "Memelord",
8736 "logo": "https://logos.composio.dev/api/memelord",
8737 "category": "ai content generation",
8644 - "toolCount": 5,
8645 - "triggerCount": 0
8738 + "toolCount": 22,
8739 + "triggerCount": 0,
8740 + "instant": {
8741 + "supported": true
8742 + }
8743 },
8744 {
8745 "slug": "memelord_mcp",
@@ -8729,7 +8826,7 @@
8826 "name": "Microsoft Entra ID",
8827 "logo": "https://logos.composio.dev/api/microsoft_entra_id",
8828 "category": "security & identity tools",
8732 - "toolCount": 73,
8829 + "toolCount": 76,
8830 "triggerCount": 0
8831 },
8832 {
@@ -8737,7 +8834,7 @@
8834 "name": "Microsoft OneNote",
8835 "logo": "https://logos.composio.dev/api/onenote",
8836 "category": "productivity",
8740 - "toolCount": 84,
8837 + "toolCount": 87,
8838 "triggerCount": 0
8839 },
8840 {
@@ -9601,7 +9698,10 @@
9698 "logo": "https://logos.composio.dev/api/openrouter",
9699 "category": "artificial intelligence",
9700 "toolCount": 20,
9604 - "triggerCount": 0
9701 + "triggerCount": 0,
9702 + "instant": {
9703 + "supported": true
9704 + }
9705 },
9706 {
9707 "slug": "openui",
@@ -10247,6 +10347,14 @@
10347 "toolCount": 6,
10348 "triggerCount": 0
10349 },
10350 + {
10351 + "slug": "ploid",
10352 + "name": "Ploid",
10353 + "logo": "https://logos.composio.dev/api/ploid",
10354 + "category": "ai agents",
10355 + "toolCount": 42,
10356 + "triggerCount": 0
10357 + },
10358 {
10359 "slug": "pneumatic",
10360 "name": "Pneumatic",
@@ -10263,6 +10371,14 @@
10371 "toolCount": 14,
10372 "triggerCount": 0
10373 },
10374 + {
10375 + "slug": "podio",
10376 + "name": "Podio",
10377 + "logo": "https://logos.composio.dev/api/podio",
10378 + "category": "project management",
10379 + "toolCount": 143,
10380 + "triggerCount": 0
10381 + },
10382 {
10383 "slug": "pointagram",
10384 "name": "Pointagram",
@@ -10276,7 +10392,7 @@
10392 "name": "Polar",
10393 "logo": "https://logos.composio.dev/api/polar",
10394 "category": "payment processing",
10279 - "toolCount": 181,
10395 + "toolCount": 134,
10396 "triggerCount": 0
10397 },
10398 {
@@ -10701,6 +10817,14 @@
10817 "toolCount": 36,
10818 "triggerCount": 0
10819 },
10820 + {
10821 + "slug": "qwilr",
10822 + "name": "Qwilr",
10823 + "logo": "https://logos.composio.dev/api/qwilr",
10824 + "category": "proposal & invoice management",
10825 + "toolCount": 15,
10826 + "triggerCount": 0
10827 + },
10828 {
10829 "slug": "radar",
10830 "name": "Radar",
@@ -10818,7 +10942,7 @@
10942 "name": "Readwise Reader",
10943 "logo": "https://logos.composio.dev/api/readwise_reader",
10944 "category": "bookmark managers",
10821 - "toolCount": 6,
10945 + "toolCount": 7,
10946 "triggerCount": 0
10947 },
10948 {
@@ -10946,7 +11070,7 @@
11070 "name": "Render",
11071 "logo": "https://logos.composio.dev/api/render",
11072 "category": "developer tools",
10949 - "toolCount": 99,
11073 + "toolCount": 216,
11074 "triggerCount": 0
11075 },
11076 {
@@ -11221,6 +11345,14 @@
11345 "toolCount": 255,
11346 "triggerCount": 0
11347 },
11348 + {
11349 + "slug": "sage_intacct",
11350 + "name": "Sage Intacct",
11351 + "logo": "https://logos.composio.dev/api/sage_intacct",
11352 + "category": "accounting",
11353 + "toolCount": 26,
11354 + "triggerCount": 0
11355 + },
11356 {
11357 "slug": "salesflare",
11358 "name": "Salesflare",
@@ -11229,6 +11361,14 @@
11361 "toolCount": 63,
11362 "triggerCount": 0
11363 },
11364 + {
11365 + "slug": "salesforce_data_360",
11366 + "name": "Salesforce Data 360",
11367 + "logo": "https://logos.composio.dev/api/salesforce_data_360",
11368 + "category": "business intelligence",
11369 + "toolCount": 424,
11370 + "triggerCount": 0
11371 + },
11372 {
11373 "slug": "salesforce_service_cloud",
11374 "name": "Salesforce Service Cloud",
@@ -11338,7 +11478,7 @@
11478 "name": "ScrapeCreators",
11479 "logo": "https://logos.composio.dev/api/scrapecreators",
11480 "category": "social & creator data",
11341 - "toolCount": 73,
11481 + "toolCount": 196,
11482 "triggerCount": 0,
11483 "instant": {
11484 "supported": true
@@ -11568,6 +11708,17 @@
11708 "toolCount": 9,
11709 "triggerCount": 0
11710 },
11711 + {
11712 + "slug": "seoptimer",
11713 + "name": "SEOptimer",
11714 + "logo": "https://logos.composio.dev/api/seoptimer",
11715 + "category": "analytics",
11716 + "toolCount": 2,
11717 + "triggerCount": 0,
11718 + "instant": {
11719 + "supported": true
11720 + }
11721 + },
11722 {
11723 "slug": "seqera",
11724 "name": "Seqera",
@@ -11904,7 +12055,7 @@
12055 "name": "Smartlead",
12056 "logo": "https://logos.composio.dev/api/smartlead",
12057 "category": "ai sales tools",
11907 - "toolCount": 47,
12058 + "toolCount": 51,
12059 "triggerCount": 0
12060 },
12061 {
@@ -11923,6 +12074,14 @@
12074 "toolCount": 185,
12075 "triggerCount": 0
12076 },
12077 + {
12078 + "slug": "smokeball",
12079 + "name": "Smokeball",
12080 + "logo": "https://logos.composio.dev/api/smokeball",
12081 + "category": "project management",
12082 + "toolCount": 168,
12083 + "triggerCount": 0
12084 + },
12085 {
12086 "slug": "smol_machines",
12087 "name": "Smol Machines",
@@ -12200,12 +12359,20 @@
12359 "name": "Strale",
12360 "logo": "https://logos.composio.dev/api/strale",
12361 "category": "developer tools",
12203 - "toolCount": 11,
12362 + "toolCount": 309,
12363 "triggerCount": 0,
12364 "instant": {
12365 "supported": true
12366 }
12367 },
12368 + {
12369 + "slug": "strava",
12370 + "name": "Strava",
12371 + "logo": "https://logos.composio.dev/api/strava",
12372 + "category": "fitness",
12373 + "toolCount": 36,
12374 + "triggerCount": 0
12375 + },
12376 {
12377 "slug": "streamtime",
12378 "name": "Streamtime",
@@ -12327,7 +12494,10 @@
12494 "logo": "https://logos.composio.dev/api/surf",
12495 "category": "artificial intelligence",
12496 "toolCount": 122,
12330 - "triggerCount": 0
12497 + "triggerCount": 0,
12498 + "instant": {
12499 + "supported": true
12500 + }
12501 },
12502 {
12503 "slug": "svix",
@@ -12465,6 +12635,14 @@
12635 "toolCount": 14,
12636 "triggerCount": 0
12637 },
12638 + {
12639 + "slug": "teamleader",
12640 + "name": "Teamleader Focus",
12641 + "logo": "https://logos.composio.dev/api/teamleader",
12642 + "category": "crm",
12643 + "toolCount": 278,
12644 + "triggerCount": 0
12645 + },
12646 {
12647 "slug": "teamwork",
12648 "name": "Teamwork",
@@ -12660,7 +12838,7 @@
12838 "name": "TikTok Ads",
12839 "logo": "https://logos.composio.dev/api/tiktok_ads",
12840 "category": "marketing",
12663 - "toolCount": 403,
12841 + "toolCount": 404,
12842 "triggerCount": 0
12843 },
12844 {
@@ -12789,6 +12967,14 @@
12967 "toolCount": 15,
12968 "triggerCount": 0
12969 },
12970 + {
12971 + "slug": "trestle",
12972 + "name": "Trestle",
12973 + "logo": "https://logos.composio.dev/api/trestle",
12974 + "category": "developer tools",
12975 + "toolCount": 3,
12976 + "triggerCount": 0
12977 + },
12978 {
12979 "slug": "trigger_dev",
12980 "name": "Trigger.dev",
@@ -12904,6 +13090,14 @@
13090 "toolCount": 8,
13091 "triggerCount": 0
13092 },
13093 + {
13094 + "slug": "twilio",
13095 + "name": "Twilio",
13096 + "logo": "https://logos.composio.dev/api/twilio",
13097 + "category": "communication",
13098 + "toolCount": 454,
13099 + "triggerCount": 45
13100 + },
13101 {
13102 "slug": "twittershots",
13103 "name": "TwitterShots",
@@ -13136,7 +13330,7 @@
13330 "name": "Vercel",
13331 "logo": "https://logos.composio.dev/api/vercel",
13332 "category": "developer tools",
13139 - "toolCount": 160,
13333 + "toolCount": 414,
13334 "triggerCount": 0
13335 },
13336 {
@@ -13411,7 +13605,7 @@
13605 "name": "Whop",
13606 "logo": "https://logos.composio.dev/api/whop",
13607 "category": "ecommerce",
13414 - "toolCount": 32,
13608 + "toolCount": 35,
13609 "triggerCount": 0
13610 },
13611 {
@@ -13732,6 +13926,22 @@
13926 "toolCount": 39,
13927 "triggerCount": 0
13928 },
13929 + {
13930 + "slug": "zoho_people",
13931 + "name": "Zoho People",
13932 + "logo": "https://logos.composio.dev/api/zoho_people",
13933 + "category": "human resources",
13934 + "toolCount": 160,
13935 + "triggerCount": 0
13936 + },
13937 + {
13938 + "slug": "zoho_projects",
13939 + "name": "Zoho Projects",
13940 + "logo": "https://logos.composio.dev/api/zoho_projects",
13941 + "category": "project management",
13942 + "toolCount": 542,
13943 + "triggerCount": 0
13944 + },
13945 {
13946 "slug": "zoho_recruit",
13947 "name": "Zoho Recruit",
docs/public/data/toolkits.json
+137142 -108826
@@ -13,7 +13,7 @@
13 ],
14 "toolCount": 63,
15 "triggerCount": 2,
16 - "version": "20261029_00",
16 + "version": "20261103_00",
17 "tools": [
18 {
19 "slug": "GMAIL_ADD_LABEL_TO_EMAIL",
@@ -23,17 +23,17 @@
23 {
24 "slug": "GMAIL_BATCH_DELETE_MESSAGES",
25 "name": "Batch delete Gmail messages",
26 - "description": "Tool to permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene). Use GMAIL_MOVE_TO_TRASH instead when reversibility may be needed. Always obtain explicit user confirmation and verify a sample of message IDs before executing. High-volume calls may trigger 429 rateLimitExceeded or 403 userRateLimitExceeded errors; apply exponential backoff."
26 + "description": "Permanently deletes multiple Gmail messages by ID, bypassing Trash. A successful request does not confirm individual messages existed or were deleted."
27 },
28 {
29 "slug": "GMAIL_BATCH_MODIFY_MESSAGES",
30 "name": "Batch modify Gmail messages",
31 - "description": "Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels. High-volume calls may return 429 rateLimitExceeded or 403 userRateLimitExceeded; apply exponential backoff."
31 + "description": "Adds or removes labels on up to 1,000 Gmail messages in one request, supporting operations such as archiving and marking messages read or unread. A successful response confirms request acceptance, not individual message status."
32 },
33 {
34 "slug": "GMAIL_CREATE_EMAIL_DRAFT",
35 "name": "Create email draft",
36 - "description": "Creates a Gmail email draft. While all fields are optional per the Gmail API, practical validation requires at least one of recipient_email, cc, or bcc and at least one of subject or body. Supports To/Cc/Bcc recipients, subject, plain/HTML body (ensure `is_html=True` for HTML), attachments, and threading. Returns a draft_id that must be used as-is with GMAIL_SEND_DRAFT — synthetic or stale IDs will fail. When creating a draft reply to an existing thread (thread_id provided), leave subject empty to stay in the same thread; setting a subject will create a NEW thread instead. HTTP 429 may occur on rapid creation/send sequences; apply exponential backoff."
36 + "description": "Creates a Gmail draft with optional recipients, subject, plain or HTML body, attachments, and threading. When a requested thread cannot be fetched, the draft is created without threading; a provided subject is used instead of the thread subject."
37 },
38 {
39 "slug": "GMAIL_CREATE_FILTER",
@@ -43,7 +43,7 @@
43 {
44 "slug": "GMAIL_CREATE_LABEL",
45 "name": "Create label",
46 - "description": "Creates a new label with a unique name in the specified user's Gmail account. Returns a labelId (e.g., 'Label_123') required for downstream tools like GMAIL_ADD_LABEL_TO_EMAIL, GMAIL_BATCH_MODIFY_MESSAGES, and GMAIL_MODIFY_THREAD_LABELS — those tools do not accept display names."
46 + "description": "Creates a Gmail label and returns its label ID. For nested labels, it may create missing parent labels; on a name conflict it attempts to return the existing matching label."
47 },
48 {
49 "slug": "GMAIL_DELETE_DRAFT",
@@ -73,27 +73,27 @@
73 {
74 "slug": "GMAIL_FETCH_EMAILS",
75 "name": "Fetch emails",
76 - "description": "Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval. Results are NOT sorted by recency; sort by internalDate client-side. The messages field may be absent or empty (valid no-results state); always null-check before accessing messageId or threadId. Null-check subject and header fields before string operations. For large result sets, prefer ids_only=true or metadata-only listing, then hydrate via GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID."
76 + "description": "Lists Gmail messages with query and label filtering, pagination, and optional message details. Individual detail fetches returning 404, 429, or 503 are skipped, so a page can contain fewer messages than the list result."
77 },
78 {
79 "slug": "GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID",
80 "name": "Fetch message by message ID",
81 - "description": "Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`. Spam/trash messages are excluded unless upstream list/search calls used `include_spam_trash=true`. Use `internalDate` (milliseconds since epoch) rather than header `Date` for recency checks."
81 + "description": "Fetches a Gmail message by its message ID in the requested format and returns formatted message details. Available fields depend on the format."
82 },
83 {
84 "slug": "GMAIL_FETCH_MESSAGE_BY_THREAD_ID",
85 "name": "Fetch Message by Thread ID",
86 - "description": "Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`. Returns a `messages` array; `thread_id` is not echoed in the response. Message order is not guaranteed — sort by `internalDate` to find oldest/newest. Check `labelIds` per message to filter drafts. Concurrent bulk calls may trigger 403 `userRateLimitExceeded` or 429; cap concurrency ~10 and use exponential backoff."
86 + "description": "Retrieves messages from an accessible Gmail thread by thread ID, returning thread details and a messages array. Message order is not guaranteed; use messageTimestamp to identify oldest or newest messages and labelIds to filter drafts."
87 },
88 {
89 "slug": "GMAIL_FORWARD_MESSAGE",
90 "name": "Forward email message",
91 - "description": "Forward an existing Gmail message to specified recipients, preserving original body and attachments. Verify recipients and content before forwarding to avoid unintended exposure. Bulk forwarding may trigger 429/5xx rate limits; keep concurrency to 5–10 and apply backoff. Messages near Gmail's size limits may fail; reconstruct a smaller draft if needed."
91 + "description": "Forwards an existing Gmail message to specified recipients, with optional additional text. The tool copies original message parts into a new message, but may alter MIME structure and attachment metadata."
92 },
93 {
94 "slug": "GMAIL_GET_ATTACHMENT",
95 "name": "Get Gmail attachment",
96 - "description": "Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs. Returns the downloaded file with its MIME type and filename. Attachments exceeding ~25 MB may be exposed as Google Drive links — use GOOGLEDRIVE_DOWNLOAD_FILE when a Drive file_id is present instead."
96 + "description": "Retrieves a Gmail message attachment by message and attachment IDs and returns a downloadable file using the supplied filename."
97 },
98 {
99 "slug": "GMAIL_GET_AUTO_FORWARDING",
@@ -103,7 +103,7 @@
103 {
104 "slug": "GMAIL_GET_CONTACTS",
105 "name": "Get contacts",
106 - "description": "Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination. Only covers saved contacts and 'Other Contacts'; email-header-only senders are out of scope. Contact records may have sparse data — handle missing fields gracefully. People API shares a per-user QPS quota; HTTP 429 requires exponential backoff (1s, 2s, 4s)."
106 + "description": "Lists saved Google contacts with selectable fields and pagination, optionally including Other Contacts. Other Contacts are fetched on the first page; endpoint failures can result in partial results, and contact records may be sparse."
107 },
108 {
109 "slug": "GMAIL_GET_DRAFT",
@@ -128,7 +128,7 @@
128 {
129 "slug": "GMAIL_GET_PEOPLE",
130 "name": "Get People",
131 - "description": "Retrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields` specifying the data to return. Scope is limited to the authenticated user's own contacts and 'Other Contacts' history only."
131 + "description": "Retrieves a person's details by resource name or lists the authenticated user's Other Contacts, using a field mask to select the information returned. Other Contacts can be paginated and queried using a sync token for changes since a previous sync."
132 },
133 {
134 "slug": "GMAIL_GET_PROFILE",
@@ -153,12 +153,12 @@
153 {
154 "slug": "GMAIL_LIST_CSE_IDENTITIES",
155 "name": "List CSE identities",
156 - "description": "Tool to list client-side encrypted identities for an authenticated user. Use when you need to retrieve CSE identity configurations including key pair associations."
156 + "description": "Lists a page of client-side encrypted identities and their key-pair associations. A response indicating that CSE is not enabled is returned as an empty list."
157 },
158 {
159 "slug": "GMAIL_LIST_CSE_KEYPAIRS",
160 "name": "List CSE key pairs",
161 - "description": "Tool to list client-side encryption key pairs for an authenticated user. Use when you need to retrieve CSE keypair configurations including public keys and enablement states. Supports pagination for large result sets."
161 + "description": "Lists a page of client-side encryption key pairs, including public keys and enablement states. A response indicating that CSE is not enabled is returned as an empty list."
162 },
163 {
164 "slug": "GMAIL_LIST_DRAFTS",
@@ -178,7 +178,7 @@
178 {
179 "slug": "GMAIL_LIST_HISTORY",
180 "name": "List Gmail history",
181 - "description": "Tool to list Gmail mailbox change history since a known startHistoryId. Use for incremental mailbox syncs. Persist the latest historyId as a checkpoint across sessions; without it, incremental sync is unreliable. An empty history list in the response is valid and means no new changes occurred."
181 + "description": "Lists Gmail mailbox change history since a known history ID for incremental sync, with optional label and history-type filters and pagination. An empty history list means no records matched the request, not necessarily that no mailbox changes occurred."
182 },
183 {
184 "slug": "GMAIL_LIST_LABELS",
@@ -198,7 +198,7 @@
198 {
199 "slug": "GMAIL_LIST_SMIME_INFO",
200 "name": "List S/MIME configs",
201 - "description": "Lists S/MIME configs for the specified send-as alias. Use when you need to retrieve all S/MIME certificate configurations associated with a specific send-as email address."
201 + "description": "Lists S/MIME certificate configurations for a specified Gmail send-as alias. If Gmail reports that the feature is not enabled, returns an empty list with S/MIME marked disabled."
202 },
203 {
204 "slug": "GMAIL_LIST_THREADS",
@@ -228,32 +228,32 @@
228 {
229 "slug": "GMAIL_PATCH_SEND_AS",
230 "name": "Patch send-as alias",
231 - "description": "Tool to patch the specified send-as alias for a Gmail user. Use when you need to update properties of an existing send-as email address such as display name, reply-to address, signature, default status, or SMTP configuration."
231 + "description": "Patches a Gmail send-as alias, including its display name, reply-to address, signature, default status, or SMTP configuration. This tool declares support for service-account OAuth, not standard OAuth."
232 },
233 {
234 "slug": "GMAIL_REMOVE_LABEL",
235 "name": "Remove label (Deprecated)",
236 - "description": "DEPRECATED: Use GMAIL_DELETE_LABEL instead. Permanently deletes a specific, existing user-created Gmail label by its ID for a user; cannot delete system labels."
236 + "description": "Permanently deletes an existing user-created Gmail label by ID and removes it from messages and threads where it is applied. This action is deprecated."
237 },
238 {
239 "slug": "GMAIL_REPLY_TO_THREAD",
240 "name": "Reply to email thread",
241 - "description": "Sends a reply within a specific Gmail thread using the original thread's subject; do not provide a custom subject as it will start a new conversation instead of replying in-thread. Requires a valid `thread_id` and at least one of `recipient_email`, `cc`, or `bcc`. Supports optional file attachments."
241 + "description": "Sends a reply to a Gmail thread using its original subject and quoting the last returned message. Requires a thread ID and at least one recipient, and supports optional file attachments."
242 },
243 {
244 "slug": "GMAIL_SEARCH_PEOPLE",
245 "name": "Search People",
246 - "description": "Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'. Only searches the authenticated user's contact directory — people existing solely in message headers won't appear; use GMAIL_FETCH_EMAILS for those. Results may be zero or multiple; never auto-select from ambiguous results. Results paginate via next_page_token; follow until empty and deduplicate by email. Many records lack emailAddresses or names even when requested — handle missing keys. Directory/organization policies may suppress entries."
246 + "description": "Searches saved contacts and optionally Other Contacts by query, returning matching person records. When both sources are requested, results may be partial if one search fails."
247 },
248 {
249 "slug": "GMAIL_SEND_DRAFT",
250 "name": "Send Draft",
251 - "description": "Sends an existing draft email AS-IS to recipients already defined within the draft. IMPORTANT: This action does NOT accept recipient parameters (to, cc, bcc). The Gmail API's drafts/send endpoint sends drafts to whatever recipients are already set in the draft's To, Cc, and Bcc headers - it cannot add or override recipients. If the draft has no recipients, you must either: 1. Create a new draft with recipients using GMAIL_CREATE_EMAIL_DRAFT, then send it 2. Use GMAIL_SEND_EMAIL to send a new email directly with recipients. Send is immediate and irreversible — confirm recipients and content before calling. No scheduling support; trigger at the desired UTC time externally. Gmail enforces ~25 MB message size limit and daily send caps (~500 recipients/day personal, ~2,000/day Workspace)."
251 + "description": "Sends an existing Gmail draft immediately to the recipients already in its To, Cc, and Bcc headers. The draft's recipients and content cannot be changed by this action; confirm them before sending."
252 },
253 {
254 "slug": "GMAIL_SEND_EMAIL",
255 "name": "Send Email",
256 - "description": "Sends an email via Gmail API using the authenticated user's Google profile display name. Sends immediately and is irreversible — confirm recipients, subject, body, and attachments before calling. At least one of 'to' (or 'recipient_email'), 'cc', or 'bcc' must be provided. At least one of subject or body must be provided. Requires `is_html=True` if the body contains HTML. All common file types including PNG, JPG, PDF, MP4, etc. are supported as attachments. Gmail API limits total message size to ~25 MB after base64 encoding. To reply in an existing thread, use GMAIL_REPLY_TO_THREAD instead. No scheduled send support; enforce timing externally."
256 + "description": "Sends an email immediately through Gmail to specified To, Cc, or Bcc recipients, with a subject or body and optional attachments. Supports plain text or HTML and may append the configured Gmail signature; attachments are limited to 20 MiB in total before encoding."
257 },
258 {
259 "slug": "GMAIL_SETTINGS_GET_IMAP",
@@ -293,7 +293,7 @@
293 {
294 "slug": "GMAIL_UPDATE_DRAFT",
295 "name": "Update draft",
296 - "description": "Updates (replaces) an existing Gmail draft's content in-place by draft ID. This action replaces the entire draft content with the new message - it does not patch individual fields. All fields are optional; if not provided, you should provide complete draft content to avoid data loss."
296 + "description": "Updates a Gmail draft by ID by replacing its message. The tool reads the existing draft to preserve omitted recipients, subject and body where applicable, but existing attachments are not preserved unless supplied again."
297 },
298 {
299 "slug": "GMAIL_UPDATE_IMAP_SETTINGS",
@@ -303,7 +303,7 @@
303 {
304 "slug": "GMAIL_UPDATE_LABEL",
305 "name": "Update Label",
306 - "description": "Tool to update the properties of an existing Gmail label. Use when you need to modify label name, visibility settings, or color."
306 + "description": "Updates an existing Gmail label's name, visibility settings, or color to help organize the mailbox. Color is available for user labels and requires both a background and text color from Gmail's supported palette."
307 },
308 {
309 "slug": "GMAIL_UPDATE_LANGUAGE_SETTINGS",
@@ -318,7 +318,7 @@
318 {
319 "slug": "GMAIL_UPDATE_SEND_AS",
320 "name": "Update send-as alias",
321 - "description": "Tool to update a send-as alias for a Gmail user. Use when you need to modify display name, signature, reply-to address, or SMTP settings for a send-as email address. Gmail sanitizes HTML signatures before saving. Addresses other than the primary can only be updated by service accounts with domain-wide authority."
321 + "description": "Updates a Gmail send-as alias, including its display name, signature, reply-to address, or SMTP settings; Gmail sanitizes HTML signatures before saving. The tool declares support for service-account OAuth, not standard OAuth; non-primary addresses require domain-wide delegation."
322 },
323 {
324 "slug": "GMAIL_UPDATE_VACATION_SETTINGS",
@@ -535,7 +535,7 @@
535 ],
536 "toolCount": 899,
537 "triggerCount": 46,
538 - "version": "20261023_00",
538 + "version": "20261103_00",
539 "tools": [
540 {
541 "slug": "GITHUB_ABORT_REPOSITORY_MIGRATION",
@@ -595,7 +595,7 @@
595 {
596 "slug": "GITHUB_ADD_OR_UPDATE_TEAM_PROJECT_PERMISSIONS",
597 "name": "Add or update team project permissions",
598 - "description": "Adds a classic project to a team or updates the team's permission on it. This endpoint grants or updates permissions for a team on a specific classic project (not Projects V2). The authenticated user must have admin permissions for the project. Both the team and project must belong to the same organization. Requirements: - The project must be a classic project (not GitHub Projects V2) - The authenticated user must have admin permissions on the project - The team and project must be in the same organization - Requires 'admin:org' scope for the authentication token Returns HTTP 204 No Content on success, 403 if project is not an org project, or 404 if the organization, team, or project is not found."
598 + "description": "Adds a classic organization project to a team or updates the team's permissions. GitHub sunset the Projects (classic) REST API on April 1, 2025; this does not manage Projects V2."
599 },
600 {
601 "slug": "GITHUB_ADD_OR_UPDATE_TEAM_REPOSITORY_PERMISSIONS",
@@ -605,7 +605,7 @@
605 {
606 "slug": "GITHUB_ADD_PROJECT_COLLABORATOR",
607 "name": "Add project collaborator",
608 - "description": "Adds a specified GitHub user as a collaborator to an existing organization project with a given permission level. Note: This endpoint is for organization projects (classic). You must be an organization owner or a project admin to add a collaborator. Classic projects are being deprecated in favor of the new Projects experience."
608 + "description": "Adds a GitHub user as a collaborator to an organization project (classic) with a specified permission level. The Projects (classic) REST API was sunset on GitHub.com on April 1, 2025; adding collaborators requires organization-owner or project-admin access."
609 },
610 {
611 "slug": "GITHUB_ADD_REPOSITORY_TO_APP_INSTALLATION",
@@ -630,7 +630,7 @@
630 {
631 "slug": "GITHUB_ADD_SELECTED_REPOSITORY_TO_ORGANIZATION_SECRET",
632 "name": "Add selected repository to an organization secret",
633 - "description": "Adds a repository to an organization secret's access list when the secret's visibility is 'selected'; this operation is idempotent."
633 + "description": "Adds a repository to the access list of an organization-level GitHub Codespaces secret with selected visibility."
634 },
635 {
636 "slug": "GITHUB_ADD_SELECTED_REPOSITORY_TO_ORGANIZATION_VARIABLE",
@@ -705,7 +705,7 @@
705 {
706 "slug": "GITHUB_BLOCK_USER_FROM_ORGANIZATION",
707 "name": "Block a user from an organization",
708 - "description": "Blocks a GitHub user from an organization, preventing their contributions, collaboration, and forking of the organization's repositories. Requires admin or 'Blocking users' organization permission (write access)."
708 + "description": "Blocks a GitHub user from an organization, preventing contributions, collaboration, and forking of its repositories; requires admin or 'Blocking users' organization permission. Certain permission and validation errors return a response with success=false."
709 },
710 {
711 "slug": "GITHUB_CANCEL_GITHUB_PAGES_DEPLOYMENT",
@@ -720,7 +720,7 @@
720 {
721 "slug": "GITHUB_CANCEL_WORKFLOW_RUN",
722 "name": "Cancel a workflow run",
723 - "description": "Cancels a workflow run in a GitHub repository if it is in a cancellable state (e.g., 'in_progress' or 'queued'). Returns 202 Accepted on success."
723 + "description": "Requests cancellation of a workflow run in a GitHub repository if it is in a cancellable state, such as in progress or queued. Returns an acceptance message when GitHub accepts the request; cancellation may take time to complete."
724 },
725 {
726 "slug": "GITHUB_CHECK_FOLLOWING",
@@ -730,7 +730,7 @@
730 {
731 "slug": "GITHUB_CHECK_IF_GIST_IS_STARRED",
732 "name": "Check if a gist is starred",
733 - "description": "Checks if a gist is starred by the authenticated user. Returns `is_starred: true` if the gist is starred (HTTP 204), or `is_starred: false` if not starred (HTTP 404). Use this to verify star status before starring/unstarring a gist."
733 + "description": "Checks whether the authenticated user has starred a GitHub gist. Returns true for HTTP 204 or 304 and false for HTTP 404; an unexpected successful status also yields false with a status message."
734 },
735 {
736 "slug": "GITHUB_CHECK_IF_PULL_REQUEST_HAS_BEEN_MERGED",
@@ -740,12 +740,12 @@
740 {
741 "slug": "GITHUB_CHECK_IF_PULL_REQUEST_MERGED",
742 "name": "Check if pull request merged",
743 - "description": "Checks if a pull request has been merged by querying the GitHub API. Use this action when you need to verify whether a specific pull request has been successfully merged into its target branch. The API returns a 204 status for merged PRs and 404 for unmerged PRs."
743 + "description": "Checks whether a GitHub pull request has been merged. Returns merged=True for HTTP 204 and merged=False for HTTP 404; a 404 can also mean the pull request does not exist."
744 },
745 {
746 "slug": "GITHUB_CHECK_IF_REPO_STARRED_BY_AUTH_USER",
747 "name": "Check if repo starred by auth user",
748 - "description": "DEPRECATED: Use `GITHUB_CHECK_IF_A_REPOSITORY_IS_STARRED_BY_THE_USER` instead."
748 + "description": "Checks whether the authenticated user has starred a specified GitHub repository. This action is deprecated."
749 },
750 {
751 "slug": "GITHUB_CHECK_IF_USER_CAN_BE_ASSIGNED",
@@ -765,17 +765,17 @@
765 {
766 "slug": "GITHUB_CHECK_IF_USER_IS_BLOCKED_BY_AUTHENTICATED_USER",
767 "name": "Check if a user is blocked by the authenticated user",
768 - "description": "Checks if the specified GitHub user is blocked by the authenticated user; a 204 No Content response indicates the user is blocked, while a 404 Not Found indicates they are not."
768 + "description": "Checks whether a specified GitHub user is blocked by the authenticated user. Both a blocked response and a 404 response are returned as an empty result, so the result does not distinguish those cases."
769 },
770 {
771 "slug": "GITHUB_CHECK_IF_USER_IS_BLOCKED_BY_ORGANIZATION",
772 "name": "Check if a user is blocked by an organization",
773 - "description": "Checks if a GitHub user is blocked by an organization. Returns is_blocked=True if the user is blocked (HTTP 204), or is_blocked=False if not blocked (HTTP 404). Requires 'Blocking users' organization permission (read access)."
773 + "description": "Checks whether a GitHub user is blocked by an organization; requires 'Blocking users' organization permission (read access). Returns is_blocked=True for HTTP 204, False for HTTP 404, and a null status with an error for HTTP 403."
774 },
775 {
776 "slug": "GITHUB_CHECK_IF_USER_IS_REPOSITORY_COLLABORATOR",
777 "name": "Check if a user is a repository collaborator",
778 - "description": "Checks if a user is a collaborator on a specified GitHub repository, returning a 204 status if they are, or a 404 status if they are not or if the repository/user does not exist."
778 + "description": "Checks whether a user is a collaborator on a GitHub repository, returning a boolean for HTTP 204 or 404; a 404 can also mean the repository or user does not exist. A 403 returns an indeterminate result with a permission error."
779 },
780 {
781 "slug": "GITHUB_CHECK_PERSON_FOLLOWED_BY_AUTH_USER",
@@ -790,7 +790,7 @@
790 {
791 "slug": "GITHUB_CHECK_PUBLIC_ORGANIZATION_MEMBERSHIP_FOR_USER",
792 "name": "Check public organization membership",
793 - "description": "Tool to check if a user is a public member of an organization. Use when you need to verify public organization membership status."
793 + "description": "Check whether a user is a public member of a GitHub organization. A 404 is reported as not a public member, but may also indicate that the user or organization does not exist."
794 },
795 {
796 "slug": "GITHUB_CHECK_REPOSITORY_STARRED",
@@ -840,7 +840,7 @@
840 {
841 "slug": "GITHUB_COMMIT_MULTIPLE_FILES",
842 "name": "Commit Multiple Files",
843 - "description": "Tool to atomically create, update, or delete multiple files in a GitHub repository as a single commit. Uses Git Data APIs to avoid SHA mismatch conflicts that occur with the Contents API when multiple files are modified in parallel. Use when you need to make multi-file changes reliably. BRANCH CREATION: When committing to a new branch (e.g., 'fix/my-fix' or 'feature/new-feature'), you MUST provide 'base_branch' (typically 'main' or 'master') to create the branch from. If the branch already exists, base_branch is not needed. This action handles race conditions automatically: if the branch is updated by another commit between fetching the HEAD and updating the reference (resulting in a 422 'not a fast forward' error), the action will retry by refetching the HEAD and rebasing changes. Use max_retries to control this behavior."
843 + "description": "Creates, updates, or deletes repository files in a commit, with retries for non-fast-forward branch updates; a new branch in a nonempty repository requires a base branch. Empty repository initialization creates separate commits per file and may also write an initialization file to the default branch."
844 },
845 {
846 "slug": "GITHUB_COMPARE_TWO_COMMITS",
@@ -860,7 +860,7 @@
860 {
861 "slug": "GITHUB_CONVERT_ORG_MEMBER_TO_OUTSIDE_COLLABORATOR",
862 "name": "Convert an organization member to outside collaborator",
863 - "description": "Converts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories."
863 + "description": "Converts a GitHub organization member to an outside collaborator with access restricted to explicitly granted repositories. The conversion can be requested asynchronously; queued and completed responses are both returned as empty results."
864 },
865 {
866 "slug": "GITHUB_CONVERT_PULL_REQUEST_TO_DRAFT",
@@ -900,7 +900,7 @@
900 {
901 "slug": "GITHUB_CREATE_A_COMMIT",
902 "name": "Create a commit",
903 - "description": "Creates a new commit in a GitHub repository; the `tree` SHA and any `parents` SHAs must already exist in the repository."
903 + "description": "Creates a Git commit object in a GitHub repository using an existing tree SHA and optional existing parent commit SHAs. It does not update a branch reference."
904 },
905 {
906 "slug": "GITHUB_CREATE_A_COMMIT_COMMENT",
@@ -925,7 +925,7 @@
925 {
926 "slug": "GITHUB_CREATE_A_DEPLOYMENT",
927 "name": "Create a deployment",
928 - "description": "Creates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA) that must also exist within the repository."
928 + "description": "Creates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA). By default, it may attempt to merge the default branch into the requested ref if it is behind."
929 },
930 {
931 "slug": "GITHUB_CREATE_A_DEPLOYMENT_BRANCH_POLICY",
@@ -975,12 +975,12 @@
975 {
976 "slug": "GITHUB_CREATE_A_GITHUB_PAGES_SITE",
977 "name": "Create a github pages site",
978 - "description": "Configures or updates GitHub Pages for a repository, setting build type and source; ensure a Pages workflow exists for 'workflow' `build_type`, or `source_branch` exists for 'legacy' or unspecified `build_type`. This action allows users to effectively manage their GitHub Pages site settings, specifying how the site is built and where the source files are located."
978 + "description": "Creates a GitHub Pages site for a repository, with a choice of build type and source location."
979 },
980 {
981 "slug": "GITHUB_CREATE_A_LABEL",
982 "name": "Create a label",
983 - "description": "Creates a new label in a specified GitHub repository, provided the repository exists and the user has write permissions."
983 + "description": "Creates a label in a specified GitHub repository, provided the repository exists and the user has write permissions. If the label name already exists, it may return a message instead of creating a label."
984 },
985 {
986 "slug": "GITHUB_CREATE_A_MILESTONE",
@@ -1010,7 +1010,7 @@
1010 {
1011 "slug": "GITHUB_CREATE_AN_ORGANIZATION_PROJECT",
1012 "name": "Create an organization project",
1013 - "description": "Creates a new classic project board within a specified GitHub organization. Note: This action uses GitHub's Projects (classic) REST API. The classic projects feature may be disabled in some organizations, and GitHub recommends migrating to Projects V2 (accessible via GraphQL API) for new projects. Requirements: - The authenticated user must be an organization member with project creation permissions - Classic projects must be enabled for the organization - Requires 'repo' and 'admin:org' or 'write:org' scopes"
1013 + "description": "Creates a classic project board in a specified GitHub organization, with a name and optional description, for organizing project work. DEPRECATED: GitHub.com has disabled new classic project creation and sunset the classic REST API. Use GitHub Projects V2 instead."
1014 },
1015 {
1016 "slug": "GITHUB_CREATE_AN_ORGANIZATION_REPOSITORY",
@@ -1030,12 +1030,12 @@
1030 {
1031 "slug": "GITHUB_CREATE_A_PROJECT_CARD",
1032 "name": "Create a project card",
1033 - "description": "Creates a project card in a GitHub project column (classic projects only). DEPRECATION NOTICE: GitHub Projects (classic) was sunset on August 23, 2024. This API only works with existing classic project columns. New classic projects cannot be created. Consider using GitHub Projects V2 (GraphQL API) instead. The request body must contain either: - `note`: A text note for the card - OR `content_id` AND `content_type`: To associate an issue or pull request"
1033 + "description": "Creates a card in a GitHub Projects (classic) column, either as a note or linked to an issue or pull request. DEPRECATED: The Projects (classic) REST API has been sunset, and Projects (classic) was removed from GitHub Enterprise Server 3.17. Use the newer GitHub Projects instead."
1034 },
1035 {
1036 "slug": "GITHUB_CREATE_A_PROJECT_COLUMN",
1037 "name": "Create a project column (Classic - Deprecated)",
1038 - "description": "Creates a new column in a GitHub project (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/"
1038 + "description": "Creates a named column in a GitHub Projects (classic) project to organize its cards. DEPRECATED: The Projects (classic) REST API has been sunset and this action no longer works on GitHub.com. Use GitHub Projects V2 with its GraphQL API instead."
1039 },
1040 {
1041 "slug": "GITHUB_CREATE_A_PULL_REQUEST",
@@ -1085,7 +1085,7 @@
1085 {
1086 "slug": "GITHUB_CREATE_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER",
1087 "name": "Create a repository for the authenticated user",
1088 - "description": "Creates a new repository for the authenticated user, optionally within an organization if `team_id` is specified."
1088 + "description": "Creates a new repository for the authenticated user."
1089 },
1090 {
1091 "slug": "GITHUB_CREATE_A_REPOSITORY_FROM_AN_UNPUBLISHED_CODESPACE",
@@ -1095,7 +1095,7 @@
1095 {
1096 "slug": "GITHUB_CREATE_A_REPOSITORY_PROJECT",
1097 "name": "Create a repository project",
1098 - "description": "Creates a new GitHub Projects V2 project board linked to a specified repository. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub. The project is owned by the repository owner (user or organization) and linked to the specified repository."
1098 + "description": "Creates a GitHub Projects V2 project owned by the repository owner and linked to the specified repository. A supplied project description is not applied during creation."
1099 },
1100 {
1101 "slug": "GITHUB_CREATE_A_REPOSITORY_RULESET",
@@ -1120,7 +1120,7 @@
1120 {
1121 "slug": "GITHUB_CREATE_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
1122 "name": "Create a review comment for a pull request",
1123 - "description": "Creates a review comment on a pull request's diff, targeting a specific line, range of lines, an entire file, or replying to an existing comment."
1123 + "description": "Creates a review comment on a pull request diff at a specific line or range, using a diff position, or as a reply to an existing review comment."
1124 },
1125 {
1126 "slug": "GITHUB_CREATE_A_REVIEW_FOR_A_PULL_REQUEST",
@@ -1130,7 +1130,7 @@
1130 {
1131 "slug": "GITHUB_CREATE_A_SCOPED_ACCESS_TOKEN",
1132 "name": "Create a scoped access token",
1133 - "description": "Exchanges a user-to-server token for a new, fine-grained scoped access token for a GitHub App, requiring `client_id`, `access_token`, either `target` or `target_id`, and at least one permission; for repository-specific scoping, provide either `repositories` (names) or `repository_ids` (IDs), but not both."
1133 + "description": "Creates a repository-scoped and/or permission-scoped GitHub App user access token from a non-scoped user token. The endpoint requires Basic authentication with the app's client ID and client secret; repository scope may be specified by names or IDs."
1134 },
1135 {
1136 "slug": "GITHUB_CREATE_A_SNAPSHOT_OF_DEPENDENCIES_FOR_A_REPOSITORY",
@@ -1140,12 +1140,12 @@
1140 {
1141 "slug": "GITHUB_CREATE_A_TAG_OBJECT",
1142 "name": "Create a tag object",
1143 - "description": "Creates an annotated Git tag object in a repository, pointing to an existing Git object (commit, tree, or blob) defined by its SHA and ensuring the `type` field correctly specifies the object's type."
1143 + "description": "Creates an annotated Git tag object in a repository, pointing to an existing commit, tree, or blob identified by its SHA and specified type."
1144 },
1145 {
1146 "slug": "GITHUB_CREATE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORY",
1147 "name": "Create a tag protection state for a repository",
1148 - "description": "DEPRECATED: This API was sunset on August 30, 2024. Use GITHUB_CREATE_A_REPOSITORY_RULESET instead to create tag protection rules via repository rulesets."
1148 + "description": "Creates a legacy tag protection rule for a repository, using a glob pattern to select protected tags. DEPRECATED: GitHub sunset the tag protection API on GitHub.com and says it returns null data; use GITHUB_CREATE_A_REPOSITORY_RULESET to protect tags with repository rulesets instead."
1149 },
1150 {
1151 "slug": "GITHUB_CREATE_A_TEAM",
@@ -1165,7 +1165,7 @@
1165 {
1166 "slug": "GITHUB_CREATE_A_USER_PROJECT",
1167 "name": "Create a user project",
1168 - "description": "Creates a new GitHub Projects V2 project board for the authenticated user to organize and track issues, pull requests, and notes. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub."
1168 + "description": "Creates a GitHub Projects V2 project board for the authenticated user using the GraphQL API. An optional project description is accepted but not applied during creation."
1169 },
1170 {
1171 "slug": "GITHUB_CREATE_A_WORKFLOW_DISPATCH_EVENT",
@@ -1235,7 +1235,7 @@
1235 {
1236 "slug": "GITHUB_CREATE_OR_UPDATE_A_SECRET_FOR_THE_AUTHENTICATED_USER",
1237 "name": "Create or update a secret for the authenticated user",
1238 - "description": "Creates or updates a Codespaces secret for the authenticated user; `encrypted_value` must be encrypted with the public key (ID: `key_id`) from GitHub's 'Get public key for the authenticated user' endpoint."
1238 + "description": "Creates or updates a Codespaces secret for the authenticated user, optionally restricting access to selected repositories. Accepts plaintext and encrypts it using the user's GitHub public key, or accepts a pre-encrypted value with its key ID."
1239 },
1240 {
1241 "slug": "GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORG",
@@ -1250,12 +1250,12 @@
1250 {
1251 "slug": "GITHUB_CREATE_OR_UPDATE_FILE_CONTENTS",
1252 "name": "Create or update file contents",
1253 - "description": "Creates a new file or updates an existing file in a GitHub repository; SHA can be provided to validate file updates, automatically fetched if not provided."
1253 + "description": "Creates or updates a file in a GitHub repository with a commit message and supplied content. A missing non-default branch may result in the change being committed to the repository's default branch. Content may be supplied as plain text or Base64."
1254 },
1255 {
1256 "slug": "GITHUB_CREATE_OR_UPDATE_GITHUB_PAGES_SITE",
1257 "name": "Create or Update GitHub Pages Site",
1258 - "description": "Tool to enable or update GitHub Pages configuration for a repository. Use when setting up GitHub Pages for static site deployment or modifying Pages settings like custom domains and HTTPS enforcement."
1258 + "description": "Enables or updates GitHub Pages configuration for a repository, including source, custom domain and HTTPS settings. The build type defaults to legacy, which requires a source branch even when updating an existing site."
1259 },
1260 {
1261 "slug": "GITHUB_CREATE_OR_UPDATE_REPO_SECRET_WITH_ENCRYPTED_VALUE",
@@ -1310,7 +1310,7 @@
1310 {
1311 "slug": "GITHUB_CREATE_SPONSORS_TIER",
1312 "name": "Create Sponsors Tier",
1313 - "description": "Tool to create a new payment tier for your GitHub Sponsors profile using GraphQL. Use when you need to add a new sponsorship tier with a specific monthly price and description. The amount is specified in dollars and will be converted to cents automatically."
1313 + "description": "Create a GitHub Sponsors payment tier for a specified user or organization using GraphQL, with an amount and description."
1314 },
1315 {
1316 "slug": "GITHUB_CREATE_UPDATE_ORG_SECRET_WITH_LIB_SODIUM",
@@ -1355,17 +1355,17 @@
1355 {
1356 "slug": "GITHUB_DELETE_APP_AUTHORIZATION",
1357 "name": "Delete an app authorization",
1358 - "description": "Deletes an OAuth application grant for a user, which revokes ALL OAuth tokens and their associated authorizations for the application. This endpoint is only accessible to OAuth App owners and requires Basic Authentication using the OAuth App's client_id and client_secret."
1358 + "description": "Deletes a user's OAuth application grant, revoking the associated tokens for that application. Identify the grant with an access token issued by the app; GitHub requires the app's client ID and client secret for Basic Authentication."
1359 },
1360 {
1361 "slug": "GITHUB_DELETE_APP_TOKEN",
1362 "name": "Delete an app token",
1363 - "description": "Revokes a single OAuth access token for an OAuth App or GitHub App with OAuth authorization. IMPORTANT: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. It CANNOT be called with personal access tokens, GitHub App installation tokens, or any other token type. You must be the OAuth App owner to use this endpoint."
1363 + "description": "Revokes a specified OAuth access token issued by an OAuth App or a GitHub App with OAuth authorization. GitHub requires Basic Authentication using the app's client ID and client secret for this operation."
1364 },
1365 {
1366 "slug": "GITHUB_DELETE_A_REFERENCE",
1367 "name": "Delete a reference",
1368 - "description": "Deletes a Git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag')."
1368 + "description": "Deletes a Git reference from a repository. Branch names may be supplied without a prefix; they are treated as branch references."
1369 },
1370 {
1371 "slug": "GITHUB_DELETE_A_RELEASE",
@@ -1390,7 +1390,7 @@
1390 {
1391 "slug": "GITHUB_DELETE_A_REPOSITORY_INVITATION",
1392 "name": "Delete a repository invitation",
1393 - "description": "Deletes an active repository invitation, permanently revoking a user's access to collaborate on the specified repository."
1393 + "description": "Deletes a specified repository invitation."
1394 },
1395 {
1396 "slug": "GITHUB_DELETE_A_REPOSITORY_RULESET",
@@ -1435,7 +1435,7 @@
1435 {
1436 "slug": "GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_AN_ORGANIZATION",
1437 "name": "Delete a self hosted runner from an organization",
1438 - "description": "Forces the removal of a self-hosted runner from a GitHub organization. This endpoint can be used to completely remove the runner when the machine you were using no longer exists. The runner will be immediately disconnected from GitHub Actions. Requires admin:org scope and organization admin access. Returns 204 No Content on successful deletion."
1438 + "description": "Removes a self-hosted runner from a GitHub organization, including when its machine no longer exists, immediately disconnecting it from GitHub Actions. Requires organization admin access and appropriate authorization; successful deletion returns a success message."
1439 },
1440 {
1441 "slug": "GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_A_REPOSITORY",
@@ -1445,7 +1445,7 @@
1445 {
1446 "slug": "GITHUB_DELETE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORY",
1447 "name": "Delete a tag protection state for a repository",
1448 - "description": "DEPRECATED: This API was sunset on August 30, 2024. Use GITHUB_DELETE_A_REPOSITORY_RULESET instead to manage tag protection rules via repository rulesets."
1448 + "description": "Attempts to delete a repository tag protection rule by ID using GitHub's tag protection API, sunset on August 30, 2024. The response reports the HTTP status and a message, including for 404 and 410 responses."
1449 },
1450 {
1451 "slug": "GITHUB_DELETE_A_TEAM",
@@ -1535,7 +1535,7 @@
1535 {
1536 "slug": "GITHUB_DELETE_EMAIL_ADDRESS",
1537 "name": "Delete authenticated user email address",
1538 - "description": "Sends an empty request body to `DELETE /user/emails` to attempt deletion of user email addresses; the API typically requires specific emails, so outcome may vary."
1538 + "description": "Attempts to delete specified email addresses from the authenticated user's GitHub account."
1539 },
1540 {
1541 "slug": "GITHUB_DELETE_ENVIRONMENT",
@@ -1605,7 +1605,7 @@
1605 {
1606 "slug": "GITHUB_DELETE_ORGANIZATION_SECRET",
1607 "name": "Delete an organization secret",
1608 - "description": "Permanently deletes a secret from a GitHub organization, making it inaccessible to GitHub Actions workflows or other tools."
1608 + "description": "Permanently deletes a GitHub Actions secret from a GitHub organization, making it unavailable to workflows."
1609 },
1610 {
1611 "slug": "GITHUB_DELETE_ORGANIZATION_VARIABLE",
@@ -1620,17 +1620,17 @@
1620 {
1621 "slug": "GITHUB_DELETE_ORG_CODESPACE",
1622 "name": "Delete a codespace from the organization",
1623 - "description": "Permanently deletes a specific codespace belonging to a member of the specified organization."
1623 + "description": "Requests deletion of a specified organization member's codespace. A successful response may indicate that deletion was accepted and is still in progress; a not-modified response is also reported as successful."
1624 },
1625 {
1626 "slug": "GITHUB_DELETE_ORG_PACKAGE",
1627 "name": "Delete a package for an organization",
1628 - "description": "Deletes a specific package in an organization; cannot delete public packages with over 5,000 downloads."
1628 + "description": "Deletes a specific package in an organization; public packages with over 5,000 downloads cannot be deleted. Authentication, permission and not-found errors can be returned as response messages rather than raised."
1629 },
1630 {
1631 "slug": "GITHUB_DELETE_PACKAGE",
1632 "name": "Delete a package for the authenticated user",
1633 - "description": "Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API."
1633 + "description": "Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API. A 404 is returned with success set to false rather than raised."
1634 },
1635 {
1636 "slug": "GITHUB_DELETE_PACKAGE_VERSION",
@@ -1645,7 +1645,7 @@
1645 {
1646 "slug": "GITHUB_DELETE_PACKAGE_VERSION_FOR_A_USER",
1647 "name": "Delete package version for a user",
1648 - "description": "Permanently and irreversibly deletes a specific version of a package owned by the specified user."
1648 + "description": "Deletes a specific version of a package owned by the specified user. The response indicates whether deletion succeeded; authentication, permission, and not-found errors are returned as unsuccessful results."
1649 },
1650 {
1651 "slug": "GITHUB_DELETE_PENDING_REVIEW",
@@ -1710,7 +1710,7 @@
1710 {
1711 "slug": "GITHUB_DELETE_USER_PACKAGE",
1712 "name": "Delete a package for a user",
1713 - "description": "Deletes a package owned by the specified user, requiring admin permissions for the authenticated user; deletion of public packages with over 5,000 downloads may require GitHub support."
1713 + "description": "Deletes a package owned by the specified user, requiring admin permissions for the authenticated user; deletion of public packages with over 5,000 downloads may require GitHub support. A 404 or 422 is returned as an error message rather than raised."
1714 },
1715 {
1716 "slug": "GITHUB_DELETE_WORKFLOW_RUN_LOGS",
@@ -1750,12 +1750,12 @@
1750 {
1751 "slug": "GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_TAR",
1752 "name": "Download a repository tarball",
1753 - "description": "Downloads a repository's source code as a tarball (.tar.gz) archive for a specific Git reference, if the repository is accessible."
1753 + "description": "Gets a redirect URL for downloading a repository tarball at a specific Git reference. For private repositories, the URL expires after five minutes."
1754 },
1755 {
1756 "slug": "GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_ZIP",
1757 "name": "Download a repository archive ZIP",
1758 - "description": "Downloads a repository's source code as a ZIP archive for a specific Git reference (branch, tag, or commit SHA). IMPORTANT SIZE LIMITATION: This action may fail with 'payload too large' errors for large repositories due to platform size restrictions. If you encounter size limit issues, consider these alternatives: - Use GITHUB_GET_REPOSITORY_CONTENT to fetch specific files or directories (also lists directory contents) - Clone the repository using git if you need the full codebase Best suited for: small to medium repositories, downloading specific tagged releases, or quick code inspection."
1758 + "description": "Requests a ZIP archive of a repository at a specific Git reference (branch, tag, or commit SHA) and returns the redirect URL for downloading it. For private repositories, the URL expires after five minutes."
1759 },
1760 {
1761 "slug": "GITHUB_DOWNLOAD_JOB_LOGS_FOR_A_WORKFLOW_RUN",
@@ -1795,7 +1795,7 @@
1795 {
1796 "slug": "GITHUB_ENCRYPT_AND_UPDATE_DEV_SECRET",
1797 "name": "Encrypt and update dev secret",
1798 - "description": "Creates or updates a repository's development environment secret using an `encrypted_value` and its corresponding `key_id`; the secret must be pre-encrypted with the repository's Codespaces public key."
1798 + "description": "Creates or updates a repository's GitHub Codespaces secret. It accepts a plaintext value for automatic encryption or a value already encrypted with the repository's Codespaces public key."
1799 },
1800 {
1801 "slug": "GITHUB_ENCRYPT_ORG_DEV_ENV_SECRET",
@@ -1805,7 +1805,7 @@
1805 {
1806 "slug": "GITHUB_EXPORT_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
1807 "name": "Export a codespace for the authenticated user",
1808 - "description": "Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download URL."
1808 + "description": "Triggers an export of the authenticated user's specified codespace, automatically stopping it if active. Returns the export status and, when available, an export URL."
1809 },
1810 {
1811 "slug": "GITHUB_EXPORT_SBOM_FOR_REPO",
@@ -1815,12 +1815,12 @@
1815 {
1816 "slug": "GITHUB_FIND_PULL_REQUESTS",
1817 "name": "Find Pull Requests",
1818 - "description": "Primary tool to find and search pull requests. Supports filtering by repository, author, state, labels, and merge status, and returns structured PR data for reliable use in workflows. GitHub search results are capped at ~1000 total items; narrow filters when totals approach this limit. `created_since`/`updated_since` filter on creation/update timestamps, not `merged_at`; apply merge-date filtering client-side."
1818 + "description": "Searches pull requests by repository, author, state, labels, merge status, and other filters; without a repository or owner, it searches public repositories by default or PRs involving the authenticated user when requested. Search results are capped at approximately 1,000; creation and update date filters do not filter merge dates."
1819 },
1820 {
1821 "slug": "GITHUB_FIND_REPOSITORIES",
1822 "name": "Find Repositories",
1823 - "description": "AI-optimized repository search with smart filtering by language, stars, topics, and ownership. Builds intelligent search queries and returns clean, actionable repository data. Check `incomplete_results` in the response — when true, results are non-exhaustive. Search endpoints are rate-limited to ~30 requests/minute (vs. 5000/hour for general REST); apply backoff on 403/429. Total results are capped at ~1000 per query regardless of pagination."
1823 + "description": "Search GitHub repositories by keywords, language, stars, topics, and ownership, returning paginated results. Repository qualifiers are reduced to owner filters, an owner with no public repositories can yield an immediate empty result, and OR expressions are limited to six terms; check incomplete_results for non-exhaustive results."
1824 },
1825 {
1826 "slug": "GITHUB_FOLLOW_ORGANIZATION_GRAPHQL",
@@ -1840,7 +1840,7 @@
1840 {
1841 "slug": "GITHUB_FORCE_CANCEL_WORKFLOW_RUN",
1842 "name": "Force cancel a workflow run",
1843 - "description": "Forcefully cancels a queued or in-progress GitHub Actions workflow run, bypassing conditions like always() that would otherwise continue execution. Only use when the standard cancel endpoint fails. Cannot cancel completed workflow runs. Requires write permissions to the repository."
1843 + "description": "Requests force cancellation of a queued or in-progress GitHub Actions workflow run, bypassing conditions such as always(), when standard cancellation fails. A successful response means the request was accepted for asynchronous processing; completed runs cannot be canceled, and repository write permissions are required."
1844 },
1845 {
1846 "slug": "GITHUB_FORK_GIST",
@@ -1865,7 +1865,7 @@
1865 {
1866 "slug": "GITHUB_GET_ACCESS_RESTRICTIONS",
1867 "name": "Get access restrictions",
1868 - "description": "Lists users, teams, and GitHub Apps with push access to a branch; this branch must be protected in repository settings for detailed restrictions, otherwise expect a 404 or empty response."
1868 + "description": "Retrieves user, team, and GitHub App push restrictions for a protected branch. A 404 is returned as a message indicating that restrictions were not found; it can also mean the branch does not exist or is not protected."
1869 },
1870 {
1871 "slug": "GITHUB_GET_A_COMMIT",
@@ -1960,7 +1960,7 @@
1960 {
1961 "slug": "GITHUB_GET_AN_ORGANIZATION_PUBLIC_KEY",
1962 "name": "Get an organization public key",
1963 - "description": "Action for `GetAnOrganizationPublicKey`."
1963 + "description": "Retrieves a GitHub organization's Actions secrets public key for encrypting organization secrets."
1964 },
1965 {
1966 "slug": "GITHUB_GET_AN_ORGANIZATION_ROLE",
@@ -2020,7 +2020,7 @@
2020 {
2021 "slug": "GITHUB_GET_A_PROJECT_CARD",
2022 "name": "Get a project card",
2023 - "description": "Retrieves all details of a specific project card, given its unique `card_id`. DEPRECATION NOTICE: GitHub Projects (classic) REST API was sunset on April 1, 2025. This action only works with existing classic project cards that were created before the sunset date. For new projects, use GitHub Projects V2 (GraphQL API) instead."
2023 + "description": "Retrieves a GitHub Projects (classic) card by ID to inspect its details, such as its note or linked content and project column. DEPRECATED: The Projects (classic) REST API has been sunset on GitHub.com. Use GitHub Projects V2 instead."
2024 },
2025 {
2026 "slug": "GITHUB_GET_A_PROJECT_COLUMN",
@@ -2155,7 +2155,7 @@
2155 {
2156 "slug": "GITHUB_GET_A_TREE",
2157 "name": "List repository files and directories",
2158 - "description": "Browse and list all files/directories in a GitHub repository. Efficiently retrieves the complete repository structure in a single API call when used with recursive mode. Perfect for analyzing codebase structure, finding specific files, or getting an overview of repository contents without cloning."
2158 + "description": "Browse a GitHub repository's tree at a specified branch, tag, commit or tree SHA. Recursive mode lists nested entries in one request, but results can be truncated; check the returned truncation flag."
2159 },
2160 {
2161 "slug": "GITHUB_GET_A_USER",
@@ -2200,7 +2200,7 @@
2200 {
2201 "slug": "GITHUB_GET_BRANCH_PROTECTION",
2202 "name": "Get branch protection",
2203 - "description": "Retrieves branch protection settings for a specific, existing, and accessible branch in a GitHub repository; protection feature availability varies by GitHub product plan."
2203 + "description": "Retrieves branch protection settings for a specific accessible branch in a GitHub repository, such as required status checks, review requirements, and push restrictions. Availability varies by GitHub product plan; fine-grained tokens require repository Administration read permission. The branch name cannot contain wildcards."
2204 },
2205 {
2206 "slug": "GITHUB_GET_CATALOG_MODELS",
@@ -2280,7 +2280,7 @@
2280 {
2281 "slug": "GITHUB_GET_COMMIT_STATUSES",
2282 "name": "Get commit statuses",
2283 - "description": "List all statuses for a commit reference (SHA, branch, or tag) in reverse chronological order. Use when you need to check CI/CD status results from various systems for a specific commit."
2283 + "description": "Lists a page of statuses for a commit reference (SHA, branch, or tag) in reverse chronological order, for checking CI/CD results from various systems."
2284 },
2285 {
2286 "slug": "GITHUB_GET_COMMUNITY_PROFILE_METRICS",
@@ -2370,12 +2370,12 @@
2370 {
2371 "slug": "GITHUB_GET_GIST",
2372 "name": "Get a gist",
2373 - "description": "Fetches a specific GitHub gist by its `gist_id`, returning comprehensive details if the gist exists."
2373 + "description": "Fetches a GitHub gist by ID, including its files and metadata. File contents or the file list may be truncated; use the raw file URL or clone the gist to retrieve complete content when needed."
2374 },
2375 {
2376 "slug": "GITHUB_GET_GIST_COMMENT",
2377 "name": "Get a gist comment",
2378 - "description": "Retrieves a specific Gist comment by its ID and the Gist's ID."
2378 + "description": "Retrieves a specific GitHub Gist comment using the gist ID and comment ID, returning its text, author information, and timestamps."
2379 },
2380 {
2381 "slug": "GITHUB_GET_GIST_REVISION",
@@ -2385,7 +2385,7 @@
2385 {
2386 "slug": "GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_AN_ORGANIZATION",
2387 "name": "Get GitHub Actions cache usage for an organization",
2388 - "description": "Retrieves total GitHub Actions cache usage statistics for an organization, including active cache count and size across all repositories."
2388 + "description": "Retrieves total GitHub Actions cache usage for an organization, including active cache count and size across its repositories. Usage data refreshes approximately every five minutes and may lag changes."
2389 },
2390 {
2391 "slug": "GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_A_REPOSITORY",
@@ -2435,7 +2435,7 @@
2435 {
2436 "slug": "GITHUB_GET_GRAPHQL_NODE",
2437 "name": "Fetch GraphQL Node",
2438 - "description": "Tool to fetch any GitHub object by its global node ID. Use when you have a node_id and need to retrieve the corresponding object details."
2438 + "description": "Fetch a GitHub GraphQL node by its global ID. By default, only its ID is requested; supply a GraphQL fragment to retrieve additional fields."
2439 },
2440 {
2441 "slug": "GITHUB_GET_GRAPHQL_RATE_LIMIT",
@@ -2465,7 +2465,7 @@
2465 {
2466 "slug": "GITHUB_GET_ISSUE_COMMENTS",
2467 "name": "Get issue comments",
2468 - "description": "Retrieves all comments for a specific GitHub issue in chronological order. Use this action when you need to view discussion history, analyze comment threads, or fetch comment details for a specific issue. Comments can be filtered by update time and paginated for large discussions."
2468 + "description": "Retrieves a page of comments for a specific GitHub issue. Comments can be filtered by update time and paginated to view discussion history."
2469 },
2470 {
2471 "slug": "GITHUB_GET_LABEL",
@@ -2500,7 +2500,7 @@
2500 {
2501 "slug": "GITHUB_GET_OIDC_SUBJECT_CLAIM_TEMPLATE",
2502 "name": "Customize OIDC subject claim template",
2503 - "description": "Retrieves the OpenID Connect (OIDC) subject claim customization template for a repository, which defines the `sub` claim structure in OIDC tokens for GitHub Actions workflows; returns the default configuration if no customization is applied."
2503 + "description": "Retrieves the OpenID Connect (OIDC) subject claim customization template for a repository's GitHub Actions workflows. The validated response has no declared template fields."
2504 },
2505 {
2506 "slug": "GITHUB_GET_ORG_ALLOWED_ACTIONS",
@@ -2575,12 +2575,12 @@
2575 {
2576 "slug": "GITHUB_GET_PROJECT_PERMISSION_FOR_A_USER",
2577 "name": "Get project permission for a user",
2578 - "description": "Retrieves permission information for a GitHub project (classic) collaborator. Returns the permission level and full user object for a collaborator on a GitHub project (classic). The permission returned can be admin, write, read, or none."
2578 + "description": "Retrieves permission information for a GitHub project (classic) collaborator. Returns the permission level and may include the collaborator's GitHub user information."
2579 },
2580 {
2581 "slug": "GITHUB_GET_PUBLIC_KEY_FOR_SECRET_ENCRYPTION",
2582 "name": "Get public key for secret encryption",
2583 - "description": "Retrieves a repository's public key for encrypting GitHub Codespaces secrets; requires `repo` scope or equivalent read access to codespaces secrets for private repositories."
2583 + "description": "Retrieves a repository's public key for encrypting GitHub Codespaces secrets. For private repositories, classic OAuth or personal access tokens need the repo scope; fine-grained tokens need write permission for repository Codespaces secrets."
2584 },
2585 {
2586 "slug": "GITHUB_GET_PUBLIC_KEY_FOR_THE_AUTHENTICATED_USER",
@@ -2595,7 +2595,7 @@
2595 {
2596 "slug": "GITHUB_GET_PULL_REQUESTS",
2597 "name": "Get Pull Requests",
2598 - "description": "Retrieves a list of pull requests from a repository with flexible filtering options. Use this action when you need to list all pull requests in a repository, optionally filtered by state (open, closed, all), base branch, head branch, or sort order. Returns an array of pull request objects with comprehensive details including title, state, author, labels, timestamps, and branch information."
2598 + "description": "Retrieves a page of pull requests from a repository, optionally filtered by state, base branch, or head branch and sorted by the selected order. Returns pull request details including title, state, author, labels, timestamps, and branch information."
2599 },
2600 {
2601 "slug": "GITHUB_GET_RATE_LIMIT_STATUS_FOR_THE_AUTHENTICATED_USER",
@@ -2605,7 +2605,7 @@
2605 {
2606 "slug": "GITHUB_GET_RAW_REPOSITORY_CONTENT",
2607 "name": "Get Raw Repository Content",
2608 - "description": "Tool to fetch raw file content from a GitHub repository. Returns raw bytes in whatever format the file uses (JSON, CSV, binary, etc.) — parsing and validation are the caller's responsibility. Ensure owner, repo, ref, and path are consistent when combining with other GitHub tools to avoid mismatched-ref errors."
2608 + "description": "Fetches raw file content from a GitHub repository as a downloadable file, without parsing or validating its format. Ensure owner, repo, ref, and path are consistent when combining with other GitHub tools."
2609 },
2610 {
2611 "slug": "GITHUB_GET_REPO_ALLOWED_ACTIONS",
@@ -2630,7 +2630,7 @@
2630 {
2631 "slug": "GITHUB_GET_REPOSITORY_CONTENT",
2632 "name": "Get repository content",
2633 - "description": "Retrieves a file's Base64 encoded content or lists a directory's contents from a GitHub repository."
2633 + "description": "Retrieves a file's Base64-encoded content or lists a directory's contents in a GitHub repository. Specify a branch, tag, or commit to read from, or use the repository's default branch; an empty path lists the root directory."
2634 },
2635 {
2636 "slug": "GITHUB_GET_REPOSITORY_DISCUSSION_THREAD",
@@ -2650,7 +2650,7 @@
2650 {
2651 "slug": "GITHUB_GET_REPOSITORY_PERMISSIONS_FOR_A_USER",
2652 "name": "Get repository permissions for a user",
2653 - "description": "Retrieves a specific user's permission level ('admin', 'write', 'read', or 'none') for a given repository, where 'maintain' role is reported as 'write' and 'triage' as 'read'."
2653 + "description": "Retrieves a user's repository permission and assigned role, including custom roles. The legacy permission level is admin, write, read, or none; maintain maps to write and triage to read."
2654 },
2655 {
2656 "slug": "GITHUB_GET_REPOSITORY_PUBLIC_KEY_FOR_ENCRYPTION",
@@ -2680,7 +2680,7 @@
2680 {
2681 "slug": "GITHUB_GET_RULES_FOR_A_BRANCH",
2682 "name": "Get rules for a branch",
2683 - "description": "Retrieves all active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status."
2683 + "description": "Retrieves a page of active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status."
2684 },
2685 {
2686 "slug": "GITHUB_GET_SINGLE_ORG_SECRET_WITHOUT_DECRYPTION",
@@ -2695,17 +2695,17 @@
2695 {
2696 "slug": "GITHUB_GET_TEAM_MEMBERS",
2697 "name": "Get team members",
2698 - "description": "Retrieves a list of members for a specific team within an organization. Returns team members including members of child teams. Use this action when you need to see who belongs to a team, optionally filtered by their role (member or maintainer). Requires the authenticated user to have read access to the team within the organization."
2698 + "description": "Retrieves one page of members for a specific team within an organization, including members of child teams, optionally filtered by role. Requires the authenticated user to have read access to the team."
2699 },
2700 {
2701 "slug": "GITHUB_GET_TEAM_MEMBERSHIP_FOR_A_USER",
2702 "name": "Get team membership for a user",
2703 - "description": "Retrieves a user's role and membership status within a specific team in an organization. Returns membership details including role ('member' or 'maintainer') and state ('active' or 'pending'). If the user is not a member of the team, returns is_member=False with a descriptive message. Requires the authenticated user to be an organization member with visibility into the team."
2703 + "description": "Retrieves a user's role and membership status in a GitHub organization team. A successful lookup returns the role and state; is_member=False can also indicate access denial or a missing team or organization, not just non-membership."
2704 },
2705 {
2706 "slug": "GITHUB_GET_TEAMS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
2707 "name": "Get teams with access to the protected branch",
2708 - "description": "Lists teams with explicit push access to a protected branch, provided team restrictions are configured in the branch's protection settings; returns an empty list otherwise."
2708 + "description": "Lists teams with explicit push access to a protected branch. A 404 response is returned as an empty teams list, which can also reflect a missing branch or absent branch protection."
2709 },
2710 {
2711 "slug": "GITHUB_GET_THE_AUTHENTICATED_USER",
@@ -2715,7 +2715,7 @@
2715 {
2716 "slug": "GITHUB_GET_THE_COMBINED_STATUS_FOR_A_SPECIFIC_REFERENCE",
2717 "name": "Get the combined status for a specific reference",
2718 - "description": "Retrieves the aggregated commit status (e.g., success, failure, pending) from all checks for a specific reference (SHA, branch, or tag) in a GitHub repository."
2718 + "description": "Retrieves the combined commit status and status entries for a specific reference (SHA, branch, or tag) in a GitHub repository."
2719 },
2720 {
2721 "slug": "GITHUB_GET_THE_HOURLY_COMMIT_COUNT_FOR_EACH_DAY",
@@ -2785,7 +2785,7 @@
2785 {
2786 "slug": "GITHUB_GET_USERS_ATTESTATIONS",
2787 "name": "Get user attestations by subject digest",
2788 - "description": "Tool to get attestations by subject digest for a GitHub user. Use when you need to retrieve attestation data for a specific artifact or resource identified by its subject digest."
2788 + "description": "Retrieves attestations for a GitHub user and subject digest, with optional predicate filtering and pagination. A GitHub 404 is returned as an empty attestation list."
2789 },
2790 {
2791 "slug": "GITHUB_GET_USERS_PROJECTS_V2",
@@ -2795,7 +2795,7 @@
2795 {
2796 "slug": "GITHUB_GET_USERS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
2797 "name": "Get users with access to the protected branch",
2798 - "description": "Lists users with explicit push access to a protected branch, provided its protection rule restricts pushes to specific users."
2798 + "description": "Lists users with explicit push access to a protected branch through its push restrictions. A 404 response is returned as an empty user list, including when the branch or repository is inaccessible or missing."
2799 },
2800 {
2801 "slug": "GITHUB_GET_VIEWER_GRAPHQL",
@@ -2840,12 +2840,12 @@
2840 {
2841 "slug": "GITHUB_LIST_APP_INSTALLATIONS",
2842 "name": "List app installations for user token",
2843 - "description": "Lists GitHub App installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access."
2843 + "description": "Lists a page of GitHub App installations accessible to the authenticated user, including installation details, permissions, and repository access. Supports page and page-size selection and returns the total count of accessible installations."
2844 },
2845 {
2846 "slug": "GITHUB_LIST_APPS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
2847 "name": "Get apps with access to the protected branch",
2848 - "description": "Lists GitHub Apps with push access to a repository's protected branch."
2848 + "description": "Lists GitHub Apps with push access to a repository's protected branch. A 404 returns no app list and an explanatory message; it can indicate a missing branch or unavailable restrictions."
2849 },
2850 {
2851 "slug": "GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY",
@@ -2860,7 +2860,7 @@
2860 {
2861 "slug": "GITHUB_LIST_ASSIGNMENTS_FOR_A_CLASSROOM",
2862 "name": "List assignments for a classroom",
2863 - "description": "Lists all assignments for a given GitHub Classroom `classroom_id`; the classroom must exist and be accessible."
2863 + "description": "Lists a page of assignments for an accessible GitHub Classroom, with page and page-size controls."
2864 },
2865 {
2866 "slug": "GITHUB_LIST_ATTESTATION_REPOSITORIES",
@@ -2875,7 +2875,7 @@
2875 {
2876 "slug": "GITHUB_LIST_BRANCHES",
2877 "name": "List branches",
2878 - "description": "List branches in a GitHub repository. Returns branch names, commit information, and protection status. Use this action when you need to retrieve all branches in a repository, optionally filtered by protection status. This is useful for identifying available branches, checking which branches are protected, or preparing to create pull requests."
2878 + "description": "Lists a page of branches in a GitHub repository, optionally filtered by protection status. Returns branch names, commit information, and protection status."
2879 },
2880 {
2881 "slug": "GITHUB_LIST_BRANCHES_FOR_HEAD_COMMIT",
@@ -2890,12 +2890,12 @@
2890 {
2891 "slug": "GITHUB_LIST_CHECK_RUNS_FOR_A_REF",
2892 "name": "List check runs for a git ref",
2893 - "description": "List GitHub check runs for a commit SHA, branch, or tag to assess CI status and conclusions. Use when you need reliable CI pass/fail signals beyond commit metadata."
2893 + "description": "List GitHub check runs for a commit SHA, branch, or tag to assess CI status and conclusions. Results default to the latest runs; the filter can be set to include all runs."
2894 },
2895 {
2896 "slug": "GITHUB_LIST_CHECK_RUNS_IN_A_CHECK_SUITE",
2897 "name": "List check runs in a check suite",
2898 - "description": "Lists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status."
2898 + "description": "Lists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status. Results default to the latest runs; the filter can be set to include all runs."
2899 },
2900 {
2901 "slug": "GITHUB_LIST_CHECK_SUITES_FOR_A_GIT_REFERENCE",
@@ -2925,17 +2925,17 @@
2925 {
2926 "slug": "GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_AN_ORGANIZATION",
2927 "name": "List code scanning alerts for an organization",
2928 - "description": "Lists code scanning alerts for a GitHub organization; use EITHER `tool_name` OR `tool_guid` if filtering by tool, not both."
2928 + "description": "Lists code scanning alerts for a GitHub organization; use either tool name or tool GUID when filtering by tool. Some access or scanning errors return an empty alert list with a message."
2929 },
2930 {
2931 "slug": "GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_A_REPOSITORY",
2932 "name": "List code scanning alerts for a repository",
2933 - "description": "Lists code scanning alerts for a repository, optionally filtering by tool (which must have produced scan results for the repository), Git reference, state, or severity."
2933 + "description": "Lists code scanning alerts for a repository, optionally filtering by tool, Git reference, state, or severity. Some scanning or authorization errors return an empty alert list with a message rather than an error."
2934 },
2935 {
2936 "slug": "GITHUB_LIST_CODE_SCANNING_ANALYSES_FOR_A_REPOSITORY",
2937 "name": "List code scanning analyses for a repository",
2938 - "description": "Lists code scanning analyses for an existing repository, optionally filtering by tool (name or GUID), Git reference, or SARIF ID."
2938 + "description": "Lists code scanning analyses for a repository, optionally filtering by tool, Git reference, or SARIF ID. Some scanning and access errors return an empty list without an explanatory message."
2939 },
2940 {
2941 "slug": "GITHUB_LIST_CODES_OF_CONDUCT",
@@ -2950,7 +2950,7 @@
2950 {
2951 "slug": "GITHUB_LIST_CODESPACES_FOR_A_USER_IN_ORGANIZATION",
2952 "name": "List codespaces for a user in organization",
2953 - "description": "Lists all GitHub Codespaces owned by a specified member of a given organization."
2953 + "description": "Lists a page of GitHub Codespaces for a specified member of an organization, with pagination controls."
2954 },
2955 {
2956 "slug": "GITHUB_LIST_CODESPACES_FOR_THE_AUTHENTICATED_USER",
@@ -2970,22 +2970,22 @@
2970 {
2971 "slug": "GITHUB_LIST_COMMENTS_FOR_A_PULL_REQUEST_REVIEW",
2972 "name": "List comments for a pull request review",
2973 - "description": "Lists all comments for a specific review on a GitHub pull request."
2973 + "description": "Lists a page of comments for a specific review on a GitHub pull request, with pagination support."
2974 },
2975 {
2976 "slug": "GITHUB_LIST_COMMIT_COMMENTS",
2977 "name": "List commit comments",
2978 - "description": "Retrieves all comments for a specific commit in a GitHub repository, supporting pagination."
2978 + "description": "Retrieves a page of comments for a specific commit in a GitHub repository, supporting pagination."
2979 },
2980 {
2981 "slug": "GITHUB_LIST_COMMIT_COMMENTS_FOR_A_REPOSITORY",
2982 "name": "List commit comments for a repository",
2983 - "description": "Lists all commit comments for a specified repository, which must exist and be accessible."
2983 + "description": "Lists a page of commit comments for an accessible GitHub repository."
2984 },
2985 {
2986 "slug": "GITHUB_LIST_COMMITS",
2987 "name": "List commits",
2988 - "description": "Lists commits for a GitHub repository. Requires 'owner' (username/org) and 'repo' (repository name) parameters. Optionally filter by SHA/branch, path, author, committer, or date range."
2988 + "description": "Lists a page of commits for a GitHub repository, optionally filtered by SHA or branch, path, author, committer, or date range. The default page size is one commit."
2989 },
2990 {
2991 "slug": "GITHUB_LIST_COMMITS_ON_A_PULL_REQUEST",
@@ -3000,7 +3000,7 @@
3000 {
3001 "slug": "GITHUB_LIST_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATION",
3002 "name": "Get all custom properties for an organization",
3003 - "description": "Gets the schema definitions for all custom properties configured for an organization, not the specific values assigned to repositories."
3003 + "description": "Gets the schema definitions for an organization's custom properties, rather than repository-specific values. On non-200 responses, it returns an empty property list alongside an error and status code."
3004 },
3005 {
3006 "slug": "GITHUB_LIST_CUSTOM_PROPERTY_VALUES_FOR_A_REPOSITORY",
@@ -3030,7 +3030,7 @@
3030 {
3031 "slug": "GITHUB_LIST_DEPLOYMENT_BRANCH_POLICIES",
3032 "name": "List deployment branch policies",
3033 - "description": "Lists all deployment branch policies for a specified environment in a GitHub repository."
3033 + "description": "Lists a page of deployment branch policies for a specified environment in a GitHub repository."
3034 },
3035 {
3036 "slug": "GITHUB_LIST_DEPLOYMENTS",
@@ -3040,32 +3040,32 @@
3040 {
3041 "slug": "GITHUB_LIST_DEPLOYMENT_STATUSES",
3042 "name": "List deployment statuses",
3043 - "description": "Lists all statuses for a given deployment in a repository."
3043 + "description": "Lists a page of statuses for a given deployment in a repository."
3044 },
3045 {
3046 "slug": "GITHUB_LIST_DISCUSSION_COMMENTS",
3047 "name": "List discussion comments",
3048 - "description": "Lists all comments for a specific team discussion within an organization. Note: Team discussions are deprecated as of 2023-11-28. Consider using GitHub Discussions instead. This endpoint requires the authenticated user to be a member of the organization and have access to the team's discussions."
3048 + "description": "Lists a page of comments for a specific team discussion within an organization; team discussions are deprecated. A 404 response is returned as an empty list, so an empty result does not necessarily mean there are no comments."
3049 },
3050 {
3051 "slug": "GITHUB_LIST_DISCUSSIONS",
3052 "name": "List discussions",
3053 - "description": "Lists discussions for a specific team within an organization, with options for sorting, pagination, and filtering by pinned status. Note: Team discussions are deprecated as of 2023-11-28. Consider using GitHub Discussions instead. This endpoint requires the authenticated user to be a member of the organization and have access to the team's discussions."
3053 + "description": "Lists a page of discussions for a specific team within an organization, with sorting and pinned-status filtering; team discussions are deprecated. A 404 response is returned as an empty list, so an empty result does not necessarily mean there are no discussions."
3054 },
3055 {
3056 "slug": "GITHUB_LIST_EMAIL_ADDRESSES_FOR_THE_AUTHENTICATED_USER",
3057 "name": "List email addresses for the authenticated user",
3058 - "description": "Lists all email addresses for the authenticated user, including their primary status, verification status, and visibility. This action retrieves the complete list of email addresses associated with the authenticated user, providing important details such as which email is primary and whether the emails are verified."
3058 + "description": "Lists a page of email addresses for the authenticated user, including their primary status, verification status, and visibility."
3059 },
3060 {
3061 "slug": "GITHUB_LIST_ENVIRONMENT_CUSTOM_DEPLOYMENT_RULES",
3062 "name": "List environment custom deployment rules",
3063 - "description": "Lists all custom deployment protection rule integrations for a repository environment; the `environment_name` must be URL-encoded."
3063 + "description": "Lists a page of custom deployment protection rule integrations available for a GitHub repository environment. The caller must have repository admin or owner permissions; pagination supports up to 100 results per page."
3064 },
3065 {
3066 "slug": "GITHUB_LIST_ENVIRONMENTS",
3067 "name": "List environments",
3068 - "description": "Retrieves all deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages."
3068 + "description": "Retrieves a page of deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages."
3069 },
3070 {
3071 "slug": "GITHUB_LIST_ENVIRONMENT_SECRETS",
@@ -3075,7 +3075,7 @@
3075 {
3076 "slug": "GITHUB_LIST_ENVIRONMENT_VARIABLES",
3077 "name": "List environment variables",
3078 - "description": "Lists all environment variables, which are plaintext key-value pairs for GitHub Actions workflows, for a specified environment within a GitHub repository."
3078 + "description": "Lists a page of plaintext GitHub Actions environment variables for a specified environment within a repository."
3079 },
3080 {
3081 "slug": "GITHUB_LIST_EVENTS_FOR_THE_AUTHENTICATED_USER",
@@ -3120,12 +3120,12 @@
3120 {
3121 "slug": "GITHUB_LIST_GIST_COMMITS",
3122 "name": "List gist commits",
3123 - "description": "Lists all commits for a specified gist."
3123 + "description": "Lists a page of commits for a specified gist, with pagination controls."
3124 },
3125 {
3126 "slug": "GITHUB_LIST_GIST_FORKS",
3127 "name": "List gist forks",
3128 - "description": "Lists all forks for a given GitHub gist ID."
3128 + "description": "Lists a page of forks for a given GitHub gist ID, with pagination controls."
3129 },
3130 {
3131 "slug": "GITHUB_LIST_GISTS_FOR_A_USER",
@@ -3155,7 +3155,7 @@
3155 {
3156 "slug": "GITHUB_LIST_GLOBAL_SECURITY_ADVISORIES",
3157 "name": "List global security advisories",
3158 - "description": "Lists GitHub's global security advisories, filterable by various attributes including ID, type, ecosystem, severity, and dates."
3158 + "description": "Lists GitHub's global security advisories, filterable by ID, type, ecosystem, severity, dates, and other attributes. The advisory type defaults to reviewed."
3159 },
3160 {
3161 "slug": "GITHUB_LIST_GPG_KEYS_FOR_A_USER",
@@ -3170,7 +3170,7 @@
3170 {
3171 "slug": "GITHUB_LIST_INSTANCES_OF_A_CODE_SCANNING_ALERT",
3172 "name": "List instances of a code scanning alert",
3173 - "description": "Lists all instances of a specific code scanning alert, optionally filtered by Git ref; requires code scanning to be enabled on the repository."
3173 + "description": "Lists a page of instances of a specific code scanning alert, optionally filtered by Git ref. Some access or repository-state errors are returned as an empty instance list with an explanatory message."
3174 },
3175 {
3176 "slug": "GITHUB_LIST_ISSUE_COMMENTS",
@@ -3185,7 +3185,7 @@
3185 {
3186 "slug": "GITHUB_LIST_ISSUE_DEPENDENCIES_BLOCKED_BY",
3187 "name": "List issue dependencies blocked by",
3188 - "description": "Tool to list dependencies an issue is blocked by. Use when you need to retrieve all issues that are blocking a specific issue from being closed or completed."
3188 + "description": "Lists a page of issues that block a specified GitHub issue."
3189 },
3190 {
3191 "slug": "GITHUB_LIST_ISSUE_DEPENDENCIES_BLOCKING",
@@ -3195,12 +3195,12 @@
3195 {
3196 "slug": "GITHUB_LIST_ISSUE_EVENTS",
3197 "name": "List issue events",
3198 - "description": "Retrieves a list of all events for a specific issue within a GitHub repository."
3198 + "description": "Retrieves a page of issue events for a specific issue within a GitHub repository."
3199 },
3200 {
3201 "slug": "GITHUB_LIST_ISSUE_EVENTS_FOR_A_REPOSITORY",
3202 "name": "List issue events for a repository",
3203 - "description": "Lists all issue events (e.g., closed, reopened, assigned) for a specified repository."
3203 + "description": "Lists a page of issue events, such as closed, reopened, and assigned events, for a specified repository."
3204 },
3205 {
3206 "slug": "GITHUB_LIST_ISSUES_ASSIGNED_TO_THE_AUTHENTICATED_USER",
@@ -3225,12 +3225,12 @@
3225 {
3226 "slug": "GITHUB_LIST_LABELS_FOR_AN_ISSUE",
3227 "name": "List labels for an issue",
3228 - "description": "Lists all labels for a specified issue in a GitHub repository."
3228 + "description": "Lists a page of labels for a specified issue in a GitHub repository, with pagination controls."
3229 },
3230 {
3231 "slug": "GITHUB_LIST_LABELS_FOR_A_REPOSITORY",
3232 "name": "List labels for a repository",
3233 - "description": "Retrieves all labels for a specified, existing GitHub repository."
3233 + "description": "Lists labels for a specified GitHub repository, with pagination."
3234 },
3235 {
3236 "slug": "GITHUB_LIST_LABELS_FOR_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORY",
@@ -3240,7 +3240,7 @@
3240 {
3241 "slug": "GITHUB_LIST_LABELS_FOR_ISSUES_IN_A_MILESTONE",
3242 "name": "List labels for issues in a milestone",
3243 - "description": "Lists all labels for issues within a specific milestone in a repository."
3243 + "description": "Lists a page of labels for issues within a specific milestone in a repository."
3244 },
3245 {
3246 "slug": "GITHUB_LIST_LABELS_FOR_SELF_HOSTED_RUNNER_ORG",
@@ -3260,7 +3260,7 @@
3260 {
3261 "slug": "GITHUB_LIST_MATCHING_REFERENCES",
3262 "name": "List matching references",
3263 - "description": "Lists all Git references (branches or tags) in a repository that start with the provided partial reference path (e.g., `heads/my-feature` or `tags/v1.2`)."
3263 + "description": "Lists a page of Git references, such as branches or tags, in a repository that start with the provided partial reference path."
3264 },
3265 {
3266 "slug": "GITHUB_LIST_MILESTONES",
@@ -3285,12 +3285,12 @@
3285 {
3286 "slug": "GITHUB_LIST_ORGANIZATION_EVENTS_FOR_THE_AUTHENTICATED_USER",
3287 "name": "List organization events for the authenticated user",
3288 - "description": "Lists public events in a specified GitHub organization for the authenticated user's organization dashboard. Returns activities like repository pushes, pull requests, issues, forks, and other public events within the organization. The authenticated user must be a member of the organization to see events."
3288 + "description": "Lists public events for the authenticated user's organization dashboard in a specified GitHub organization, such as pushes, pull requests, issues, and forks. The user must be an organization member to see events. Results are paginated; a 404 response is reported as an empty event list."
3289 },
3290 {
3291 "slug": "GITHUB_LIST_ORGANIZATION_MEMBERS",
3292 "name": "List organization members",
3293 - "description": "Tool to list all members of a GitHub organization. Returns a list of users who are members of the specified organization. Use this action when you need to retrieve the list of members in an organization, optionally filtered by role (admin/member) or two-factor authentication status. Organization owners can filter by 2FA status to identify members who need to enable or upgrade their 2FA methods."
3293 + "description": "List a page of members of a GitHub organization, optionally filtered by role or two-factor authentication status. Organization owners can filter by 2FA status to identify members who need to enable or upgrade their 2FA methods."
3294 },
3295 {
3296 "slug": "GITHUB_LIST_ORGANIZATION_MEMBERSHIPS_FOR_THE_AUTHENTICATED_U",
@@ -3335,17 +3335,17 @@
3335 {
3336 "slug": "GITHUB_LIST_ORGANIZATIONS_FOR_USER",
3337 "name": "List organizations for a user",
3338 - "description": "List public organization memberships for a GitHub user. This returns all organizations where the specified user is a public member. Use this action when you need to discover which organizations a user publicly belongs to."
3338 + "description": "List a page of public organization memberships for a specified GitHub user, with pagination controls."
3339 },
3340 {
3341 "slug": "GITHUB_LIST_ORGANIZATION_VARIABLES",
3342 "name": "List organization variables",
3343 - "description": "Lists all GitHub Actions variables for a specified organization."
3343 + "description": "Lists a page of GitHub Actions variables for a specified organization."
3344 },
3345 {
3346 "slug": "GITHUB_LIST_ORGANIZATION_WEBHOOKS",
3347 "name": "List organization webhooks",
3348 - "description": "Lists all webhooks for a specified GitHub organization; the organization must exist."
3348 + "description": "Lists a page of webhooks for a specified GitHub organization, with pagination controls."
3349 },
3350 {
3351 "slug": "GITHUB_LIST_ORG_FINE_GRAINED_PERMISSIONS",
@@ -3360,12 +3360,12 @@
3360 {
3361 "slug": "GITHUB_LIST_ORG_PACKAGE_VERSIONS",
3362 "name": "List package versions for an organization package",
3363 - "description": "Lists all versions for a specified package, if it exists and is owned by the given GitHub organization."
3363 + "description": "Lists a page of versions for a specified package owned by a GitHub organization, filtered by active or deleted state. Defaults to active versions."
3364 },
3365 {
3366 "slug": "GITHUB_LIST_ORG_PROJECT_VIEW_ITEMS",
3367 "name": "List organization project view items",
3368 - "description": "Tool to list items for an organization project view. Use when you need to retrieve all items from a specific view within a GitHub organization's Projects V2 project. Returns a list of project items with their content, metadata, and field values."
3368 + "description": "Lists a page of items in a specific view of a GitHub organization's Projects V2 project, with their content, metadata, and field values. Returns pagination cursors when available."
3369 },
3370 {
3371 "slug": "GITHUB_LIST_ORG_REPOS_WITH_GITHUB_ACTIONS_ENABLED",
@@ -3375,7 +3375,7 @@
3375 {
3376 "slug": "GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENS",
3377 "name": "List org resource access tokens",
3378 - "description": "Lists approved fine-grained personal access tokens (PATs) with access to resources in a GitHub organization, optionally filtering by owner, repository, permissions, or last usage time. AUTHENTICATION REQUIREMENT: This endpoint requires GitHub App authentication with 'Personal access tokens' organization permissions (read). Standard personal access tokens CANNOT use this endpoint. The GitHub App must also have access to the organization."
3378 + "description": "Lists approved fine-grained personal access tokens with access to a GitHub organization's resources, with optional filters; requires a GitHub App with read access to the organization's personal access tokens. Non-list API responses are returned as an empty token list."
3379 },
3380 {
3381 "slug": "GITHUB_LIST_ORG_RESOURCES_WITH_PERSONAL_TOKENS",
@@ -3385,7 +3385,7 @@
3385 {
3386 "slug": "GITHUB_LIST_ORG_SECRETS_WITHOUT_VALUES",
3387 "name": "List organization Dependabot secrets without values",
3388 - "description": "Lists all Dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist."
3388 + "description": "Lists a page of Dependabot secret metadata for a specified organization, including names and creation and update timestamps, without secret values."
3389 },
3390 {
3391 "slug": "GITHUB_LIST_OUTSIDE_COLLABORATORS_FOR_AN_ORGANIZATION",
@@ -3395,7 +3395,7 @@
3395 {
3396 "slug": "GITHUB_LIST_OWNED_PACKAGE_VERSIONS",
3397 "name": "List owned package versions",
3398 - "description": "Lists all versions for an existing package owned by the authenticated user, identified by its type and name."
3398 + "description": "Lists a page of versions for an existing package owned by the authenticated user, identified by its type and name. Results can be filtered by active or deleted state."
3399 },
3400 {
3401 "slug": "GITHUB_LIST_PACKAGES_FOR_AN_ORGANIZATION",
@@ -3415,17 +3415,17 @@
3415 {
3416 "slug": "GITHUB_LIST_PACKAGE_VERSIONS_FOR_A_PACKAGE_OWNED_BY_A_USER",
3417 "name": "List package versions for a package owned by a user",
3418 - "description": "Lists all versions of a public package owned by a specific GitHub user, identified by package type, package name, and username."
3418 + "description": "Lists a page of versions of a public package owned by a specified GitHub user, identified by package type, package name, and username."
3419 },
3420 {
3421 "slug": "GITHUB_LIST_PENDING_TEAM_INVITATIONS",
3422 "name": "List pending team invitations",
3423 - "description": "Lists all pending membership invitations for a specified team within an organization. The authenticated user must be an organization member with the read:org scope. The response includes invitation details such as the invitee's login/email, the role they're being invited to, and who sent the invitation. The 'role' field indicates the type of invitation: - 'direct_member': Regular organization member - 'admin': Organization administrator - 'billing_manager': Billing manager role - 'hiring_manager': Hiring manager role - 'reinstate': Reinstating a previous member Note: If the invitee is not a GitHub member, the 'login' field will be null and only the 'email' field will be populated."
3423 + "description": "Lists a page of pending membership invitations for a specified team within an organization, including invitee, role, and inviter details; total_count is the number returned on that page. The authenticated user must be an organization member with read:org scope."
3424 },
3425 {
3426 "slug": "GITHUB_LIST_PROJECT_CARDS",
3427 "name": "List project cards (Classic - Deprecated)",
3428 - "description": "Lists all project cards for a given column_id in GitHub Projects (classic). DEPRECATION NOTICE: GitHub Projects (classic) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. However, it may still work on GitHub Enterprise Server instances where classic projects are enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/ Returns a list of project cards including: id, node_id, url, note (or null for linked cards), creator info, content_url (for issue/PR cards), column_url, project_url, timestamps, and archived status."
3428 + "description": "Lists project cards in a GitHub Projects (classic) column, with archive filtering and pagination. The classic Projects REST API was sunset on April 1, 2025; the tool returns an empty card list for HTTP 404 or 410, which can also mask an unavailable or missing column."
3429 },
3430 {
3431 "slug": "GITHUB_LIST_PROJECT_COLLABORATORS",
@@ -3435,7 +3435,7 @@
3435 {
3436 "slug": "GITHUB_LIST_PROJECT_COLUMNS",
3437 "name": "List project columns",
3438 - "description": "Lists all of a GitHub project's columns (e.g., 'To Do', 'In Progress'); project_id must identify a valid, accessible project. Note: This action uses GitHub's Projects (classic) REST API. The Projects (classic) API was sunset on April 1, 2025. This action will return an empty columns list with an informative message for projects that no longer exist or when the API returns 404."
3438 + "description": "Lists a page of columns in a GitHub Projects (classic) project, such as its stages of work. A missing or unavailable project can produce an empty list. DEPRECATED: The Projects (classic) REST API has been sunset; use the newer GitHub Projects instead. Projects (classic) was removed from GitHub Enterprise Server 3.17."
3439 },
3440 {
3441 "slug": "GITHUB_LIST_PROJECT_FIELDS_FOR_USER",
@@ -3445,7 +3445,7 @@
3445 {
3446 "slug": "GITHUB_LIST_PROJECT_ITEMS_FOR_USER",
3447 "name": "List project items for user",
3448 - "description": "Tool to list items for a user-owned GitHub project. Use when you need to retrieve all items (issues, pull requests, draft issues) from a specific project belonging to a user."
3448 + "description": "Lists a page of items, including issues, pull requests and draft issues, in a user-owned GitHub project. Supports cursor pagination and filtering."
3449 },
3450 {
3451 "slug": "GITHUB_LIST_PROJECT_VIEW_ITEMS_FOR_USER",
@@ -3515,7 +3515,7 @@
3515 {
3516 "slug": "GITHUB_LIST_PULL_REQUESTS_FILES",
3517 "name": "List pull requests files",
3518 - "description": "Lists all files (including additions, modifications, and removals) associated with a specific pull request in a GitHub repository."
3518 + "description": "Lists a page of files changed in a specified GitHub pull request, including additions, modifications, and removals."
3519 },
3520 {
3521 "slug": "GITHUB_LIST_REACTIONS_FOR_A_COMMIT_COMMENT",
@@ -3540,12 +3540,12 @@
3540 {
3541 "slug": "GITHUB_LIST_REACTIONS_FOR_A_RELEASE",
3542 "name": "List reactions for a release",
3543 - "description": "Lists all reactions, or optionally filters reactions by a specific content type, for a given GitHub release."
3543 + "description": "Lists a page of reactions for a GitHub release, optionally filtered by reaction type."
3544 },
3545 {
3546 "slug": "GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSION",
3547 "name": "List reactions for a team discussion",
3548 - "description": "Lists reactions for an existing team discussion within an organization. This endpoint allows you to retrieve all reactions (emoji responses) made to a specific team discussion. You can optionally filter by reaction type. Note: OAuth app tokens and personal access tokens (classic) need the `read:discussion` scope to use this endpoint."
3548 + "description": "Lists a page of reactions for an existing team discussion within an organization, optionally filtered by reaction type. OAuth app tokens and personal access tokens (classic) need the `read:discussion` scope."
3549 },
3550 {
3551 "slug": "GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSION_COMMENT",
@@ -3560,7 +3560,7 @@
3560 {
3561 "slug": "GITHUB_LIST_RELEASES",
3562 "name": "List releases",
3563 - "description": "Retrieves a list of all releases (published, draft, and prerelease) for a specified repository."
3563 + "description": "Retrieves a page of releases for a specified repository, including published releases and available draft and prerelease versions."
3564 },
3565 {
3566 "slug": "GITHUB_LIST_REPO_ACCESS_BY_TOKEN",
@@ -3580,7 +3580,7 @@
3580 {
3581 "slug": "GITHUB_LIST_REPO_INVITATIONS_FOR_AUTH_USER",
3582 "name": "List authenticated user's repository invitations",
3583 - "description": "Lists all pending repository invitations for the authenticated user."
3583 + "description": "Lists a page of pending repository invitations for the authenticated user."
3584 },
3585 {
3586 "slug": "GITHUB_LIST_REPO_NOTIFICATIONS_FOR_AUTH_USER",
@@ -3590,7 +3590,7 @@
3590 {
3591 "slug": "GITHUB_LIST_REPO_SECRETS_WITHOUT_VALUES",
3592 "name": "List repo secrets without values",
3593 - "description": "Lists all Codespaces secrets available in a specific repository, without their encrypted values."
3593 + "description": "Lists a page of Codespaces secrets for a specified repository, without their encrypted values. Returns secret metadata and the total count."
3594 },
3595 {
3596 "slug": "GITHUB_LIST_REPOSITORIES",
@@ -3620,7 +3620,7 @@
3620 {
3621 "slug": "GITHUB_LIST_REPOSITORIES_STARRED_BY_THE_AUTHENTICATED_USER",
3622 "name": "List repositories starred by the authenticated user",
3623 - "description": "Lists repositories the authenticated user has starred, optionally sorted and paginated, including star creation timestamps via 'application/vnd.github.star+json' media type."
3623 + "description": "Lists repositories starred by the authenticated user, with sorting and pagination options."
3624 },
3625 {
3626 "slug": "GITHUB_LIST_REPOSITORIES_WATCHED_BY_A_USER",
@@ -3670,7 +3670,7 @@
3670 {
3671 "slug": "GITHUB_LIST_REPOSITORY_INVITATIONS",
3672 "name": "List repository invitations",
3673 - "description": "Retrieves all pending (unaccepted or undeclined) collaboration invitations for a specified GitHub repository."
3673 + "description": "Lists a page of pending collaboration invitations for a specified GitHub repository."
3674 },
3675 {
3676 "slug": "GITHUB_LIST_REPOSITORY_ISSUES",
@@ -3695,12 +3695,12 @@
3695 {
3696 "slug": "GITHUB_LIST_REPOSITORY_PROJECTS",
3697 "name": "List repository projects",
3698 - "description": "Lists Projects (classic) associated with a specific repository. Note: This action lists GitHub Projects (classic), which is GitHub's legacy project management feature. If the repository has Projects (classic) disabled or uses the newer Projects V2, this will return an empty list. Most modern repositories use Projects V2 (GraphQL API) instead of Projects (classic)."
3698 + "description": "Lists a page of a repository's Projects (classic), filtered by open, closed, or all states. An empty result with a message can also indicate that the repository was not found or classic projects are not enabled. DEPRECATED: The classic Projects REST API has been sunset; use GitHub Projects V2 instead."
3699 },
3700 {
3701 "slug": "GITHUB_LIST_REPOSITORY_RULESETS",
3702 "name": "Get all repository rulesets",
3703 - "description": "Retrieves all rulesets for a GitHub repository, which define conditions and actions for repository interactions (e.g., branch protections)."
3703 + "description": "Retrieves a page of rulesets for a GitHub repository, including parent rulesets by default. Rulesets define conditions and actions for repository interactions such as branch protection."
3704 },
3705 {
3706 "slug": "GITHUB_LIST_REPOSITORY_RULE_SUITES",
@@ -3710,17 +3710,17 @@
3710 {
3711 "slug": "GITHUB_LIST_REPOSITORY_SECRETS",
3712 "name": "List repository secrets",
3713 - "description": "Lists metadata for all secrets in a GitHub repository, excluding their encrypted values."
3713 + "description": "Lists a page of metadata for GitHub Actions secrets in a repository, including names and timestamps but not secret values."
3714 },
3715 {
3716 "slug": "GITHUB_LIST_REPOSITORY_SECRETS_WITHOUT_DECRYPTING",
3717 "name": "List repository secrets without decrypting",
3718 - "description": "Lists metadata (e.g., name, creation/update dates) for all Dependabot secrets in a repository; secret values are not included."
3718 + "description": "Lists a page of metadata for Dependabot secrets in a repository, including names and creation and update dates; secret values are not included."
3719 },
3720 {
3721 "slug": "GITHUB_LIST_REPOSITORY_SECURITY_ADVISORIES",
3722 "name": "List repository security advisories",
3723 - "description": "Tool to list security advisories for a repository. Use when you need to retrieve security advisories published for a specific repository, optionally filtered by state."
3723 + "description": "Lists repository security advisories, optionally filtered by state and sorted or paginated."
3724 },
3725 {
3726 "slug": "GITHUB_LIST_REPOSITORY_TAGS",
@@ -3730,7 +3730,7 @@
3730 {
3731 "slug": "GITHUB_LIST_REPOSITORY_TEAMS",
3732 "name": "List repository teams",
3733 - "description": "Lists all teams with explicit permission to access the specified repository; the repository must exist."
3733 + "description": "Lists a page of teams with explicit permission to access the specified repository; the repository must exist."
3734 },
3735 {
3736 "slug": "GITHUB_LIST_REPOSITORY_TOPICS",
@@ -3750,7 +3750,7 @@
3750 {
3751 "slug": "GITHUB_LIST_REPOSITORY_WORKFLOWS",
3752 "name": "List repository workflows",
3753 - "description": "Lists all GitHub Actions workflows for a specified repository, which must exist and be accessible."
3753 + "description": "Lists a page of GitHub Actions workflows for a specified repository, which must exist and be accessible. The response includes the total workflow count."
3754 },
3755 {
3756 "slug": "GITHUB_LIST_REQUESTED_REVIEWERS_FOR_A_PULL_REQUEST",
@@ -3760,12 +3760,12 @@
3760 {
3761 "slug": "GITHUB_LIST_REVIEW_COMMENTS_IN_A_REPOSITORY",
3762 "name": "List review comments in a repository",
3763 - "description": "Lists all review comments on all pull requests within a specified repository."
3763 + "description": "Lists a page of pull request review comments across a specified repository, with sorting and pagination options."
3764 },
3765 {
3766 "slug": "GITHUB_LIST_REVIEW_COMMENTS_ON_A_PULL_REQUEST",
3767 "name": "List review comments on a pull request",
3768 - "description": "Lists all review comments on a specific pull request within a GitHub repository."
3768 + "description": "Lists a page of review comments on a specific pull request within a GitHub repository, with sorting and pagination options."
3769 },
3770 {
3771 "slug": "GITHUB_LIST_REVIEWS_FOR_A_PULL_REQUEST",
@@ -3805,7 +3805,7 @@
3805 {
3806 "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRET",
3807 "name": "List selected repositories for a Codespaces organization secret",
3808 - "description": "Lists repositories that have been granted access to a Codespaces organization secret. Returns all repositories that have been selected when the visibility for repository access to a Codespaces secret is set to 'selected'. Requires admin:org scope and admin access to the organization. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections."
3808 + "description": "Lists a page of repositories selected to access a Codespaces organization secret whose visibility is set to 'selected'. Requires admin:org scope and admin access to the organization."
3809 },
3810 {
3811 "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_A_USER_SECRET",
@@ -3830,7 +3830,7 @@
3830 {
3831 "slug": "GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_A_REPOSITORY",
3832 "name": "List self hosted runners for a repository",
3833 - "description": "Lists all self-hosted runners configured for a repository."
3833 + "description": "Lists self-hosted runners configured for a repository, with optional runner-name filtering and pagination."
3834 },
3835 {
3836 "slug": "GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_A_USER",
@@ -3840,7 +3840,7 @@
3840 {
3841 "slug": "GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER",
3842 "name": "List social accounts for the authenticated user",
3843 - "description": "Lists all social media accounts linked to the authenticated user's GitHub profile. This action retrieves the social media accounts associated with the user's GitHub profile, allowing for easy management and visibility of connected accounts. The results include accounts such as Twitter, LinkedIn, and other platforms linked to the GitHub profile."
3843 + "description": "Lists a page of social media accounts linked to the authenticated user's GitHub profile, including links to platforms such as Twitter and LinkedIn."
3844 },
3845 {
3846 "slug": "GITHUB_LIST_SPONSORABLES",
@@ -3860,17 +3860,17 @@
3860 {
3861 "slug": "GITHUB_LIST_STARRED_GISTS",
3862 "name": "List starred gists",
3863 - "description": "Retrieves a list of gists starred by the authenticated user."
3863 + "description": "Lists gists starred by the authenticated GitHub user. Optionally filter to gists updated after a specified time and select a page of results, with up to 100 results per page."
3864 },
3865 {
3866 "slug": "GITHUB_LIST_STARRED_REPOSITORIES_FOR_USER",
3867 "name": "List starred repositories for user",
3868 - "description": "Lists public repositories that a user has starred. The list includes all public repositories starred by the specified user, sorted by when they were starred or last updated. Use this action when you need to retrieve the list of repositories a specific GitHub user has starred."
3868 + "description": "Lists a page of public repositories starred by a specified GitHub user, sorted by when they were starred or last updated. Supports pagination and sort direction."
3869 },
3870 {
3871 "slug": "GITHUB_LIST_STATUS_CHECK_CONTEXTS",
3872 "name": "Get all status check contexts",
3873 - "description": "Fetches all required status check contexts for a protected branch; returns an empty list if the branch isn't protected or has no required checks."
3873 + "description": "Fetches required status check contexts for a branch. Returns an empty list for 404 responses other than an explicit branch-not-found message, so an empty result does not necessarily establish that checks are absent."
3874 },
3875 {
3876 "slug": "GITHUB_LIST_SUB_ISSUES",
@@ -3890,7 +3890,7 @@
3890 {
3891 "slug": "GITHUB_LIST_TAG_PROTECTION_STATES_FOR_A_REPOSITORY",
3892 "name": "List tag protection states for a repository",
3893 - "description": "DEPRECATED: Lists tag protection rules for a repository. This API was sunset on August 30, 2024. Use GITHUB_GET_ALL_REPOSITORY_RULESETS instead to view tag protection rules via repository rulesets."
3893 + "description": "Lists a repository's legacy tag protection rules, including the patterns used to identify protected tags. DEPRECATED: GitHub sunset the tag protection API on GitHub.com and says it returns null data; use GITHUB_GET_ALL_REPOSITORY_RULESETS to view tag protection through repository rulesets instead."
3894 },
3895 {
3896 "slug": "GITHUB_LIST_TEAM_MEMBERS",
@@ -3920,7 +3920,7 @@
3920 {
3921 "slug": "GITHUB_LIST_TEAMS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLE",
3922 "name": "List teams assigned to an organization role",
3923 - "description": "Lists teams assigned to a specific role within a GitHub organization. This endpoint requires organization administrator privileges. Use this to audit which teams have been granted specific organization-level permissions through roles. Note: Organization roles is a feature for enterprise-level GitHub organizations."
3923 + "description": "Lists a page of teams assigned to a specific role in a GitHub organization, helping administrators audit role assignments. Requires organization administrator privileges; page size can be set from 1 to 100."
3924 },
3925 {
3926 "slug": "GITHUB_LIST_THE_PEOPLE_A_USER_FOLLOWS",
@@ -3940,17 +3940,17 @@
3940 {
3941 "slug": "GITHUB_LIST_TOKEN_ACCESS_REPOSITORIES",
3942 "name": "List token access repositories",
3943 - "description": "Lists repositories in an organization that a fine-grained personal access token has access to. Requires organization admin permissions or 'Personal access tokens' organization read permission. Only GitHub Apps can use this endpoint."
3943 + "description": "Lists a page of repositories in an organization accessible to a specified fine-grained personal access token, for auditing its repository access. The caller must be an organization owner or have the Personal access tokens organization permission; the endpoint is for GitHub Apps."
3944 },
3945 {
3946 "slug": "GITHUB_LIST_USER_PROJECTS",
3947 "name": "List user projects",
3948 - "description": "Retrieves a list of projects for a specified GitHub user, optionally filtering by state and supporting pagination; the username must be a valid GitHub handle. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub."
3948 + "description": "Lists Projects V2 for a specified GitHub user using GraphQL, with page-based pagination and optional state filtering. State filtering is applied after fetching the page, so a page may contain fewer matching projects than requested."
3949 },
3950 {
3951 "slug": "GITHUB_LIST_USERS",
3952 "name": "List users",
3953 - "description": "Retrieves all GitHub users (individuals and organizations) in chronological order of their sign-up date."
3953 + "description": "Lists a page of GitHub users, including individuals and organizations, in chronological order of sign-up. Supports pagination by starting user ID and results per page."
3954 },
3955 {
3956 "slug": "GITHUB_LIST_USERS_BLOCKED_BY_AN_ORGANIZATION",
@@ -3995,17 +3995,17 @@
3995 {
3996 "slug": "GITHUB_LOOKUP_ENTERPRISE_ADMINISTRATOR_INVITATION",
3997 "name": "Lookup Enterprise Administrator Invitation",
3998 - "description": "Tool to look up a pending enterprise administrator invitation by invitee, enterprise, and role. Use when you need to check if a specific user has a pending invitation to become an enterprise administrator."
3998 + "description": "Look up a pending enterprise administrator invitation by invitee login, enterprise slug, and role. An empty result can indicate either no invitation was returned or a GraphQL resolution or not-found error."
3999 },
4000 {
4001 "slug": "GITHUB_LOOKUP_GITHUB_RESOURCE",
4002 "name": "Lookup GitHub Resource",
4003 - "description": "Tool to lookup a GitHub resource by its URL. Use when you need to identify or retrieve information about a GitHub resource from its URL."
4003 + "description": "Look up a GitHub resource by URL and return its GraphQL type and URL."
4004 },
4005 {
4006 "slug": "GITHUB_LOOKUP_NODES_BY_IDS",
4007 "name": "Lookup nodes by IDs",
4008 - "description": "Tool to lookup GitHub nodes by their global node IDs. Use when you need to retrieve multiple objects by their IDs in a single batch query."
4008 + "description": "Look up multiple GitHub nodes by their global node IDs in a single GraphQL query, returning each node's ID and type."
4009 },
4010 {
4011 "slug": "GITHUB_LOOKUP_ORGANIZATION_GRAPH_QL",
@@ -4035,7 +4035,7 @@
4035 {
4036 "slug": "GITHUB_MANAGE_SECRETS_IN_SELECTED_REPOSITORIES",
4037 "name": "List selected repositories for a GitHub Actions organization secret",
4038 - "description": "Lists repositories within an organization that have been explicitly granted access to a specific GitHub Actions organization secret. Returns all repositories that have been selected when the visibility for repository access to an Actions secret is set to 'selected'. Requires admin:org scope and admin access to the organization. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections."
4038 + "description": "Lists a page of repositories explicitly selected to access a GitHub Actions organization secret. The secret's visibility must be set to 'selected'; organization admin access and appropriate authorization are required."
4039 },
4040 {
4041 "slug": "GITHUB_MAP_A_COMMIT_AUTHOR",
@@ -4085,12 +4085,12 @@
4085 {
4086 "slug": "GITHUB_MOVE_A_PROJECT_COLUMN",
4087 "name": "Move a project column (Classic - Deprecated)",
4088 - "description": "Moves a column within a GitHub project (classic) to a new position. DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. The `position` parameter can be: - 'first': Move the column to the beginning of the project - 'last': Move the column to the end of the project - 'after:<column_id>': Place the column after the specified column (e.g., 'after:67890') See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/"
4088 + "description": "Moves a column within a GitHub Classic Project to the first or last position, or after a specified column. DEPRECATED: The Classic Projects REST API has been sunset and this action no longer works on GitHub.com. Use GitHub Projects V2 with the GraphQL API for new projects."
4089 },
4090 {
4091 "slug": "GITHUB_PING_AN_ORGANIZATION_WEBHOOK",
4092 "name": "Ping an organization webhook",
4093 - "description": "Sends a 'ping' event to a specified, existing organization webhook to test its configuration and ensure it correctly receives events."
4093 + "description": "Sends a ping event to a specified existing organization webhook to test its configuration. A successful request queues the event; it does not confirm delivery."
4094 },
4095 {
4096 "slug": "GITHUB_PING_A_REPOSITORY_WEBHOOK",
@@ -4160,12 +4160,12 @@
4160 {
4161 "slug": "GITHUB_REMOVE_APP_ACCESS_RESTRICTIONS",
4162 "name": "Remove app access restrictions",
4163 - "description": "Removes all GitHub App access restrictions from a protected branch in a repository; the branch must have protection rules configured, and this action does not alter user or team restrictions."
4163 + "description": "Removes all GitHub App access restrictions from a protected branch without altering user or team restrictions. A 404 is returned as an empty app list with an explanatory message rather than an exception."
4164 },
4165 {
4166 "slug": "GITHUB_REMOVE_A_PROJECT_FROM_A_TEAM",
4167 "name": "Remove a project from a team",
4168 - "description": "Removes a project from a team within an organization; this action requires the project to be currently associated with the team."
4168 + "description": "Removes a classic project from a team within an organization."
4169 },
4170 {
4171 "slug": "GITHUB_REMOVE_A_REPOSITORY_COLLABORATOR",
@@ -4220,7 +4220,7 @@
4220 {
4221 "slug": "GITHUB_REMOVE_ORG_DEV_ENV_SECRET_BY_NAME",
4222 "name": "Remove org dev env secret by name",
4223 - "description": "Deletes a GitHub Codespaces secret from an organization by its name; this operation is idempotent."
4223 + "description": "Deletes a named GitHub Codespaces secret from an organization. A not-found response is treated as success, so success does not necessarily confirm that a secret was deleted."
4224 },
4225 {
4226 "slug": "GITHUB_REMOVE_ORG_SECRET_BY_NAME",
@@ -4305,7 +4305,7 @@
4305 {
4306 "slug": "GITHUB_REMOVE_USER_AS_A_COLLABORATOR",
4307 "name": "Remove user as a collaborator (classic project)",
4308 - "description": "Removes a user as a collaborator from an organization project (classic). IMPORTANT: This action uses the Projects (classic) REST API which is being deprecated. The Projects (classic) feature was sunset on GitHub.com. This API may still work on GitHub Enterprise Server versions before 3.17. Requirements: - You must be an organization owner or a project admin to remove a collaborator - The user must already be a collaborator on the specified project - The project must be an organization project (classic), not a Projects V2 project For GitHub.com users: Consider using GitHub Projects V2 instead, which can be managed through the GraphQL API."
4308 + "description": "Removes a user as a collaborator from an organization project (classic); a success result can also indicate that the user was already absent. The Projects (classic) REST API is sunset on GitHub.com and may still work on GitHub Enterprise Server versions before 3.17."
4309 },
4310 {
4311 "slug": "GITHUB_REMOVE_USERS_CODESPACES_ACCESS_ORG",
@@ -4450,7 +4450,7 @@
4450 {
4451 "slug": "GITHUB_REVIEW_RESOURCE_REQUESTS_WITH_FINE_GRAINED_TOKENS",
4452 "name": "Review PAT Requests in Bulk",
4453 - "description": "Approves or denies multiple fine-grained personal access token requests for an organization in bulk. This endpoint processes multiple PAT request approvals or denials in a single API call. All specified pat_request_ids must refer to currently pending requests. Important: This endpoint can ONLY be called by GitHub Apps with the 'organization_personal_access_token_requests:write' permission. It cannot be called with personal access tokens or OAuth apps. On success, returns HTTP 202 Accepted with an empty body."
4453 + "description": "Submits a bulk approval or denial of fine-grained personal access token requests for a GitHub organization. The returned success message indicates acceptance for processing, not confirmation that every request has been processed."
4454 },
4455 {
4456 "slug": "GITHUB_REVOKE_AN_INSTALLATION_ACCESS_TOKEN",
@@ -4465,7 +4465,7 @@
4465 {
4466 "slug": "GITHUB_RUN_GRAPH_QL_RELAY_QUERY",
4467 "name": "Run GraphQL Relay Query",
4468 - "description": "Tool to run a GitHub GraphQL relay query. The relay field is a workaround for re-exposing the root query object. Use when you need to access root query fields through the relay context."
4468 + "description": "Runs a supplied GitHub GraphQL query or mutation, including queries that access root fields through the relay context. The response may include GraphQL errors alongside data."
4469 },
4470 {
4471 "slug": "GITHUB_SEARCH_CODE",
@@ -4475,7 +4475,7 @@
4475 {
4476 "slug": "GITHUB_SEARCH_CODE_ALL_PAGES",
4477 "name": "Search code (all pages)",
4478 - "description": "Tool to search code across multiple pages using GitHub's code search API. Use when single-page searches may miss matches and you need a full or capped result set. GitHub caps results at ~1,000 total items regardless of pagination; results for broad queries may be silently truncated. Only the default branch is indexed, and very large files may be excluded — treat results as potentially partial. Rate limit: ~30 requests/minute; honor `Retry-After` on 403/429 responses."
4478 + "description": "Searches GitHub code across multiple pages, optionally capped by a result limit; results may be partial, including because of GitHub's approximately 1,000-result cap and default-branch indexing. Queries combining parentheses with AND, OR, or NOT are rejected by the tool."
4479 },
4480 {
4481 "slug": "GITHUB_SEARCH_COMMITS",
@@ -4485,7 +4485,7 @@
4485 {
4486 "slug": "GITHUB_SEARCH_COMMITS_BY_AUTHOR",
4487 "name": "Search commits by author across repos",
4488 - "description": "Searches commits across GitHub using the Search API (e.g., by author/email/org/date range) without per-repo scanning. Use when you need to find commits by author, committer email, organization, or date ranges across multiple repositories. This avoids the need to list commits per repository and prevents 409 errors on empty repos."
4488 + "description": "Searches commits across GitHub repositories using keywords and qualifiers such as author, committer email, organization, or date range. Results can be sorted by author or committer date and returned in pages of up to 100 commits."
4489 },
4490 {
4491 "slug": "GITHUB_SEARCH_GITHUB_GRAPHQL",
@@ -4495,12 +4495,12 @@
4495 {
4496 "slug": "GITHUB_SEARCH_ISSUES",
4497 "name": "Search issues and pull requests",
4498 - "description": "Searches GitHub issues and pull requests using a flexible query with qualifiers, sorting, and pagination. Use this action when you need to find issues or pull requests across repositories using search criteria like author, labels, state, milestone, or date ranges. This action searches across all repositories accessible to the authenticated user unless constrained by qualifiers like repo:, user:, or org:."
4498 + "description": "Searches GitHub issues and pull requests using keywords and qualifiers, with sorting and pagination. Results are limited to accessible repositories and may be incomplete or subject to GitHub search limits."
4499 },
4500 {
4501 "slug": "GITHUB_SEARCH_ISSUES_AND_PULL_REQUESTS",
4502 "name": "Search issues and pull requests",
4503 - "description": "Searches GitHub for issues and pull requests. Supports keywords, qualifiers (repo:, org:, user:, state:, label:, author:, assignee:, mentions:, etc.), and type filters (is:issue, is:pr). Type filters cannot be used alone - they must be combined with at least one keyword or other qualifier. All other qualifiers work independently. The @me shorthand (e.g., assignee:@me, mentions:@me) is automatically resolved to your username. Logical operators (AND, OR, NOT) are supported but limited to a maximum of 5 operators total per query."
4503 + "description": "Searches GitHub for issues and pull requests using keywords and qualifiers, with sorting and pagination. Standalone issue or pull request type filters must be combined with another term; @me is resolved by GitHub."
4504 },
4505 {
4506 "slug": "GITHUB_SEARCH_LABELS",
@@ -4530,7 +4530,7 @@
4530 {
4531 "slug": "GITHUB_SET_APP_ACCESS_RESTRICTIONS",
4532 "name": "Set app access restrictions",
4533 - "description": "Replaces the list of GitHub Apps permitted to push to a protected branch. This action completely replaces the existing list of apps with push access - it does not add to or merge with the current list. Requirements: - The branch must already have protection rules enabled with push restrictions configured - Apps must be installed on the repository and have 'contents' write permission - Push restrictions are only available for organization-owned repositories with GitHub Team or Enterprise Cloud plans"
4533 + "description": "Replaces the list of GitHub Apps permitted to push to a protected branch; the branch must have push restrictions configured, and apps must be installed with contents write permission on an eligible organization repository. A 404 returns an empty app list with an explanatory message."
4534 },
4535 {
4536 "slug": "GITHUB_SET_A_REPOSITORY_SUBSCRIPTION",
@@ -4645,7 +4645,7 @@
4645 {
4646 "slug": "GITHUB_SET_USER_INTERACTION_LIMIT_GRAPH_QL",
4647 "name": "Set User Interaction Limit (GraphQL)",
4648 - "description": "Tool to set interaction limits on a user's public repositories using GraphQL. Use when you need to temporarily restrict who can comment, open issues, or create pull requests. Limits apply to the authenticated user or a specified user."
4648 + "description": "Set interaction limits on a specified user's public repositories using GraphQL, temporarily restricting who can comment, open issues, or create pull requests."
4649 },
4650 {
4651 "slug": "GITHUB_SET_WORKFLOW_EXTERNAL_ACCESS",
@@ -4705,7 +4705,7 @@
4705 {
4706 "slug": "GITHUB_UNBLOCK_USER_FROM_ORGANIZATION",
4707 "name": "Unblock a user from an organization",
4708 - "description": "Unblocks a user from an organization, allowing renewed interaction with its resources, provided the user is currently blocked (otherwise, a 404 error may occur)."
4708 + "description": "Unblocks a user from a specified organization. A 404 response is returned as an unsuccessful result indicating that the user was not blocked or the organization or user was not found."
4709 },
4710 {
4711 "slug": "GITHUB_UNFOLLOW_A_USER",
@@ -4800,7 +4800,7 @@
4800 {
4801 "slug": "GITHUB_UPDATE_A_MILESTONE",
4802 "name": "Update a milestone",
4803 - "description": "Updates a milestone in a repository, identified by `owner`, `repo`, and `milestone_number`, by allowing modification of its `title`, `state`, `description`, or `due_on`; at least one of these four attributes must be provided to perform an update."
4803 + "description": "Updates a repository milestone identified by owner, repository, and milestone number. It can modify the title, state, description, or due date; if state is omitted, it is sent as open."
4804 },
4805 {
4806 "slug": "GITHUB_UPDATE_AN_ENVIRONMENT_VARIABLE",
@@ -4810,7 +4810,7 @@
4810 {
4811 "slug": "GITHUB_UPDATE_AN_ISSUE",
4812 "name": "Update an issue",
4813 - "description": "Updates an existing GitHub issue's title, body, state, milestone, labels, or assignees; `state_reason` is only processed if `state` also changes, and use `null` or `[]` to clear applicable fields."
4813 + "description": "Updates an existing GitHub issue's title, body, state, milestone, labels, or assignees. Empty lists can clear labels or assignees; null values are omitted from the update."
4814 },
4815 {
4816 "slug": "GITHUB_UPDATE_AN_ISSUE_COMMENT",
@@ -4820,7 +4820,7 @@
4820 {
4821 "slug": "GITHUB_UPDATE_AN_ORGANIZATION",
4822 "name": "Update an organization",
4823 - "description": "Updates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions."
4823 + "description": "Updates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions. Omitted repository-permission, repository-creation, Pages, private-forking, and web-commit signoff settings are sent with the tool's defaults and may change existing settings."
4824 },
4825 {
4826 "slug": "GITHUB_UPDATE_AN_ORGANIZATION_VARIABLE",
@@ -4830,7 +4830,7 @@
4830 {
4831 "slug": "GITHUB_UPDATE_AN_ORGANIZATION_WEBHOOK",
4832 "name": "Update an organization webhook",
4833 - "description": "Updates the configuration (URL, content type, secret, SSL verification), subscribed events, active status, or name of an existing webhook for a specified organization."
4833 + "description": "Updates an existing organization's webhook configuration, subscribed events, active status, or name. If active status is omitted, the request enables the webhook."
4834 },
4835 {
4836 "slug": "GITHUB_UPDATE_A_PROJECT",
@@ -4845,7 +4845,7 @@
4845 {
4846 "slug": "GITHUB_UPDATE_A_PULL_REQUEST_BRANCH",
4847 "name": "Update a pull request branch",
4848 - "description": "Updates an open pull request's head branch by merging the latest changes from its base branch, if mergeable and repository merging is enabled; operates asynchronously."
4848 + "description": "Requests an asynchronous update of an open pull request's head branch by merging its base branch, if mergeable and repository merging is enabled. The result may instead report merge conflicts, an already up-to-date branch, or an expected head SHA mismatch."
4849 },
4850 {
4851 "slug": "GITHUB_UPDATE_A_REFERENCE",
@@ -4885,7 +4885,7 @@
4885 {
4886 "slug": "GITHUB_UPDATE_A_REPOSITORY_WEBHOOK",
4887 "name": "Update a repository webhook",
4888 - "description": "Updates the URL, content type, secret, SSL verification, events, or active status for an existing repository webhook, specified by `owner`, `repo`, and `hook_id`."
4888 + "description": "Updates the URL, content type, secret, SSL verification, events, or active status of an existing repository webhook. The active status defaults to true when omitted."
4889 },
4890 {
4891 "slug": "GITHUB_UPDATE_A_TEAM",
@@ -4895,7 +4895,7 @@
4895 {
4896 "slug": "GITHUB_UPDATE_BRANCH_PROTECTION",
4897 "name": "Update branch protection",
4898 - "description": "Updates the protection settings for an existing branch in a repository, which must not contain wildcard characters."
4898 + "description": "Updates branch protection settings for a specific existing repository branch; wildcard branch names are not supported. Unspecified status checks, admin enforcement, pull request reviews, and push restrictions are sent as null and may be disabled; unspecified user, team, or app lists within supplied push restrictions are sent empty."
4899 },
4900 {
4901 "slug": "GITHUB_UPDATE_CODE_SCANNING_DEFAULT_SETUP",
@@ -4945,7 +4945,7 @@
4945 {
4946 "slug": "GITHUB_UPDATE_PULL_REQUEST_REVIEW_PROTECTION",
4947 "name": "Update pull request review protection",
4948 - "description": "Updates pull request review protection settings (e.g., required approvals, review dismissal, bypass allowances) for a branch; branch protection features must be available for the repository."
4948 + "description": "Updates pull request review protection settings for a branch, including required approvals, review dismissal, and bypass allowances. The last-push approval setting defaults to false and is sent even when omitted; branch protection features must be available for the repository."
4949 },
4950 {
4951 "slug": "GITHUB_UPDATE_REPOSITORY_PREFERENCES_FOR_CHECK_SUITES",
@@ -4980,7 +4980,7 @@
4980 {
4981 "slug": "GITHUB_UPDATE_TOKEN_ORG_ACCESS",
4982 "name": "Revoke Token Organization Access",
4983 - "description": "Revokes a fine-grained personal access token's access to an organization. IMPORTANT: This endpoint can ONLY be called by GitHub Apps with 'Personal access tokens' organization permissions (write). Personal access tokens (PATs) cannot use this endpoint. Use GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENS to get valid pat_id values for tokens that have access to your organization."
4983 + "description": "Revokes a fine-grained personal access token's access to a specified GitHub organization. This operation requires a GitHub App with the organization's 'Personal access tokens' write permission; personal access tokens cannot call it. List the organization's resource access tokens to find the token ID."
4984 },
4985 {
4986 "slug": "GITHUB_UPDATE_USER_LIST",
@@ -5020,7 +5020,7 @@
5020 {
5021 "slug": "GITHUB_VALIDATE_CREDENTIAL",
5022 "name": "Validate credential",
5023 - "description": "Validates GitHub API credentials by checking if they can successfully authenticate. Use this action when you need to verify that API credentials are valid and have not expired or been revoked. Returns whether the credentials are valid along with the authenticated user's username."
5023 + "description": "Checks GitHub credentials using the authenticated-user endpoint and returns a validity flag and username when available. A 403 also returns valid=false and may indicate rate limiting or insufficient permissions rather than invalid credentials."
5024 },
5025 {
5026 "slug": "GITHUB_VERIFY_DEV_CONTAINER_PERMISSIONS_ACCEPTED",
@@ -5330,7 +5330,7 @@
5330 ],
5331 "toolCount": 50,
5332 "triggerCount": 7,
5333 - "version": "20261010_00",
5333 + "version": "20261103_00",
5334 "tools": [
5335 {
5336 "slug": "GOOGLECALENDAR_ACL_DELETE",
@@ -5355,7 +5355,7 @@
5355 {
5356 "slug": "GOOGLECALENDAR_ACL_PATCH",
5357 "name": "Patch ACL Rule",
5358 - "description": "Updates an existing access control rule for a calendar using patch semantics (partial update). This allows modifying specific fields without affecting other properties. IMPORTANT: The ACL rule must already exist on the calendar. This action cannot create new rules. If you receive a 404 Not Found error, the rule does not exist - use ACL insert to create it first, or use ACL list to verify available rules. Each patch request consumes three quota units. For domain-type ACL rules, if PATCH fails with 500 error, this action will automatically fallback to UPDATE method."
5358 + "description": "Partially updates the role or scope of an existing Google Calendar access control rule. Provide at least one of role or scope; you can also choose whether to send sharing notifications. This operation modifies an existing rule rather than creating one."
5359 },
5360 {
5361 "slug": "GOOGLECALENDAR_ACL_UPDATE",
@@ -5375,7 +5375,7 @@
5375 {
5376 "slug": "GOOGLECALENDAR_CALENDAR_LIST_DELETE",
5377 "name": "Remove Calendar from List",
5378 - "description": "Tool to remove a calendar from the user's calendar list. Use when you need to unsubscribe from or hide a calendar from the user's list."
5378 + "description": "Removes a calendar from the user's calendar list, unsubscribing from it without deleting the calendar itself."
5379 },
5380 {
5381 "slug": "GOOGLECALENDAR_CALENDAR_LIST_GET",
@@ -5385,7 +5385,7 @@
5385 {
5386 "slug": "GOOGLECALENDAR_CALENDAR_LIST_INSERT",
5387 "name": "Insert Calendar into List",
5388 - "description": "Inserts an existing calendar into the user's calendar list, making it visible in the UI. Calendars (e.g., newly created ones) won't appear in the list or UI until explicitly inserted."
5388 + "description": "Inserts an existing calendar into the user's calendar list, with optional display settings. The primary keyword is not accepted; provide the actual calendar ID."
5389 },
5390 {
5391 "slug": "GOOGLECALENDAR_CALENDAR_LIST_PATCH",
@@ -5400,7 +5400,7 @@
5400 {
5401 "slug": "GOOGLECALENDAR_CALENDAR_LIST_WATCH",
5402 "name": "Watch Calendar List",
5403 - "description": "Watch for changes to CalendarList resources using push notifications. Use this to receive real-time updates when calendar list entries are modified."
5403 + "description": "Creates a push-notification channel for changes to the user's calendar list. Notifications signal changes rather than providing full change details, and delivery is not completely reliable."
5404 },
5405 {
5406 "slug": "GOOGLECALENDAR_CALENDARS_DELETE",
@@ -5435,7 +5435,7 @@
5435 {
5436 "slug": "GOOGLECALENDAR_CREATE_EVENT",
5437 "name": "Create Event",
5438 - "description": "Creates a timed event using start_datetime and either end_datetime or duration fields, or an all-day event using an inclusive start_date and exclusive end_date. send_updates defaults to \"all\", which emails all attendees; choose \"externalOnly\" or \"none\" to control notifications. The organizer is added as an attendee unless exclude_organizer is true, and a Google Meet link is requested by default. No conflict checking is performed; use GOOGLECALENDAR_FREE_BUSY_QUERY first when conflicts matter. Returns the created event under response_data."
5438 + "description": "Creates a timed or all-day Google Calendar event and returns it under response_data, without conflict checking. send_updates defaults to \"all\", which emails all attendees; for eligible event types, the organizer is added unless excluded and a Google Meet link is requested by default."
5439 },
5440 {
5441 "slug": "GOOGLECALENDAR_DELETE_EVENT",
@@ -5470,12 +5470,12 @@
5470 {
5471 "slug": "GOOGLECALENDAR_EVENTS_LIST_ALL_CALENDARS",
5472 "name": "List Events from All Calendars",
5473 - "description": "Return a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars. An inverted or incorrect time range silently returns empty results rather than an error. An empty `items` list means no events matched the filters—adjust `time_min`, `time_max`, or `q` before concluding no events exist."
5473 + "description": "Lists and deduplicates events across selected calendars or the user's calendar list for a time range. Returns a compact summary by default, with full event details available on request; per-calendar errors can make results incomplete."
5474 },
5475 {
5476 "slug": "GOOGLECALENDAR_EVENTS_MOVE",
5477 "name": "Move Event",
5478 - "description": "Moves an event to another calendar, i.e., changes an event's organizer."
5478 + "description": "Moves a default event to another calendar, changing its organizer. Other event types cannot be moved."
5479 },
5480 {
5481 "slug": "GOOGLECALENDAR_EVENTS_WATCH",
@@ -5485,12 +5485,12 @@
5485 {
5486 "slug": "GOOGLECALENDAR_FIND_EVENT",
5487 "name": "Find event",
5488 - "description": "Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types. Ensure `timeMin` is not chronologically after `timeMax` if both are provided. Results may span multiple pages; always follow `nextPageToken` until absent to avoid silently missing events. Validate the correct match from results by checking summary, start.dateTime, and organizer.email before using event_id for mutations. An empty `items` array means no events matched — widen filters rather than treating it as an error."
5488 + "description": "Finds events in a specified Google Calendar using text, time ranges, and event types. Results are returned in event_data.event_data and may span multiple pages; follow nextPageToken even when a page is empty."
5489 },
5490 {
5491 "slug": "GOOGLECALENDAR_FIND_FREE_SLOTS",
5492 "name": "Find free slots",
5493 - "description": "Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range. If `time_min` is not provided, defaults to the current timestamp in the specified timezone. If `time_max` is not provided, defaults to 23:59:59 of the day specified in `time_min` (if provided), otherwise defaults to 23:59:59 of the current day in the specified timezone. Returns busy intervals and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods. Returned free slots are unfiltered by duration; callers must filter intervals to those fully containing the required meeting length. No event metadata (titles, descriptions, links) is returned; use GOOGLECALENDAR_EVENTS_LIST for event details."
5493 + "description": "Queries busy intervals and calculates free gaps for specified calendars, without filtering by meeting duration; the range is limited to 89 days, and calendar errors produce empty free slots marked unreliable. Omitted start defaults to now, and omitted end to 23:59:59 on the applicable day in the specified timezone."
5494 },
5495 {
5496 "slug": "GOOGLECALENDAR_FREE_BUSY_QUERY",
@@ -5520,7 +5520,7 @@
5520 {
5521 "slug": "GOOGLECALENDAR_LIST_BUILDINGS",
5522 "name": "List Buildings",
5523 - "description": "Lists all buildings for a Google Workspace customer account with full details including addresses, coordinates, and floor names. Use this action when you need to retrieve the complete list of physical building locations configured in Google Workspace Calendar resources. This is useful for workspace administrators managing conference room and resource scheduling across multiple office buildings. Requires Google Workspace administrator privileges with Directory API access."
5523 + "description": "Lists a page of buildings for a Google Workspace customer, including available addresses, coordinates, and floor names. Use the continuation token for further pages; Directory API access and appropriate administrator privileges are required."
5524 },
5525 {
5526 "slug": "GOOGLECALENDAR_LIST_CALENDAR_RESOURCES",
@@ -5565,7 +5565,7 @@
5565 {
5566 "slug": "GOOGLECALENDAR_SETTINGS_LIST",
5567 "name": "List Settings",
5568 - "description": "Returns all user settings for the authenticated user. Results include multiple settings keyed by id (e.g., `timeZone`); locate a specific setting by its `id` field. `timeZone` values are IANA identifiers (e.g., `America/New_York`) — use directly in datetime and event logic; align with `timeZone` from GOOGLECALENDAR_GET_CALENDAR for consistent notification times."
5568 + "description": "Lists the authenticated user's calendar settings, returning a page of settings identified by their id fields. Supports pagination and incremental synchronization using a sync token."
5569 },
5570 {
5571 "slug": "GOOGLECALENDAR_SETTINGS_WATCH",
@@ -5575,12 +5575,12 @@
5575 {
5576 "slug": "GOOGLECALENDAR_SYNC_EVENTS",
5577 "name": "Sync Events (Deprecated)",
5578 - "description": "DEPRECATED: Use GOOGLECALENDAR_EVENTS_LIST instead. EventsList already handles syncToken with automatic param stripping. Synchronizes Google Calendar events, performing a full sync if no `sync_token` is provided or if a 410 GONE error (due to an expired token) necessitates it, otherwise performs an incremental sync for events changed since the `sync_token` was issued."
5578 + "description": "Deprecated: Retrieves a page of Google Calendar events for full or incremental synchronization, using a sync token for changes. Returns pagination and sync tokens; an expired token requires a new full synchronization."
5579 },
5580 {
5581 "slug": "GOOGLECALENDAR_UPDATE_EVENT",
5582 "name": "Update Google event",
5583 - "description": "Updates an existing event in Google Calendar. REQUIRES event_id - you MUST first search for the event using GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to obtain the event_id. This is a full PUT replacement: omitted fields (including attendees, reminders, recurrence, conferencing) are cleared. Always provide the complete desired event state. Use GOOGLECALENDAR_PATCH_EVENT instead for partial edits."
5583 + "description": "Replaces an existing Google Calendar event using its event ID and required start time. Omitted fields can be cleared, but existing conference data is preserved by default when available; supply the desired event details for the replacement."
5584 }
5585 ],
5586 "triggers": [
@@ -5686,22 +5686,22 @@
5686 ],
5687 "toolCount": 60,
5688 "triggerCount": 8,
5689 - "version": "20261018_00",
5689 + "version": "20261101_00",
5690 "tools": [
5691 {
5692 "slug": "NOTION_ADD_MULTIPLE_PAGE_CONTENT",
5693 "name": "Add multiple content blocks (bulk, user-friendly)",
5694 - "description": "Bulk-add content blocks to Notion. Text >2000 chars auto-splits. Parses markdown formatting. ⚠️ PARENT BLOCK TYPES: Content is added AS CHILDREN of parent_block_id. - To add content AFTER a heading, use PAGE ID as parent + heading ID in 'after' param. - Headings CANNOT have children unless is_toggleable=True. Simplified format: {'content': 'text', 'block_property': 'paragraph'} Full format for code: {'type': 'code', 'code': {'rich_text': [...], 'language': 'python'}} Array format also supported (auto-normalized): [{\"parent_block_id\": \"...\"}, {block1}, {block2}] => proper request structure"
5694 + "description": "Bulk-add content blocks as children of a Notion page or supported parent block, optionally after an existing child. Accepts simplified or full block formats and parses markdown in simplified text; long text handling varies by format, and simplified text segments may be truncated."
5695 },
5696 {
5697 "slug": "NOTION_ADD_PAGE_CONTENT",
5698 "name": "Add single content block to Notion page (Deprecated)",
5699 - "description": "DEPRECATED: Use 'add_multiple_page_content' for better performance. Adds a single content block to a Notion page/block. CRITICAL: Notion API enforces a HARD LIMIT of 2000 characters per text.content field. Content exceeding 2000 chars is AUTOMATICALLY SPLIT into multiple sequential blocks. REQUIRED 'content' field for text blocks: paragraph, heading_1-3, callout, to_do, toggle, quote, list items. Parent blocks MUST be: Page, Toggle, To-do, Bulleted/Numbered List Item, Callout, or Quote. Common errors: - \"content.length should be ≤ 2000\": Text exceeds API limit (should be auto-handled) - \"Content is required for paragraph blocks\": Missing 'content' field for text blocks - \"object_not_found\": Invalid parent_block_id or no integration access For bulk operations, use 'add_multiple_page_content' instead."
5699 + "description": "Adds content to a Notion page or parent block using simplified content or a full block object, optionally after an existing child. Notion limits rich-text content to 2,000 characters per text object; the integration needs access and insert-content capability. DEPRECATED: Use add_multiple_page_content for bulk operations."
5700 },
5701 {
5702 "slug": "NOTION_APPEND_BLOCK_CHILDREN",
5703 "name": "Append raw Notion blocks (advanced API)",
5704 - "description": "DEPRECATED: Use NOTION_APPEND_TEXT_BLOCKS, NOTION_APPEND_TASK_BLOCKS, NOTION_APPEND_CODE_BLOCKS, NOTION_APPEND_MEDIA_BLOCKS, NOTION_APPEND_LAYOUT_BLOCKS, or NOTION_APPEND_TABLE_BLOCKS instead. Appends raw Notion API blocks to parent. Text limited to 2000 chars per text.content field. Each block MUST have 'object':'block' and 'type'. Use rich_text arrays for text blocks."
5704 + "description": "Appends raw Notion blocks to a parent page or block, at the end or after an existing child. Oversized text in supported top-level text blocks is split into rich-text items within the same block. DEPRECATED: Use NOTION_APPEND_TEXT_BLOCKS, NOTION_APPEND_TASK_BLOCKS, NOTION_APPEND_CODE_BLOCKS, NOTION_APPEND_MEDIA_BLOCKS, NOTION_APPEND_LAYOUT_BLOCKS, or NOTION_APPEND_TABLE_BLOCKS instead."
5705 },
5706 {
5707 "slug": "NOTION_APPEND_CODE_BLOCKS",
@@ -5726,7 +5726,7 @@
5726 {
5727 "slug": "NOTION_APPEND_TASK_BLOCKS",
5728 "name": "Append task blocks (to-do, toggle, callout)",
5729 - "description": "Append task blocks (to-do, toggle, callout) to a Notion page or block. Supported block types: - to_do: Checkbox items (checkable/uncheckable) - toggle: Collapsible sections - callout: Highlighted boxes with emoji icons All three types support nested children (up to 2 levels of nesting). block_id must be a page or block that supports children (e.g., page, toggle, paragraph, list items, quote, callout, to_do). Blocks like divider, breadcrumb, equation do NOT support children. Limits: 2000 chars per text.content, max 100 blocks per request. For other blocks: append_text_blocks, append_code_blocks, append_media_blocks, append_layout_blocks, append_table_blocks."
5729 + "description": "Append to-do, toggle, and callout blocks to a Notion page or block that supports children. Text content is limited to 2,000 characters per text item, with at most 100 blocks per request."
5730 },
5731 {
5732 "slug": "NOTION_APPEND_TEXT_BLOCKS",
@@ -5751,7 +5751,7 @@
5751 {
5752 "slug": "NOTION_CREATE_FILE_UPLOAD",
5753 "name": "Create Notion file upload",
5754 - "description": "Tool to create a Notion FileUpload object and retrieve an upload URL. Use when you need to automate attaching local or external files directly into Notion without external hosting."
5754 + "description": "Creates a Notion FileUpload object for a direct, multipart, or external URL upload. Direct uploads require subsequent steps to send file contents and attach the uploaded file."
5755 },
5756 {
5757 "slug": "NOTION_CREATE_NOTION_PAGE",
@@ -5771,7 +5771,7 @@
5771 {
5772 "slug": "NOTION_DELETE_BLOCK",
5773 "name": "Delete a block",
5774 - "description": "Archives a Notion block, page, or database using its ID, which sets its 'archived' property to true (like moving to \"Trash\" in the UI) and allows it to be restored later. Note: This operation will fail if the block has an archived parent or ancestor in the hierarchy. You must unarchive the ancestor before archiving/deleting its descendants. IMPORTANT LIMITATION: Workspace-level pages (top-level pages that are direct children of the workspace, not contained within other pages or databases) cannot be archived via the Notion API. This is a documented Notion API restriction. Only pages that are children of other pages or databases can be deleted through this action."
5774 + "description": "Archives a Notion block, page, or database by ID, moving it to Trash for possible later restoration. The connection requires update content capability; an archived ancestor may need to be restored before a descendant can be archived."
5775 },
5776 {
5777 "slug": "NOTION_DELETE_VIEW",
@@ -5786,17 +5786,17 @@
5786 {
5787 "slug": "NOTION_DUPLICATE_PAGE",
5788 "name": "Duplicate page",
5789 - "description": "Duplicates a Notion page, including all its content, properties, and nested blocks, under a specified parent page or workspace."
5789 + "description": "Duplicates a Notion page under a specified parent page or database, copying supported content and writable properties. Page parents receive only the title property; some blocks and properties are skipped, block retrieval may be incomplete, and failure can leave a partial copy."
5790 },
5791 {
5792 "slug": "NOTION_FETCH_ALL_BLOCK_CONTENTS",
5793 "name": "Fetch All Notion Block Contents",
5794 - "description": "Tool to fetch all child blocks for a given Notion block. Use when you need a complete listing of a block's children beyond a single page; supports optional recursive expansion of nested blocks."
5794 + "description": "Fetches child blocks of a Notion block or page across result pages, with optional recursive expansion. Recursive results may be partial due to depth or block limits or inaccessible nested blocks; limit information is returned when recursion is used."
5795 },
5796 {
5797 "slug": "NOTION_FETCH_BLOCK_CONTENTS",
5798 "name": "Fetch Notion Block Children",
5799 - "description": "Retrieves a paginated list of direct, first-level child block objects along with contents for a given parent Notion block or page ID; use block IDs from the response for subsequent calls to access deeply nested content."
5799 + "description": "Retrieves a paginated list of direct child blocks for a Notion block or page. Use returned block IDs to access nested content; for an unsupported block-type error, the result is an empty list with an explanatory message."
5800 },
5801 {
5802 "slug": "NOTION_FETCH_BLOCK_METADATA",
@@ -5806,12 +5806,12 @@
5806 {
5807 "slug": "NOTION_FETCH_COMMENTS",
5808 "name": "Fetch comments",
5809 - "description": "Fetches unresolved comments for a specified Notion block or page ID. The block/page must be shared with your Notion integration and the integration must have 'Read comments' capability enabled, otherwise a 404 error will be returned."
5809 + "description": "Fetches a page of unresolved comments for a specified Notion block or page ID. The block or page must be shared with the integration, which must have Read comments capability enabled."
5810 },
5811 {
5812 "slug": "NOTION_FETCH_DATA",
5813 "name": "Fetch Notion Data",
5814 - "description": "Fetches Notion items (pages and/or databases) from the Notion workspace, use this to get minimal data about the items in the workspace with a query or list all items in the workspace with minimal data"
5814 + "description": "Search accessible Notion pages and/or databases by title or list them without a query. Returns one page of results with simplified IDs, titles and types, plus a cursor when more results are available; simplified titles use only the first rich-text segment."
5815 },
5816 {
5817 "slug": "NOTION_FETCH_DATABASE",
@@ -5836,7 +5836,7 @@
5836 {
5837 "slug": "NOTION_GET_PAGE_MARKDOWN",
5838 "name": "Get page markdown",
5839 - "description": "Retrieve a Notion page's full content rendered as Notion-flavored Markdown in a single API call. Use when you need the readable content of a page without recursive block-children fetching."
5839 + "description": "Retrieve a Notion page as Notion-flavored Markdown in a single API call without recursive block-children fetching. The response indicates whether content was truncated and identifies blocks that could not be rendered."
5840 },
5841 {
5842 "slug": "NOTION_GET_PAGE_PROPERTY_ACTION",
@@ -5856,7 +5856,7 @@
5856 {
5857 "slug": "NOTION_INSERT_ROW_DATABASE",
5858 "name": "Insert row database",
5859 - "description": "Creates a new page (row) in a specified Notion database. Prerequisites: - Database must be shared with your integration - Property names AND types must match schema exactly (case-sensitive) - Use NOTION_FETCH_DATA with fetch_type='databases' first to get exact property names and types - Each database has ONE 'title' property; other text fields are 'rich_text' - Database must NOT have multiple data sources (synced databases are not supported) Common Errors: - 404: Database not shared with integration - 400 \"not a property\": Wrong property name - 400 \"expected to be X\": Wrong property type - 400 \"multiple_data_sources\": Database uses multiple data sources (not supported) Note: Rich text content in child_blocks is automatically truncated to 2000 characters per Notion API limits."
5859 + "description": "Creates a page (row) in a specified Notion database with optional properties and child blocks. The database must be shared with the integration and cannot have multiple data sources; long child-block text segments may be truncated, and additional blocks are appended after page creation."
5860 },
5861 {
5862 "slug": "NOTION_INSERT_ROW_FROM_NL",
@@ -5866,7 +5866,7 @@
5866 {
5867 "slug": "NOTION_LIST_DATA_SOURCE_TEMPLATES",
5868 "name": "List data source templates",
5869 - "description": "Tool to list all templates for a Notion data source. Use when needing to discover template IDs/names for bulk page creation. Use after confirming the data_source_id."
5869 + "description": "Lists a page of accessible templates for a Notion data source, including their IDs and names. Use the returned cursor to retrieve further pages."
5870 },
5871 {
5872 "slug": "NOTION_LIST_FILE_UPLOADS",
@@ -5891,12 +5891,12 @@
5891 {
5892 "slug": "NOTION_MOVE_PAGE",
5893 "name": "Move Page",
5894 - "description": "Tool to move a Notion page to a new parent (page or database). Use when you need to reorganize page hierarchy. Important: To move to a database, use data_source_id (NOT database_id). Get the data source ID from the database object using NOTION_FETCH_DATABASE."
5894 + "description": "Moves a Notion page to a new parent page or database data source. For a database destination, provide the data source ID."
5895 },
5896 {
5897 "slug": "NOTION_QUERY_DATABASE",
5898 "name": "Query database",
5899 - "description": "Queries a Notion database to retrieve pages (rows). In Notion, databases are collections where each row is a page and columns are properties. Returns paginated results with metadata. Important requirements: - The database must be shared with your integration - Property names in sorts must match existing database properties exactly (case-sensitive) - For timestamp sorting, use 'created_time' or 'last_edited_time' (case-insensitive) - The start_cursor must be the opaque value from a previous response's next_cursor field - Database IDs must be valid 32-character UUIDs (with or without hyphens) Use this action to: - Retrieve all or filtered database entries - Sort results by database properties or page timestamps - Paginate through large result sets - Get database content for processing or display"
5899 + "description": "Query a shared Notion database for paginated entries, with sorting by database properties or page timestamps. Supply a database UUID and use the returned cursor to retrieve further results."
5900 },
5901 {
5902 "slug": "NOTION_QUERY_DATABASE_WITH_FILTER",
@@ -5906,12 +5906,12 @@
5906 {
5907 "slug": "NOTION_QUERY_DATA_SOURCE",
5908 "name": "Query data source",
5909 - "description": "Tool to query a Notion data source. Use when you need to retrieve pages or child data sources with filters, sorts, and pagination. Make paginated requests using cursors and optional property filters for efficient data retrieval."
5909 + "description": "Query a Notion data source for pages or child data sources using filters, sorts, and optional property selection. Results support cursor pagination, with a requested page size of 1 to 100."
5910 },
5911 {
5912 "slug": "NOTION_REPLACE_PAGE_CONTENT",
5913 "name": "Replace page content (with backup)",
5914 - "description": "Safely replaces a page's child blocks by optionally backing up current content, deleting existing children, then appending new children in batches. Use when you need to rebuild a page without leaving partial states. Notion does not provide atomic transactions; this tool orchestrates a multi-step workflow with optional backup to reduce risk."
5914 + "description": "Replaces a page's child blocks by optionally backing up current content, archiving existing children, and appending new children in batches. The workflow is not atomic and failures can leave partial changes; backups omit some block types and nested content."
5915 },
5916 {
5917 "slug": "NOTION_RETRIEVE_COMMENT",
@@ -5931,7 +5931,7 @@
5931 {
5932 "slug": "NOTION_RETRIEVE_PAGE",
5933 "name": "Retrieve page",
5934 - "description": "Retrieve a Notion page's properties/metadata (not block content) by page_id. Use when you have a page URL/ID and need to access its properties; for page content use block-children tools."
5934 + "description": "Retrieve a Notion page's properties and metadata by page ID, rather than its block content. The input must be a UUID, not a full page URL."
5935 },
5936 {
5937 "slug": "NOTION_RETRIEVE_VIEW",
@@ -5941,7 +5941,7 @@
5941 {
5942 "slug": "NOTION_SEARCH_NOTION_PAGE",
5943 "name": "Search Notion pages and databases",
5944 - "description": "Searches Notion pages and databases by title. Use specific search terms to find items by title (primary approach). KNOWN LIMITATIONS: (1) Search indexing is not immediate - recently shared items may not appear. (2) Search is not exhaustive - results may be incomplete. (3) Database pages return all custom properties with full nested structures, which can create large responses for databases with many properties - use filter_properties to reduce response size. FALLBACK STRATEGY: If a specific title search returns empty results despite knowing items exist, try an empty query to list all accessible items and filter client-side."
5944 + "description": "Search Notion pages and databases by title, with an object-type filter that defaults to pages. Search indexing can lag and results may be incomplete; an empty query can help find accessible items, and optional client-side property filtering reduces page response size."
5945 },
5946 {
5947 "slug": "NOTION_SEND_FILE_UPLOAD",
@@ -5981,7 +5981,7 @@
5981 {
5982 "slug": "NOTION_UPSERT_ROW_DATABASE",
5983 "name": "Upsert database rows",
5984 - "description": "Tool to upsert rows in a Notion database by querying for existing rows and creating or updating them. Use when you need to sync data to Notion without creating duplicates. Each item is matched by a filter, then either created (if no match) or updated (if match found). Supports bulk operations with per-item error handling."
5984 + "description": "Upserts Notion database rows in bulk by querying a filter for each item, then creating a row if none is returned or updating a match. Only the first query page is examined; multiple matches can update the first or produce an error, with per-item results."
5985 },
5986 {
5987 "slug": "NOTION_WHO_AM_I",
@@ -6119,7 +6119,7 @@
6119 ],
6120 "toolCount": 58,
6121 "triggerCount": 16,
6122 - "version": "20261018_00",
6122 + "version": "20261101_00",
6123 "tools": [
6124 {
6125 "slug": "GOOGLESHEETS_ADD_SHEET",
@@ -6129,7 +6129,7 @@
6129 {
6130 "slug": "GOOGLESHEETS_AGGREGATE_COLUMN_DATA",
6131 "name": "Aggregate Column Data",
6132 - "description": "Searches for rows where a specific column matches a value and performs mathematical operations on data from another column."
6132 + "description": "Aggregates data from a column in a Google Sheet, either across all rows or rows matching column-value filters. Supports sum, average, count, minimum, maximum, and percentage."
6133 },
6134 {
6135 "slug": "GOOGLESHEETS_APPEND_DIMENSION",
@@ -6149,12 +6149,12 @@
6149 {
6150 "slug": "GOOGLESHEETS_BATCH_GET",
6151 "name": "Batch get spreadsheet",
6152 - "description": "Retrieves data from specified cell ranges in a Google Spreadsheet."
6152 + "description": "Retrieves values from specified cell ranges in a Google Spreadsheet. If ranges are omitted or empty after filtering blank entries, it retrieves data from the first sheet."
6153 },
6154 {
6155 "slug": "GOOGLESHEETS_BATCH_UPDATE",
6156 "name": "Batch update spreadsheet (Deprecated)",
6157 - "description": "DEPRECATED: Use GOOGLESHEETS_VALUES_UPDATE instead. Write values to ONE range in a Google Sheet, or append as new rows if no start cell is given. IMPORTANT - This tool does NOT accept the Google Sheets API's native batch format: - WRONG: {\"data\": [{\"range\": \"...\", \"values\": [[...]]}], ...} - CORRECT: {\"sheet_name\": \"...\", \"values\": [[...]], \"first_cell_location\": \"...\", ...} To update MULTIPLE ranges, make SEPARATE CALLS to this tool for each range. Features: - Auto-expands grid for large datasets (prevents range errors) - Set first_cell_location to write at a specific position (e.g., \"A1\", \"B5\") - Omit first_cell_location to append values as new rows at the end Requirements: Target sheet must exist and spreadsheet must contain at least one worksheet."
6157 + "description": "Deprecated: Writes values to one range in a Google Sheet, or appends rows when no start cell is given. It may expand the sheet grid; if a recognized default sheet name is not found, it uses the first sheet instead."
6158 },
6159 {
6160 "slug": "GOOGLESHEETS_BATCH_UPDATE_VALUES_BY_DATA_FILTER",
@@ -6174,17 +6174,17 @@
6174 {
6175 "slug": "GOOGLESHEETS_CREATE_CHART",
6176 "name": "Create Chart in Google Sheets",
6177 - "description": "Create a chart in a Google Sheets spreadsheet using the specified data range and chart type. Conditional requirements: - Provide either a simple chart via chart_type + data_range (basicChart), OR supply a full chart_spec supporting all chart types. Exactly one approach should be used. - When using chart_spec, set exactly one of the union fields (basicChart | pieChart | bubbleChart | candlestickChart | histogramChart | waterfallChart | treemapChart | orgChart | scorecardChart)."
6177 + "description": "Create a chart in a Google Sheets spreadsheet using a specified data range and chart type, or an optional full chart specification. The chart type and data range are required even when supplying a chart specification."
6178 },
6179 {
6180 "slug": "GOOGLESHEETS_CREATE_GOOGLE_SHEET1",
6181 "name": "Create a Google Sheet",
6182 - "description": "Creates a new Google Spreadsheet in Google Drive. If a title is provided, the spreadsheet will be created with that name. If no title is provided, Google will create a spreadsheet with a default name like 'Untitled spreadsheet'. Optionally create the spreadsheet in a specific folder by providing either: - folder_id: The Google Drive folder ID (preferred, unambiguous) - folder_name: The folder name (searches for exact match; if multiple folders match, returns choices) If neither folder_id nor folder_name is provided, the spreadsheet is created in the root Drive folder."
6182 + "description": "Creates a new Google Spreadsheet in Drive with an optional title and folder ID or exact folder name. Multiple matching folders return choices before creation; if moving a created spreadsheet to the requested folder fails, the response reports partial success."
6183 },
6184 {
6185 "slug": "GOOGLESHEETS_CREATE_SPREADSHEET_COLUMN",
6186 "name": "Create spreadsheet column",
6187 - "description": "Creates a new column in a Google Spreadsheet. Specify the target sheet using sheet_id (numeric) or sheet_name (text). If neither is provided, defaults to the first sheet (sheet_id=0)."
6187 + "description": "Inserts a new column in a Google Spreadsheet at a specified index. Select the target sheet by numeric ID or name; if neither is provided, sheet ID 0 is used."
6188 },
6189 {
6190 "slug": "GOOGLESHEETS_CREATE_SPREADSHEET_ROW",
@@ -6209,7 +6209,7 @@
6209 {
6210 "slug": "GOOGLESHEETS_EXECUTE_SQL",
6211 "name": "Execute SQL on Spreadsheet",
6212 - "description": "DEPRECATED: Use direct Google Sheets actions instead: - GOOGLESHEETS_VALUES_GET / GOOGLESHEETS_BATCH_GET for reads - GOOGLESHEETS_VALUES_UPDATE / GOOGLESHEETS_UPDATE_VALUES_BATCH / GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND for writes Execute SQL queries against Google Sheets tables. Supports SELECT, INSERT, UPDATE, DELETE operations and WITH clauses (CTEs) with familiar SQL syntax. Tables are automatically detected and mapped from the spreadsheet structure."
6212 + "description": "Deprecated SQL facade for selecting, inserting, updating, and deleting data in automatically detected spreadsheet tables, including limited WITH queries; discovery reads at most 10,000 rows per sheet. For detected header-based tables, the first data row is skipped and update/delete row targeting can be offset."
6213 },
6214 {
6215 "slug": "GOOGLESHEETS_EXPORT_DRIVE_FILE",
@@ -6224,17 +6224,17 @@
6224 {
6225 "slug": "GOOGLESHEETS_FIND_REPLACE",
6226 "name": "Find and Replace in Spreadsheet",
6227 - "description": "Tool to find and replace text in a Google Spreadsheet. Use when you need to fix formula errors, update values, or perform bulk text replacements across cells. Common use cases: - Fix #ERROR! cells by replacing with empty string or correct formula - Update old values with new ones across multiple cells - Fix formula references or patterns - Clean up data formatting issues"
6227 + "description": "Finds and replaces text across cells in a Google Spreadsheet, scoped to a sheet, range, or all sheets; if no scope is specified, it searches all sheets. Formula cells can be included explicitly when fixing formula references or patterns."
6228 },
6229 {
6230 "slug": "GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE",
6231 "name": "Find worksheet by title (Deprecated)",
6232 - "description": "DEPRECATED: Use GetSpreadsheetInfo instead. Finds a worksheet by its exact, case-sensitive title within a Google Spreadsheet; returns a boolean indicating if found and the matched worksheet's metadata when found, or None when not found."
6232 + "description": "DEPRECATED: Finds a worksheet by its case-sensitive title within a Google Spreadsheet, after trimming input whitespace and decoding Unicode escapes. Returns a found boolean and matched worksheet metadata, or indicates no match."
6233 },
6234 {
6235 "slug": "GOOGLESHEETS_FORMAT_CELL",
6236 "name": "Format cell",
6237 - "description": "Applies text and background cell formatting to a specified range in a Google Sheets worksheet."
6237 + "description": "Formats a specified cell range in a Google Sheets worksheet. It always applies text style, font size and background color defaults unless supplied; a sheet prefix in an A1 range is ignored, so select the worksheet separately."
6238 },
6239 {
6240 "slug": "GOOGLESHEETS_GET_BATCH_VALUES",
@@ -6274,7 +6274,7 @@
6274 {
6275 "slug": "GOOGLESHEETS_GET_TABLE_SCHEMA",
6276 "name": "Get Table Schema",
6277 - "description": "DEPRECATED: Use GOOGLESHEETS_GET_SHEET_NAMES and GOOGLESHEETS_GET_SPREADSHEET_INFO for sheet structure metadata, and GOOGLESHEETS_VALUES_GET for direct range inspection. This action is used to get the schema of a table in a Google Spreadsheet, call this action to get the schema of a table in a spreadsheet BEFORE YOU QUERY THE TABLE. Analyze table structure and infer column names, types, and constraints. Uses statistical analysis of sample data to determine the most likely data type for each column. Call this action after calling the LIST_TABLES action to get the schema of a table in a spreadsheet."
6277 + "description": "Deprecated: Retrieves an inferred schema for a detected table in a Google Spreadsheet, including column names and types estimated from sampled data."
6278 },
6279 {
6280 "slug": "GOOGLESHEETS_INSERT_DIMENSION",
@@ -6294,12 +6294,12 @@
6294 {
6295 "slug": "GOOGLESHEETS_LIST_TABLES",
6296 "name": "List Tables in Spreadsheet",
6297 - "description": "DEPRECATED: Use GOOGLESHEETS_GET_SHEET_NAMES for tab discovery and GOOGLESHEETS_GET_SPREADSHEET_INFO for full sheet metadata. This action is used to list all tables in a Google Spreadsheet, call this action to get the list of tables in a spreadsheet. Discover all tables in a Google Spreadsheet by analyzing sheet structure and detecting data patterns. Uses heuristic analysis to find header rows, data boundaries, and table structures."
6297 + "description": "Deprecated: Lists heuristically detected tables in a Google Spreadsheet. It scans up to the first 1,000 rows and skips sheets with more than 2,000 rows or 100 columns."
6298 },
6299 {
6300 "slug": "GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW",
6301 "name": "Look up spreadsheet row",
6302 - "description": "Finds the first row in a Google Spreadsheet where a cell's entire content exactly matches the query string, searching within a specified A1 notation range or the first sheet by default."
6302 + "description": "Finds the first row in a specified A1 range or the first sheet where a cell matches the query after Unicode and invisible-character normalization. Matching is case-insensitive and trims surrounding whitespace by default; both behaviors are configurable."
6303 },
6304 {
6305 "slug": "GOOGLESHEETS_MOVE_CHART",
@@ -6319,7 +6319,7 @@
6319 {
6320 "slug": "GOOGLESHEETS_QUERY_TABLE",
6321 "name": "Query Spreadsheet Table",
6322 - "description": "DEPRECATED: Use GOOGLESHEETS_VALUES_GET / GOOGLESHEETS_BATCH_GET for table reads and GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW for row lookup/filter workflows. Execute SQL-like SELECT queries against Google Spreadsheet tables. Table names correspond to sheet/tab names visible at the bottom of the spreadsheet. Use GOOGLESHEETS_LIST_TABLES first to discover available table names if unknown. Supports WHERE conditions, ORDER BY, LIMIT clauses."
6322 + "description": "Executes SQL-like SELECT queries against detected tables in a native Google spreadsheet, with filtering, sorting, and limits. Sheet names can refer to the first detected table; detection and query processing are heuristic, and results may omit rows. DEPRECATED: Use GOOGLESHEETS_VALUES_GET or GOOGLESHEETS_BATCH_GET for table reads, and GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW for row lookup or filtering."
6323 },
6324 {
6325 "slug": "GOOGLESHEETS_SEARCH_DEVELOPER_METADATA",
@@ -6329,7 +6329,7 @@
6329 {
6330 "slug": "GOOGLESHEETS_SEARCH_SPREADSHEETS",
6331 "name": "Search Spreadsheets",
6332 - "description": "Search for Google Spreadsheets using various filters including name, content, date ranges, and more."
6332 + "description": "Search for Google spreadsheets accessible in Drive by name, content, dates, and other filters, including starred and shared-with-me status. Results are paginated, with up to 1,000 items per page; shared drives are included by default and searches across them may be incomplete."
6333 },
6334 {
6335 "slug": "GOOGLESHEETS_SET_BASIC_FILTER",
@@ -6344,7 +6344,7 @@
6344 {
6345 "slug": "GOOGLESHEETS_SHEET_FROM_JSON",
6346 "name": "Create sheet from JSON",
6347 - "description": "DEPRECATED: Use GOOGLESHEETS_CREATE_GOOGLE_SHEET1 + GOOGLESHEETS_UPDATE_VALUES_BATCH (or GOOGLESHEETS_VALUES_UPDATE / GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND) instead. Creates a new Google Spreadsheet and populates its first worksheet from `sheet_json`. When data is provided, the first item's keys establish the headers. An empty list creates an empty worksheet."
6347 + "description": "DEPRECATED: Creates a new Google Spreadsheet and populates its first worksheet from JSON rows; an empty list creates an empty worksheet. Headers use keys from the first row followed by additional keys found in later rows."
6348 },
6349 {
6350 "slug": "GOOGLESHEETS_SORT_RANGE",
@@ -6369,12 +6369,12 @@
6369 {
6370 "slug": "GOOGLESHEETS_SPREADSHEETS_VALUES_BATCH_GET_BY_DATA_FILTER",
6371 "name": "Batch Get Spreadsheet Values by Data Filter",
6372 - "description": "Tool to return one or more ranges of values from a spreadsheet that match the specified data filters. Use when you need to retrieve specific data sets based on filtering criteria rather than entire sheets or fixed ranges."
6372 + "description": "Retrieves one or more ranges of values from a Google Spreadsheet using data filters. Each filter specifies an A1 range or a grid range."
6373 },
6374 {
6375 "slug": "GOOGLESHEETS_UPDATE_CHART",
6376 "name": "Update Chart in Google Sheets",
6377 - "description": "Update the specification of an existing chart in a Google Sheets spreadsheet. Use this action when you need to modify an existing chart's properties such as its title, chart type, data ranges, colors, axes, or other visual settings. This action updates the chart's specification but does not change its position or size on the sheet."
6377 + "description": "Updates an existing chart in a Google Sheets spreadsheet by replacing its chart specification. The specification can change its title, chart type, data ranges, colors, axes, and other visual settings without moving or resizing the chart."
6378 },
6379 {
6380 "slug": "GOOGLESHEETS_UPDATE_DIMENSION_PROPERTIES",
@@ -6399,7 +6399,7 @@
6399 {
6400 "slug": "GOOGLESHEETS_UPSERT_ROWS",
6401 "name": "Upsert Rows (Smart Update/Insert)",
6402 - "description": "Upsert rows - update existing rows by key, append new ones. Automatically handles column mapping and partial updates. Use for: CRM syncs (match Lead ID), transaction imports (match Transaction ID), inventory updates (match SKU), calendar syncs (match Event ID). Features: - Auto-adds missing columns to sheet - Partial column updates (only update Phone + Status, preserve other columns) - Column order doesn't matter (auto-maps by header name) - Prevents duplicates by matching key column Example inputs: - Contact update: keyColumn='Email', headers=['Email','Phone','Status'], data=[['john@ex.com','555-0101','Active']] - Inventory sync: keyColumn='SKU', headers=['SKU','Stock','Price'], data=[['WIDGET-001',50,9.99],['GADGET-002',30,19.99]] - CRM lead update: keyColumn='Lead ID', headers=['Lead ID','Score','Status'], data=[['L-12345',85,'Hot']] - Partial update: keyColumn='Email', headers=['Email','Phone'] (only updates Phone, preserves Name/Address/etc)"
6402 + "description": "Upserts rows in a Google Sheet by matching a key column: updates matching rows and appends new ones. It maps columns by header name, adds missing columns, and supports partial updates."
6403 },
6404 {
6405 "slug": "GOOGLESHEETS_VALUES_GET",
@@ -6409,7 +6409,7 @@
6409 {
6410 "slug": "GOOGLESHEETS_VALUES_UPDATE",
6411 "name": "Update spreadsheet values",
6412 - "description": "Tool to set values in a range of a Google Spreadsheet. Use when you need to update or overwrite existing cell values in a specific range."
6412 + "description": "Sets or overwrites values in a Google Spreadsheet range, adjusting the range to fit the supplied values and potentially expanding the sheet by default. Unmatched common default sheet names may resolve to the first sheet."
6413 }
6414 ],
6415 "triggers": [
@@ -6559,7 +6559,7 @@
6559 ],
6560 "toolCount": 171,
6561 "triggerCount": 9,
6562 - "version": "20261023_00",
6562 + "version": "20261101_00",
6563 "tools": [
6564 {
6565 "slug": "SLACK_ADD_CALL_PARTICIPANTS",
@@ -6584,7 +6584,7 @@
6584 {
6585 "slug": "SLACK_ADD_REACTION_TO_AN_ITEM",
6586 "name": "Add reaction to message",
6587 - "description": "Adds a specified emoji reaction to an existing message in a Slack channel, identified by its timestamp; does not remove or retrieve reactions."
6587 + "description": "Adds a specified emoji reaction to a Slack message identified by channel and timestamp. An already-existing reaction is reported as success."
6588 },
6589 {
6590 "slug": "SLACK_ADD_REMOTE_FILE",
@@ -6594,7 +6594,7 @@
6594 {
6595 "slug": "SLACK_ADD_STAR",
6596 "name": "Add a star to an item",
6597 - "description": "Stars a channel, file, file comment, or a specific message in Slack."
6597 + "description": "Adds a star to a Slack channel, file, file comment, or message for the authenticated user. Stars added through this method can no longer be viewed or interacted with by end users."
6598 },
6599 {
6600 "slug": "SLACK_ADMIN_CONVERSATIONS_SEARCH",
@@ -6614,7 +6614,7 @@
6614 {
6615 "slug": "SLACK_ASSISTANT_SEARCH_CONTEXT",
6616 "name": "Real-time search",
6617 - "description": "Search Slack messages, files, channels, and users via Real-time Search API. For queries referencing entities by name (users/channels/files), first resolve with content_types (users/channels/files) to get exact ID. If multiple matches, ask user to clarify before proceeding (e.g. ask for user email)."
6617 + "description": "Search Slack messages, files, channels, and users via the Real-time Search API, with content-type and conversation filters and pagination."
6618 },
6619 {
6620 "slug": "SLACK_ASSISTANT_SEARCH_INFO",
@@ -6624,7 +6624,7 @@
6624 {
6625 "slug": "SLACK_CHAT_POST_MESSAGE",
6626 "name": "Send message",
6627 - "description": "(DEPRECATED: use `SLACK_SEND_MESSAGE`) Posts a message to a Slack channel, DM, or private group; requires at least one content field (`markdown_text`, `text`, `blocks`, or `attachments`) — omitting all causes a `no_text` error. Fails with `not_in_channel`, `channel_not_found`, or `channel_is_archived` if the bot lacks access. Body limit ~4000 characters. Rate-limited at ~1 req/sec (HTTP 429, honor `Retry-After`). Not idempotent — duplicate calls post duplicate messages."
6627 + "description": "Posts a message to a Slack channel, DM or private group using text, Markdown, blocks or attachments; this action is deprecated. Long converted Markdown may be split into threaded continuation messages, and a continuation failure can leave the initial message posted without all content."
6628 },
6629 {
6630 "slug": "SLACK_CLOSE_DM",
@@ -6684,12 +6684,12 @@
6684 {
6685 "slug": "SLACK_CUSTOMIZE_URL_UNFURL",
6686 "name": "Customize URL unfurl",
6687 - "description": "Customizes URL previews (unfurling) in a specific Slack message using a URL-encoded JSON in `unfurls` to define custom content or remove existing previews."
6687 + "description": "Customizes URL unfurls in a posted Slack message or message composer using custom preview content or Work Object metadata. It can also provide authentication prompts for unfurling."
6688 },
6689 {
6690 "slug": "SLACK_DELETE_CANVAS",
6691 "name": "Delete Slack Canvas",
6692 - "description": "Deletes a Slack Canvas permanently and irreversibly. Always confirm with the user before calling this tool."
6692 + "description": "Deletes a Slack Canvas permanently and irreversibly; always confirm with the user before calling. For skill canvases, Slack may return success without deleting the canvas and indicate that the Skills API is required."
6693 },
6694 {
6695 "slug": "SLACK_DELETE_CHANNEL",
@@ -6804,7 +6804,7 @@
6804 {
6805 "slug": "SLACK_FIND_CHANNELS",
6806 "name": "Find channels",
6807 - "description": "Find channels in a Slack workspace by any criteria - name, topic, purpose, or description. Returns channel IDs (C*/G* prefixed) required by most Slack tools — always resolve names to IDs here before passing to other tools. NOTE: This action searches channels and conversations visible to the authenticated user. Empty results may indicate: - No channels match the search query in name, topic, or purpose - The target private channel or DM is not accessible to the authenticated user because they are not a member - The connection lacks required read scopes (channels:read, groups:read, im:read, mpim:read). If empty, retry with exact_match=false or exclude_archived=false to avoid false negatives. In large workspaces, paginate using next_cursor to avoid missing matches. Check 'composio_execution_message' and 'total_channels_searched' in the response for details."
6807 + "description": "Finds Slack channels and conversations visible to the authenticated user by name, topic or purpose, with partial or exact matching. Searches one page at a time; results depend on conversation type, membership, archive settings and access, with a cursor to continue."
6808 },
6809 {
6810 "slug": "SLACK_FIND_USER_BY_EMAIL_ADDRESS",
@@ -6814,7 +6814,7 @@
6814 {
6815 "slug": "SLACK_FIND_USERS",
6816 "name": "Find users",
6817 - "description": "Find users in a Slack workspace by any criteria - email, name, display name, or other text. Includes optimized email lookup for exact email matches. Zero results may reflect email visibility restrictions or workspace policies, not global absence. Repeated calls may trigger HTTP 429; honor the Retry-After header."
6817 + "description": "Find Slack users by ID, email, name, display name, or other text. General searches filter one page per call and return a cursor; direct ID and exact-email lookup failures may return empty results with a diagnostic message."
6818 },
6819 {
6820 "slug": "SLACK_GET_APP_PERMISSION_SCOPES",
@@ -6844,7 +6844,7 @@
6844 {
6845 "slug": "SLACK_GET_CANVAS",
6846 "name": "Get Slack Canvas (Deprecated)",
6847 - "description": "DEPRECATED: Use SLACK_RETRIEVE_DETAILED_INFORMATION_ABOUT_A_FILE instead. Retrieves a specific Slack Canvas by its ID, including its content and metadata."
6847 + "description": "Retrieves file metadata for a Slack Canvas by its ID. This action is deprecated and does not retrieve canvas document content."
6848 },
6849 {
6850 "slug": "SLACK_GET_CHANNEL_CONVERSATION_PREFERENCES",
@@ -6874,12 +6874,12 @@
6874 {
6875 "slug": "SLACK_GET_UNREAD_MESSAGES_FROM_USER",
6876 "name": "Get unread messages from user",
6877 - "description": "Retrieves unread direct messages from a specific user by opening their DM conversation, checking for unread messages, and fetching message history since the last read timestamp. Use this action when you need to check if a specific user has sent unread direct messages to the authenticated user, or when monitoring incoming DMs from particular users. Returns an empty messages array if there are no unread messages from the specified user. Note: This action only works for direct messages (DMs), not channel messages or group conversations."
6877 + "description": "Retrieves unread direct messages from a specified user in the authenticated user's DM conversation, checking message history after the last-read timestamp. Opens or resumes the DM and returns matching messages oldest first, with a limit of 25 by default and up to 999."
6878 },
6879 {
6880 "slug": "SLACK_GET_USER_DND_STATUS",
6881 "name": "Get team DND status",
6882 - "description": "Retrieves a user's current Do Not Disturb status."
6882 + "description": "Retrieves current Do Not Disturb status for specified Slack users, up to 50 per request."
6883 },
6884 {
6885 "slug": "SLACK_GET_USER_PRESENCE",
@@ -6899,7 +6899,7 @@
6899 {
6900 "slug": "SLACK_INVITE_USERS_TO_A_SLACK_CHANNEL",
6901 "name": "Invite users to a Slack channel",
6902 - "description": "Invites users to an existing Slack channel using their valid Slack User IDs. Response is always HTTP 200; inspect `ok`, `error`, and `errors` fields to confirm users were added."
6902 + "description": "Invites users to an existing Slack channel using their Slack user IDs. Slack API failures raise an error, which may include per-user invitation failures."
6903 },
6904 {
6905 "slug": "SLACK_INVITE_USER_TO_CHANNEL",
@@ -6944,7 +6944,7 @@
6944 {
6945 "slug": "SLACK_LIST_ALL_CHANNELS",
6946 "name": "List all channels",
6947 - "description": "Lists conversations available to the user with various filters and search options. Always use resolved `channel_id` (not display names) for downstream operations, as names may be non-unique. The `created` field in results is a Unix epoch timestamp (UTC). Pagination across large workspaces may return HTTP 429 with a `Retry-After` header; honor the delay and resume from the last successful cursor."
6947 + "description": "Lists conversations available to the authenticated user, with filters for conversation type and archived status. Results are paginated; the created field is a Unix timestamp."
6948 },
6949 {
6950 "slug": "SLACK_LIST_ALL_USERS",
@@ -6964,17 +6964,17 @@
6964 {
6965 "slug": "SLACK_LIST_AVAILABLE_WORKSPACES",
6966 "name": "List available workspaces",
6967 - "description": "List Slack workspaces where both the connection and target user have access. Returns each workspace's team_id and name. Use this when: (1) the user references a workspace by name, (2) a user-specific tool requires team_id and you don't have one, or (3) a user-specific call fails with a team/workspace access error. Match the user's workspace name to a team_id from the results and pass that team_id to subsequent tools. If the name matches zero or multiple workspaces, ask the user to clarify. Only meaningful for org-level installs; single-workspace connections return the workspace only if the specified user's membership is visible to this token."
6967 + "description": "Lists a page of Slack workspaces authorized for the connection that also appear in the target user's visible Enterprise Grid memberships. Returns workspace IDs and names with a cursor for further pages; missing membership data yields an empty result."
6968 },
6969 {
6970 "slug": "SLACK_LIST_CANVASES",
6971 "name": "List Slack Canvases (Deprecated)",
6972 - "description": "DEPRECATED: Use SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK instead (pass types=\"canvas\" for equivalent behavior). Lists Slack Canvases with filtering by channel, user, timestamp, and page-based pagination. Uses Slack's files.list API with types=canvas filter. Only canvases accessible to the authenticated app are returned; missing canvases indicate permissions restrictions, not empty data. Use `paging.pages` in the response to determine total pages; iterate `page` with `count` to retrieve all results. Known limitations: - The 'user' filter may return canvases accessible to the specified user, not just canvases they created. - The 'ts_from' and 'ts_to' timestamp filters may not work reliably for canvas types. Consider client-side filtering on the 'created' field in the response if precise date filtering is required."
6972 + "description": "Lists accessible Slack Canvases using page-based pagination and optional channel, user and timestamp filters. This deprecated action's user filter may include canvases accessible to the user, and timestamp filters may not be reliable for canvases."
6973 },
6974 {
6975 "slug": "SLACK_LIST_CONVERSATIONS",
6976 "name": "List conversations",
6977 - "description": "List conversations (channels/DMs) accessible to a specified user (or the authenticated user if no user ID is provided), respecting shared membership for non-public channels. Returns conversation IDs (C* for channels, G* for group DMs), not display names. Absence of private channels, DMs, or MPIMs from results indicates token scope or membership limits, not that the conversation is nonexistent."
6977 + "description": "Lists a page of Slack conversations for a specified user or the authenticated user, with filters for conversation type and archived status. Results contain conversation objects with IDs and may include channel names; access and selected types affect which conversations appear."
6978 },
6979 {
6980 "slug": "SLACK_LIST_CUSTOM_EMOJIS",
@@ -6984,7 +6984,7 @@
6984 {
6985 "slug": "SLACK_LIST_DENIED_WORKSPACE_INVITE_REQUESTS",
6986 "name": "List denied workspace invite requests",
6987 - "description": "Tool to list all denied workspace invite requests with details about who denied them and when. Use when you need to review or audit denied invitation requests."
6987 + "description": "Lists a page of denied workspace invitation requests for review or audit, including available details about who denied them. Use the returned cursor to retrieve further pages."
6988 },
6989 {
6990 "slug": "SLACK_LIST_ENTERPRISE_TEAMS",
@@ -7004,7 +7004,7 @@
7004 {
7005 "slug": "SLACK_LIST_PENDING_WORKSPACE_INVITE_REQUESTS",
7006 "name": "List pending workspace invite requests",
7007 - "description": "Tool to list all pending workspace invite requests. Use when you need to see who has been invited but hasn't joined yet. Requires admin.invites:read scope."
7007 + "description": "Lists pending Slack workspace invite requests, optionally filtered by workspace and paginated. Requires the admin.invites:read scope."
7008 },
7009 {
7010 "slug": "SLACK_LIST_PINNED_ITEMS",
@@ -7044,7 +7044,7 @@
7044 {
7045 "slug": "SLACK_LIST_UNREAD_CHANNEL_MESSAGES",
7046 "name": "List unread channel messages",
7047 - "description": "Lists all unread messages in a specified Slack channel for the authenticated user. This action fetches messages that have been posted since the user's last read position in the channel. Use this action when you need to retrieve messages the user hasn't seen yet. The action determines the user's read position and returns all messages posted after that timestamp. Note: This only returns messages from the main channel timeline, not threaded replies. For threaded replies, use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION."
7047 + "description": "Lists a page of unread main-timeline messages in a Slack channel for the authenticated user, using the last read position or zero if unavailable. Use the returned cursor to request another page; threaded replies are not included."
7048 },
7049 {
7050 "slug": "SLACK_LIST_USER_GROUP_MEMBERS",
@@ -7054,7 +7054,7 @@
7054 {
7055 "slug": "SLACK_LIST_USER_GROUPS",
7056 "name": "List user groups",
7057 - "description": "Lists user groups in a Slack workspace, including user-created and default groups; results for large workspaces may be paginated."
7057 + "description": "Lists user groups in a Slack workspace, including user-created and default groups, with options to include disabled groups, user IDs, and member counts."
7058 },
7059 {
7060 "slug": "SLACK_LIST_USER_REACTIONS",
@@ -7074,7 +7074,7 @@
7074 {
7075 "slug": "SLACK_LIST_WORKSPACE_USERS",
7076 "name": "List admin users",
7077 - "description": "Retrieves a paginated list of admin users for a specified Slack workspace."
7077 + "description": "Retrieves a paginated list of users in an Enterprise Slack organization, optionally filtered to a workspace, activity status or guests."
7078 },
7079 {
7080 "slug": "SLACK_LOOKUP_CANVAS_SECTIONS",
@@ -7089,7 +7089,7 @@
7089 {
7090 "slug": "SLACK_OPEN_DM",
7091 "name": "Open DM",
7092 - "description": "Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID. Returns `already_open=true` when the DM exists — treat as success and reuse the returned `channel.id` (starts with 'D') for subsequent SLACK_SEND_MESSAGE calls; passing a username, email, or user ID directly to SLACK_SEND_MESSAGE causes `channel_not_found`. Avoid redundant calls when an existing DM channel ID is available."
7092 + "description": "Opens or resumes a Slack direct message or multi-person direct message using user IDs or an existing conversation ID. Returns the conversation ID and may indicate that the conversation is already open."
7093 },
7094 {
7095 "slug": "SLACK_PIN_ITEM",
@@ -7099,7 +7099,7 @@
7099 {
7100 "slug": "SLACK_READ_AUDIT_LOGS",
7101 "name": "Read Audit Logs",
7102 - "description": "Read Slack Enterprise Grid Audit Logs (logins, admin changes, app installs, channel/privacy changes, etc.) with server-side filters and pagination. Requires Enterprise Grid organization with auditlogs:read scope and a user token (xoxp-...) from an owner/admin context."
7102 + "description": "Reads Slack Enterprise audit logs with filters and pagination. Requires an organization-installed token with auditlogs:read; returned entity details may be incomplete."
7103 },
7104 {
7105 "slug": "SLACK_REMOVE_CALL_PARTICIPANTS",
@@ -7154,7 +7154,7 @@
7154 {
7155 "slug": "SLACK_RESET_USER_SESSIONS",
7156 "name": "Reset user sessions",
7157 - "description": "Tool to wipe all valid sessions on all devices for a given user. Use when you need to force a user to re-authenticate due to security concerns or account changes."
7157 + "description": "Resets a user's Slack sessions to force re-authentication, with optional filters to expire only mobile or only web sessions."
7158 },
7159 {
7160 "slug": "SLACK_RESTRICT_APP_INSTALLATION",
@@ -7169,7 +7169,7 @@
7169 {
7170 "slug": "SLACK_RETRIEVE_CONVERSATION_INFORMATION",
7171 "name": "Retrieve conversation information",
7172 - "description": "Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date, with options for member count/locale), excluding message content. The `channel` parameter is effectively required. Private channels, DMs, or channels where the app lacks membership may return restricted data; check `is_archived` and `is_member` fields in the response to diagnose access issues. Bulk lookups may trigger HTTP 429 rate limiting; honor the `Retry-After` response header."
7172 + "description": "Retrieves metadata for a Slack conversation by ID, including name, purpose and creation date, with options for member count and locale. Returned fields vary by conversation type and access."
7173 },
7174 {
7175 "slug": "SLACK_RETRIEVE_CONVERSATION_MEMBERS_LIST",
@@ -7204,7 +7204,7 @@
7204 {
7205 "slug": "SLACK_REVOKE_FILE_PUBLIC_SHARING",
7206 "name": "Revoke a file's public url",
7207 - "description": "Revokes a Slack file's public URL, making it private; this is a no-op if not already public and is irreversible."
7207 + "description": "Revokes public or external sharing access for a Slack file by its file ID."
7208 },
7209 {
7210 "slug": "SLACK_RTM_CONNECT",
@@ -7214,12 +7214,12 @@
7214 {
7215 "slug": "SLACK_RTM_START",
7216 "name": "Start RTM session",
7217 - "description": "Starts a Real Time Messaging API session for Slack. Use when you need to establish an RTM connection with additional options beyond rtm.connect. Note: RTM API is deprecated; consider Socket Mode for new apps."
7217 + "description": "Starts a legacy Slack Real Time Messaging session via rtm.start and returns connection information. The method is deprecated, returns the rtm.connect response for existing apps, and is unavailable to newly created apps."
7218 },
7219 {
7220 "slug": "SLACK_SCHEDULE_MESSAGE",
7221 "name": "Schedule message",
7222 - "description": "Schedules a message to a Slack channel, DM, or private group for a future time (`post_at`), requiring `text`, `blocks`, or `attachments` for content; scheduling is limited to 120 days in advance."
7222 + "description": "Schedules a message to a Slack channel, DM, or private group for a future time, up to 120 days in advance. Content can be supplied as Markdown, text, blocks, or attachments; Markdown is converted to blocks."
7223 },
7224 {
7225 "slug": "SLACK_SCIM_GET_CONFIG",
@@ -7259,7 +7259,7 @@
7259 {
7260 "slug": "SLACK_SET_ADMIN_USER",
7261 "name": "Set admin user",
7262 - "description": "Promotes an existing workspace member (guest, regular user, or owner) to admin status. Use when you need to grant admin privileges to a user."
7262 + "description": "Sets an existing regular user or owner as an admin in a Slack workspace."
7263 },
7264 {
7265 "slug": "SLACK_SET_CONVERSATION_PREFS",
@@ -7404,7 +7404,7 @@
7404 {
7405 "slug": "SLACK_UPDATE_USER_GROUP_MEMBERS",
7406 "name": "Update user group members",
7407 - "description": "Replaces all members of an existing Slack User Group with a new list of valid user IDs."
7407 + "description": "Replaces the members of an existing Slack User Group with a complete list of user IDs. The list cannot be empty; guests and bot users cannot be added."
7408 },
7409 {
7410 "slug": "SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK",
@@ -7545,14 +7545,19 @@
7545 "composioManagedAuthSchemes": [
7546 "OAUTH2"
7547 ],
7548 - "toolCount": 133,
7548 + "toolCount": 235,
7549 "triggerCount": 0,
7550 - "version": "20261029_00",
7550 + "version": "20261103_00",
7551 "tools": [
7552 + {
7553 + "slug": "SUPABASE_ACCEPT_INVITE_EXTERNAL_JIT_ACCESS",
7554 + "name": "Accept Invite External Jit Access",
7555 + "description": "Accept an invitation for JIT database access."
7556 + },
7557 {
7558 "slug": "SUPABASE_ALPHA_CREATE_API_KEY",
7559 "name": "Create project api key",
7555 - "description": "Creates a 'publishable' or 'secret' API key for an existing Supabase project, optionally with a description; 'secret' keys can have customized JWT templates."
7560 + "description": "Creates a publishable or secret API key for an existing Supabase project, optionally with a description."
7561 },
7562 {
7563 "slug": "SUPABASE_ALPHA_DELETE_API_KEY",
@@ -7577,12 +7582,32 @@
7582 {
7583 "slug": "SUPABASE_ALPHA_UPDATE_API_KEY",
7584 "name": "Update an API key for the project",
7580 - "description": "Updates an existing Supabase project API key's `description` and/or `secret_jwt_template` (which defines its `role`); does not regenerate the key string."
7585 + "description": "Updates the description of an existing Supabase project API key without regenerating the key string."
7586 + },
7587 + {
7588 + "slug": "SUPABASE_APPEND_RESUMABLE_UPLOAD",
7589 + "name": "Append Resumable Upload",
7590 + "description": "Append data to a TUS resumable upload. Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
7591 + },
7592 + {
7593 + "slug": "SUPABASE_APPEND_RESUMABLE_UPLOAD_SIGNED",
7594 + "name": "Append Resumable Upload Signed",
7595 + "description": "Append data to a signed resumable upload. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
7596 },
7597 {
7598 "slug": "SUPABASE_APPLY_A_MIGRATION",
7599 "name": "Apply a database migration",
7585 - "description": "Tool to apply database migrations to a Supabase project. Use when you need to execute SQL schema changes, create tables, alter columns, or run other DDL/DML operations as part of a tracked migration. This is a Beta feature in the Supabase Management API."
7600 + "description": "Applies a tracked SQL database migration to a Supabase project, for schema changes or other DDL/DML operations. You can provide a migration name, rollback SQL, and an idempotency key to help prevent duplicate tracking."
7601 + },
7602 + {
7603 + "slug": "SUPABASE_APPLY_PROJECT_ADDON",
7604 + "name": "Apply Project Addon",
7605 + "description": "Apply or update billing addons and compute instance size. Changes may affect billing; inspect the project plan before modifying addons."
7606 + },
7607 + {
7608 + "slug": "SUPABASE_AUTHORIZE_JIT_ACCESS",
7609 + "name": "Authorize Jit Access",
7610 + "description": "Authorize user-to-role mappings for JIT access."
7611 },
7612 {
7613 "slug": "SUPABASE_BETA_ACTIVATE_CUSTOM_HOSTNAME",
@@ -7597,17 +7622,17 @@
7622 {
7623 "slug": "SUPABASE_BETA_AUTHORIZE_USER_THROUGH_OAUTH",
7624 "name": "Authorize user through OAuth",
7600 - "description": "Generates a Supabase OAuth 2.0 authorization URL for user redirection. IMPORTANT: This action requires a pre-registered OAuth client_id and a redirect_uri that matches one of the pre-registered URIs for that OAuth application. Without a valid registered OAuth application, this endpoint will return a 400 error. To use this action: 1. Register an OAuth application in the Supabase dashboard 2. Use the client_id from the registered application 3. Ensure redirect_uri matches one of the registered callback URLs"
7625 + "description": "Requests Supabase OAuth 2.0 authorization for a registered application and returns the redirect location when the endpoint responds with a redirect, or status and error information otherwise."
7626 },
7627 {
7628 "slug": "SUPABASE_BETA_CHECK_VANITY_SUBDOMAIN_AVAILABILITY",
7629 "name": "Check vanity subdomain availability",
7605 - "description": "Checks if a specific vanity subdomain is available for a Supabase project; this action does not reserve or assign the subdomain."
7630 + "description": "Checks whether a vanity subdomain is available for a Supabase project without reserving or assigning it. The endpoint requires a Pro, Team, or Enterprise organization plan."
7631 },
7632 {
7633 "slug": "SUPABASE_BETA_CREATE_READ_REPLICA",
7634 "name": "Setup read replica for project",
7610 - "description": "Provisions a read-only replica for a Supabase project in a specified, Supabase-supported AWS region to enhance read performance and reduce latency."
7635 + "description": "Provisions a read-only replica for a Supabase project in a specified supported AWS region to enhance read performance and reduce latency. This beta feature requires a Pro, Team, or Enterprise organization plan."
7636 },
7637 {
7638 "slug": "SUPABASE_BETA_ENABLE_DATABASE_WEBHOOKS",
@@ -7627,7 +7652,7 @@
7652 {
7653 "slug": "SUPABASE_BETA_GET_PROJECT_NETWORK_RESTRICTIONS",
7654 "name": "Get project network restrictions",
7630 - "description": "Retrieves the network restriction settings (IP allowlists) for a Supabase project. Use this action to: - Check which IPv4/IPv6 CIDR blocks are allowed to connect to the project's database - Verify if network restrictions are enabled (entitlement: \"allowed\") or disabled (\"disallowed\") - Audit current network security configuration - Check if network restrictions have been modified (old_config present) Note: Default values 0.0.0.0/0 (IPv4) and ::/0 (IPv6) mean all IPs are allowed. Network restrictions require a Pro, Team, or Enterprise plan."
7655 + "description": "Retrieves a Supabase project's network restriction settings, including IPv4 and IPv6 CIDR allowlists, entitlement, and application status. The response may also include the previous configuration while a change is pending."
7656 },
7657 {
7658 "slug": "SUPABASE_BETA_GET_PROJECT_PGSODIUM_CONFIG",
@@ -7642,7 +7667,7 @@
7667 {
7668 "slug": "SUPABASE_BETA_GET_VANITY_SUBDOMAIN_CONFIG",
7669 "name": "Get current vanity subdomain config",
7645 - "description": "Fetches the current vanity subdomain configuration, including its status and custom domain name, for a Supabase project identified by its reference ID."
7670 + "description": "Fetches the current vanity subdomain configuration for a Supabase project, including its status and any custom domain name. The endpoint requires a Pro, Team, or Enterprise organization plan."
7671 },
7672 {
7673 "slug": "SUPABASE_BETA_REMOVE_NETWORK_BANS",
@@ -7652,28 +7677,48 @@
7677 {
7678 "slug": "SUPABASE_BETA_REMOVE_READ_REPLICA",
7679 "name": "Remove read replica",
7655 - "description": "Remove a read replica from a Supabase project (Pro plan or higher required). This beta endpoint initiates the removal of a specified read replica database. The operation is irreversible. Before removal, ensure all application traffic is redirected from the replica to the primary database. Requirements: - Project must be on Pro plan or higher - Bearer token with infra_read_replicas_write permission (FGA) - Valid read replica database identifier Note: Returns 201 on success with an empty response body."
7680 + "description": "Initiates removal of a specified read replica database from a Supabase project. This beta operation requires a valid replica identifier and permission to manage read replicas; redirect application traffic before removal."
7681 },
7682 {
7683 "slug": "SUPABASE_BETA_RUN_SQL_QUERY",
7684 "name": "Execute project database query",
7660 - "description": "Executes a given SQL query against the project's database; use for advanced data operations or when standard API endpoints are insufficient, ensuring queries are valid PostgreSQL and sanitized. Use the get_table_schemas or generate_type_script_types tool to retrieve the table schema, then base your query on it."
7685 + "description": "Executes PostgreSQL queries against a Supabase project's database for data retrieval, modification, or schema operations. Read-only mode does not prevent detected INSERT, UPDATE, or DELETE statements from making changes."
7686 },
7687 {
7688 "slug": "SUPABASE_BETA_UPDATE_PROJECT_NETWORK_RESTRICTIONS",
7689 "name": "Beta update project network restrictions",
7665 - "description": "Updates and applies network access restrictions (IPv4/IPv6 CIDR lists) for a Supabase project, which may terminate existing connections not matching the new rules."
7690 + "description": "Updates network access restrictions (IPv4/IPv6 CIDR lists) for a Supabase project. Changes may terminate existing connections that do not match the new rules; the returned status indicates whether the configuration is stored or applied."
7691 },
7692 {
7693 "slug": "SUPABASE_BETA_UPGRADE_PROJECT_POSTGRES_VERSION",
7694 "name": "Upgrade the project's PostgreSQL version",
7695 "description": "Initiates an asynchronous upgrade of a Supabase project's PostgreSQL database to a specified `target_version` from a selected `release_channel`, returning a `tracking_id` to monitor status; the `target_version` must be available in the chosen channel."
7696 },
7697 + {
7698 + "slug": "SUPABASE_CANCEL_PROJECT_RESTORATION",
7699 + "name": "Cancel Project Restoration",
7700 + "description": "Cancel project restoration."
7701 + },
7702 + {
7703 + "slug": "SUPABASE_COPY_STORAGE_OBJECT",
7704 + "name": "Copy Storage Object",
7705 + "description": "Copy an object. Uses a secret/service-role project key and bypasses Row Level Security."
7706 + },
7707 {
7708 "slug": "SUPABASE_COUNT_ACTION_RUNS",
7709 "name": "Count action runs",
7710 "description": "Counts the number of action runs for a Supabase project using a HEAD request. Use this when you need to retrieve the total count of action runs without fetching the full list of runs."
7711 },
7712 + {
7713 + "slug": "SUPABASE_COUNT_FUNCTION_RESULTS",
7714 + "name": "Count Function Results",
7715 + "description": "Count rows from a known exposed table-valued function using HEAD, without a body. PostgREST enforces a read-only transaction; functions attempting database writes fail. Uses an elevated secret/service_role key that bypasses Row Level Security. OAuth requires secrets:read; fine-grained PATs require api_gateway_keys_read and api_gateway_keys_secret_read for project-key discovery. Not for scalar functions."
7716 + },
7717 + {
7718 + "slug": "SUPABASE_COUNT_TABLE_ROWS",
7719 + "name": "Count Table Rows",
7720 + "description": "Count matching rows in an exposed table or view without downloading rows. Uses an elevated secret/service-role key and bypasses Row Level Security. OAuth requires secrets:read; fine-grained personal access tokens require api_gateway_keys_read and api_gateway_keys_secret_read."
7721 + },
7722 {
7723 "slug": "SUPABASE_CREATE_A_PROJECT",
7724 "name": "Create new project",
@@ -7682,7 +7727,7 @@
7727 {
7728 "slug": "SUPABASE_CREATE_BULK_SECRETS",
7729 "name": "Bulk create secrets",
7685 - "description": "Tool to bulk create secrets for a Supabase project. Use when you need to create multiple project secrets at once. Each secret name must not start with SUPABASE_."
7730 + "description": "Bulk creates secrets for a Supabase project. Secret names must not start with SUPABASE_; leading and trailing whitespace is stripped from names and values before submission."
7731 },
7732 {
7733 "slug": "SUPABASE_CREATE_DATABASE_BRANCH",
@@ -7707,7 +7752,27 @@
7752 {
7753 "slug": "SUPABASE_CREATE_PROJECT_SIGNING_KEY",
7754 "name": "Create project signing key",
7710 - "description": "Create a new signing key for JWT authentication in a Supabase project. The key is created in standby status by default and must be activated separately."
7755 + "description": "Create a new JWT signing key for a Supabase project, with an optional initial standby or in-use status."
7756 + },
7757 + {
7758 + "slug": "SUPABASE_CREATE_RESUMABLE_UPLOAD",
7759 + "name": "Create Resumable Upload",
7760 + "description": "Create a TUS resumable upload. Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
7761 + },
7762 + {
7763 + "slug": "SUPABASE_CREATE_RESUMABLE_UPLOAD_SIGNED",
7764 + "name": "Create Resumable Upload Signed",
7765 + "description": "Create a signed TUS resumable upload. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
7766 + },
7767 + {
7768 + "slug": "SUPABASE_CREATE_SIGNED_DOWNLOAD_URL",
7769 + "name": "Create Signed Download Url",
7770 + "description": "Generate a time-limited download capability for an object. Uses privileged project-key discovery; protect the returned URL."
7771 + },
7772 + {
7773 + "slug": "SUPABASE_CREATE_SIGNED_DOWNLOAD_URLS",
7774 + "name": "Create Signed Download Urls",
7775 + "description": "Generate time-limited download capabilities for multiple objects. Uses privileged project-key discovery; protect the returned URLs."
7776 },
7777 {
7778 "slug": "SUPABASE_CREATE_SIGNED_UPLOAD_URL",
@@ -7719,6 +7784,11 @@
7784 "name": "Create SSO provider configuration",
7785 "description": "Creates a new SAML 2.0 Single Sign-On (SSO) provider for a Supabase project, requiring either `metadata_xml` or `metadata_url` for SAML IdP configuration."
7786 },
7787 + {
7788 + "slug": "SUPABASE_CREATE_STORAGE_BUCKET",
7789 + "name": "Create Storage Bucket",
7790 + "description": "Create a Storage bucket. Uses a secret/service-role project key and bypasses Row Level Security."
7791 + },
7792 {
7793 "slug": "SUPABASE_CREATE_THIRD_PARTY_AUTH_INTEGRATION",
7794 "name": "Create a new third-party auth integration",
@@ -7729,6 +7799,11 @@
7799 "name": "Delete all branches",
7800 "description": "Disables preview branching for a Supabase project, which deletes all remaining branches. IMPORTANT: Before calling this endpoint, you must manually delete all non-default branches. The API will reject the request with a 422 error if non-default branches exist. Use this action when you need to completely disable the preview branching feature for a project. This action is irreversible - all branches will be permanently removed and preview branching will be disabled. Requirements: - Preview branching must be enabled on the project - All non-default branches must be deleted first - Project must be on Pro plan or above to have preview branching"
7801 },
7802 + {
7803 + "slug": "SUPABASE_DELETE_BUCKET_LIFECYCLE",
7804 + "name": "Delete Bucket Lifecycle",
7805 + "description": "Delete bucket lifecycle configuration. Uses a secret/service-role project key and bypasses Row Level Security."
7806 + },
7807 {
7808 "slug": "SUPABASE_DELETE_CUSTOM_HOSTNAME_CONFIG",
7809 "name": "Delete custom hostname config",
@@ -7749,6 +7824,16 @@
7824 "name": "Delete an edge function by slug",
7825 "description": "Permanently deletes a specific Edge Function (by `function_slug`) from a Supabase project (by `ref`); this action is irreversible and requires prior existence of both project and function."
7826 },
7827 + {
7828 + "slug": "SUPABASE_DELETE_INVITE_EXTERNAL_JIT_ACCESS",
7829 + "name": "Delete Invite External Jit Access",
7830 + "description": "Delete an external user's JIT invitation."
7831 + },
7832 + {
7833 + "slug": "SUPABASE_DELETE_JIT_ACCESS",
7834 + "name": "Delete Jit Access",
7835 + "description": "Delete JIT access by user ID."
7836 + },
7837 {
7838 "slug": "SUPABASE_DELETE_LOGIN_ROLES",
7839 "name": "Delete CLI login roles",
@@ -7774,6 +7859,26 @@
7859 "name": "Remove an SSO provider",
7860 "description": "Deletes a specific SSO provider by its ID (`provider_id`) from a Supabase project (`ref`), which disables it and returns its details; ensure this action will not inadvertently lock out users."
7861 },
7862 + {
7863 + "slug": "SUPABASE_DELETE_STORAGE_BUCKET",
7864 + "name": "Delete Storage Bucket",
7865 + "description": "Delete a bucket. Uses a secret/service-role project key and bypasses Row Level Security."
7866 + },
7867 + {
7868 + "slug": "SUPABASE_DELETE_STORAGE_OBJECT",
7869 + "name": "Delete Storage Object",
7870 + "description": "Delete a Storage object. Uses a secret/service-role project key and bypasses Row Level Security."
7871 + },
7872 + {
7873 + "slug": "SUPABASE_DELETE_STORAGE_OBJECTS",
7874 + "name": "Delete Storage Objects",
7875 + "description": "Delete multiple objects. Uses a secret/service-role project key and bypasses Row Level Security."
7876 + },
7877 + {
7878 + "slug": "SUPABASE_DELETE_TABLE_ROWS",
7879 + "name": "Delete Table Rows",
7880 + "description": "Permanently delete matching rows from an exposed Supabase table or view. Uses an elevated secret/service_role project key, bypassing Row Level Security. Requires filters unless allow_all_rows explicitly permits an unfiltered delete. OAuth needs secrets:read; fine-grained PATs need api_gateway_keys_read and api_gateway_keys_secret_read to reveal the project key."
7881 + },
7882 {
7883 "slug": "SUPABASE_DEPLOY_FUNCTION",
7884 "name": "Deploy function",
@@ -7792,7 +7897,27 @@
7897 {
7898 "slug": "SUPABASE_DOWNLOAD_PRIVATE_OBJECT",
7899 "name": "Download private object",
7795 - "description": "Download authorized bytes from an object in private Supabase Storage."
7900 + "description": "Downloads an object from a private Supabase Storage bucket and returns its bytes as base64 with selected metadata. Choose anon or service-role authorization; anon access requires an allowing storage policy, while service-role access bypasses row-level security. An object version and download filename can optionally be specified."
7901 + },
7902 + {
7903 + "slug": "SUPABASE_DOWNLOAD_PUBLIC_OBJECT",
7904 + "name": "Download Public Object",
7905 + "description": "Retrieve an object from a public bucket."
7906 + },
7907 + {
7908 + "slug": "SUPABASE_DOWNLOAD_SIGNED_OBJECT",
7909 + "name": "Download Signed Object",
7910 + "description": "Retrieve an object using a presigned URL."
7911 + },
7912 + {
7913 + "slug": "SUPABASE_DOWNLOAD_STORAGE_OBJECT",
7914 + "name": "Download Storage Object",
7915 + "description": "Retrieve a Storage object. Uses a secret/service-role project key and bypasses Row Level Security."
7916 + },
7917 + {
7918 + "slug": "SUPABASE_EMPTY_STORAGE_BUCKET",
7919 + "name": "Empty Storage Bucket",
7920 + "description": "Empty a bucket. Uses a secret/service-role project key and bypasses Row Level Security."
7921 },
7922 {
7923 "slug": "SUPABASE_EXCHANGE_OAUTH_TOKEN",
@@ -7817,28 +7942,78 @@
7942 {
7943 "slug": "SUPABASE_GET_AUTH_CONFIG",
7944 "name": "Get project auth config",
7820 - "description": "Retrieves the complete authentication configuration for a Supabase project. Use this action when you need to inspect auth settings, OAuth provider configurations, MFA policies, email/SMS templates, security policies, or webhook hooks. Returns all auth configuration fields including enabled providers (Apple, Google, GitHub, etc.), JWT settings, rate limits, password requirements, session policies, and mailer configuration. This is a read-only operation that does not modify any settings."
7945 + "description": "Retrieves a Supabase project's authentication settings for read-only inspection, including supported provider configurations, MFA policies, email and SMS templates, security settings, and hooks. The returned configuration may not include every field supplied by the API."
7946 + },
7947 + {
7948 + "slug": "SUPABASE_GET_AUTHENTICATED_IMAGE_HEADERS",
7949 + "name": "Get Authenticated Image Headers",
7950 + "description": "Get authenticated image transformation headers. Uses a secret/service-role project key and bypasses Row Level Security."
7951 + },
7952 + {
7953 + "slug": "SUPABASE_GET_AUTHENTICATED_OBJECT_HEADERS",
7954 + "name": "Get Authenticated Object Headers",
7955 + "description": "Retrieve authenticated object information headers. Uses a secret/service-role project key and bypasses Row Level Security."
7956 + },
7957 + {
7958 + "slug": "SUPABASE_GET_AUTHENTICATED_OBJECT_INFO",
7959 + "name": "Get Authenticated Object Info",
7960 + "description": "Retrieve authenticated object information. Uses a secret/service-role project key and bypasses Row Level Security."
7961 + },
7962 + {
7963 + "slug": "SUPABASE_GET_AUTHENTICATED_OBJECT_INFO_HEADERS",
7964 + "name": "Get Authenticated Object Info Headers",
7965 + "description": "Get authenticated object information headers. Uses a secret/service-role project key and bypasses Row Level Security."
7966 },
7967 {
7968 "slug": "SUPABASE_GET_AVAILABLE_REGIONS",
7969 "name": "Get Available Regions",
7970 "description": "Tool to get the list of available regions for creating a new Supabase project. Use when you need to determine which regions are available for project deployment, or to get region recommendations based on geographic location and instance size requirements. Note: This is a Beta endpoint."
7971 },
7972 + {
7973 + "slug": "SUPABASE_GET_BACKUP_SCHEDULE",
7974 + "name": "Get Backup Schedule",
7975 + "description": "Get the project's backup schedule."
7976 + },
7977 {
7978 "slug": "SUPABASE_GET_BRANCH",
7979 "name": "Get a database branch",
7980 "description": "Retrieves detailed information about a specific database branch by its name and project reference. Use this to check branch status, configuration, and metadata before performing operations on the branch."
7981 },
7982 + {
7983 + "slug": "SUPABASE_GET_BUCKET_LIFECYCLE",
7984 + "name": "Get Bucket Lifecycle",
7985 + "description": "Get bucket lifecycle configuration. Uses a secret/service-role project key and bypasses Row Level Security."
7986 + },
7987 + {
7988 + "slug": "SUPABASE_GET_BUCKET_LIFECYCLE_HEADERS",
7989 + "name": "Get Bucket Lifecycle Headers",
7990 + "description": "Get bucket lifecycle response headers. Uses a secret/service-role project key and bypasses Row Level Security."
7991 + },
7992 {
7993 "slug": "SUPABASE_GET_DATABASE_BRANCH_CONFIG",
7994 "name": "Get database branch config",
7995 "description": "Retrieves the read-only configuration and status for a Supabase database branch, typically for monitoring or verifying its settings."
7996 },
7997 + {
7998 + "slug": "SUPABASE_GET_DATABASE_DISK",
7999 + "name": "Get Database Disk",
8000 + "description": "Get database disk attributes."
8001 + },
8002 {
8003 "slug": "SUPABASE_GET_DATABASE_METADATA",
8004 "name": "Get Database Metadata",
8005 "description": "Gets database metadata for the given project. Returns information about databases, schemas, and tables structure. Note: This endpoint is deprecated and may be removed in future versions."
8006 },
8007 + {
8008 + "slug": "SUPABASE_GET_DATABASE_OPENAPI",
8009 + "name": "Get Database Openapi",
8010 + "description": "Get the project's PostgREST OpenAPI specification."
8011 + },
8012 + {
8013 + "slug": "SUPABASE_GET_DISK_UTILIZATION",
8014 + "name": "Get Disk Utilization",
8015 + "description": "Get disk utilization."
8016 + },
8017 {
8018 "slug": "SUPABASE_GET_FUNCTION",
8019 "name": "Retrieve a function",
@@ -7847,22 +8022,27 @@
8022 {
8023 "slug": "SUPABASE_GET_FUNCTION_BODY",
8024 "name": "Retrieve a function body",
7850 - "description": "Retrieves the source code (body) for a specified serverless Edge Function using its project reference and function slug; this is a read-only operation that does not execute the function or return runtime logs."
8025 + "description": "Retrieves the body of a specified Supabase Edge Function using its project reference and function slug. This read-only operation does not execute the function or return runtime logs."
8026 },
8027 {
8028 "slug": "SUPABASE_GET_HEALTH",
8029 "name": "Get API Health Status",
7855 - "description": "Tool to check the health status of the Supabase API. Use when you need to verify API availability or troubleshoot connectivity issues."
8030 + "description": "Checks the Supabase API for availability, helping diagnose connectivity issues."
8031 + },
8032 + {
8033 + "slug": "SUPABASE_GET_JIT_ACCESS",
8034 + "name": "Get Jit Access",
8035 + "description": "Get user-to-role mappings for JIT database access."
8036 },
8037 {
8038 "slug": "SUPABASE_GET_JIT_ACCESS_CONFIG",
8039 "name": "Get JIT access config",
7860 - "description": "[Beta] Retrieves the project's just-in-time (JIT) access configuration, including user roles and their expiration settings. Use this to check temporary access grants and their validity periods."
8040 + "description": "Retrieves a Supabase project's just-in-time (JIT) access configuration state using the beta endpoint."
8041 },
8042 {
8043 "slug": "SUPABASE_GET_LEGACY_SIGNING_KEY",
8044 "name": "Get legacy signing key",
7865 - "description": "Retrieves the signing key information for the JWT secret imported as signing key for this project. This endpoint is deprecated and will be removed in the future; check for HTTP 404 Not Found which indicates the endpoint is no longer available."
8045 + "description": "Deprecated by the provider; no sunset date or replacement is announced. Retrieve signing key information for the project's imported JWT secret. The endpoint may return HTTP 404 when unavailable. Behavior is unchanged."
8046 },
8047 {
8048 "slug": "SUPABASE_GET_MIGRATION",
@@ -7874,15 +8054,25 @@
8054 "name": "Get information about an organization",
8055 "description": "Fetches comprehensive details for a specific Supabase organization using its unique slug."
8056 },
8057 + {
8058 + "slug": "SUPABASE_GET_ORGANIZATION_ENTITLEMENTS",
8059 + "name": "Get Organization Entitlements",
8060 + "description": "Get organization entitlements."
8061 + },
8062 {
8063 "slug": "SUPABASE_GET_PERFORMANCE_ADVISORS",
8064 "name": "Get performance advisors",
8065 "description": "Retrieves project performance advisors for a Supabase project. Returns a list of performance lints that identify potential issues and optimization opportunities. Note: This endpoint is deprecated."
8066 },
8067 + {
8068 + "slug": "SUPABASE_GET_PROFILE",
8069 + "name": "Get Profile",
8070 + "description": "Get the user's profile."
8071 + },
8072 {
8073 "slug": "SUPABASE_GET_PROJECT",
8074 "name": "Get project",
7885 - "description": "Retrieves detailed information about a specific Supabase project by its unique reference ID. Use when you need to get comprehensive project details including status, database configuration, and metadata. Authentication: - Requires a valid Bearer token in the Authorization header. - Token format: 'Bearer <access_token>' where access_token is either: - A Personal Access Token (PAT) generated from https://supabase.com/dashboard/account/tokens - An OAuth2 access token with the 'project_admin_read' scope Required Scope: - project_admin_read: Allows retrieval of project information. Returns: Project object containing id, ref, name, organization details, region, status, database configuration, and created_at timestamp."
8075 + "description": "Retrieves detailed information about a Supabase project by reference ID, including its status, database configuration, organization, region, and creation timestamp. Requires a Management API bearer token with appropriate project read access."
8076 },
8077 {
8078 "slug": "SUPABASE_GET_PROJECT_API_KEY",
@@ -7894,10 +8084,25 @@
8084 "name": "Get project API keys",
8085 "description": "Retrieves all API keys for an existing Supabase project, specified by its unique reference ID (`ref`); this is a read-only operation."
8086 },
8087 + {
8088 + "slug": "SUPABASE_GET_PROJECT_CONFIG",
8089 + "name": "Get project config",
8090 + "description": "Retrieve a project's consolidated effective database, pooler, Auth, Data API, Realtime, and Storage configuration. This Supabase Management API endpoint is Alpha and currently supports Personal Access Tokens (PATs) only; Supabase OAuth access tokens are not supported."
8091 + },
8092 + {
8093 + "slug": "SUPABASE_GET_PROJECT_DISK_AUTOSCALE_CONFIG",
8094 + "name": "Get Project Disk Autoscale Config",
8095 + "description": "Get disk autoscale configuration."
8096 + },
8097 + {
8098 + "slug": "SUPABASE_GET_PROJECT_FUNCTION_COMBINED_STATS",
8099 + "name": "Get Project Function Combined Stats",
8100 + "description": "Get combined function statistics."
8101 + },
8102 {
8103 "slug": "SUPABASE_GET_PROJECT_LEGACY_API_KEYS",
8104 "name": "Get project legacy API keys status",
7900 - "description": "Checks whether JWT-based legacy API keys (anon, service_role) are enabled for a Supabase project. This API endpoint is deprecated and may be removed in the future (returns HTTP 404 Not Found when unavailable)."
8105 + "description": "Deprecated by the provider; no sunset date or replacement is announced. Checks whether JWT-based legacy API keys (anon, service_role) are enabled. The endpoint may return HTTP 404 when unavailable. Behavior is unchanged."
8106 },
8107 {
8108 "slug": "SUPABASE_GET_PROJECT_LOGS",
@@ -7949,6 +8154,36 @@
8154 "name": "Get project upgrade status",
8155 "description": "Retrieves the latest status of a Supabase project's database upgrade for monitoring purposes; does not initiate or modify upgrades."
8156 },
8157 + {
8158 + "slug": "SUPABASE_GET_PROJECT_USAGE_API_COUNT",
8159 + "name": "Get Project Usage Api Count",
8160 + "description": "Get project usage API counts."
8161 + },
8162 + {
8163 + "slug": "SUPABASE_GET_PROJECT_USAGE_REQUEST_COUNT",
8164 + "name": "Get Project Usage Request Count",
8165 + "description": "Get project usage API request counts."
8166 + },
8167 + {
8168 + "slug": "SUPABASE_GET_PUBLIC_IMAGE_HEADERS",
8169 + "name": "Get Public Image Headers",
8170 + "description": "Get public image transformation headers."
8171 + },
8172 + {
8173 + "slug": "SUPABASE_GET_PUBLIC_OBJECT_HEADERS",
8174 + "name": "Get Public Object Headers",
8175 + "description": "Get public object information headers."
8176 + },
8177 + {
8178 + "slug": "SUPABASE_GET_PUBLIC_OBJECT_INFO",
8179 + "name": "Get Public Object Info",
8180 + "description": "Get public object information."
8181 + },
8182 + {
8183 + "slug": "SUPABASE_GET_REALTIME_CONFIG",
8184 + "name": "Get Realtime Config",
8185 + "description": "Get Realtime configuration."
8186 + },
8187 {
8188 "slug": "SUPABASE_GET_RESUMABLE_UPLOAD_BASE_OPTIONS",
8189 "name": "Get TUS resumable upload base options",
@@ -7959,15 +8194,35 @@
8194 "name": "Get TUS resumable upload options",
8195 "description": "Handles OPTIONS request for TUS Resumable uploads to discover server capabilities. Use when preparing resumable upload requests to verify supported TUS protocol versions and extensions."
8196 },
8197 + {
8198 + "slug": "SUPABASE_GET_RESUMABLE_UPLOAD_STATUS",
8199 + "name": "Get Resumable Upload Status",
8200 + "description": "Get resumable upload offset and metadata. Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
8201 + },
8202 + {
8203 + "slug": "SUPABASE_GET_RESUMABLE_UPLOAD_STATUS_SIGNED",
8204 + "name": "Get Resumable Upload Status Signed",
8205 + "description": "Get signed resumable upload offset and metadata. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
8206 + },
8207 {
8208 "slug": "SUPABASE_GET_SECURITY_ADVISORS",
8209 "name": "Get Security Advisors",
8210 "description": "Retrieves security advisor findings and recommendations for a Supabase project. Use when you need to audit project security posture, identify SQL-based security issues, or get remediation guidance. Note: This endpoint is deprecated and may be removed in future API versions."
8211 },
8212 + {
8213 + "slug": "SUPABASE_GET_SIGNED_IMAGE_HEADERS",
8214 + "name": "Get Signed Image Headers",
8215 + "description": "Get signed image transformation headers."
8216 + },
8217 + {
8218 + "slug": "SUPABASE_GET_SIGNED_OBJECT_HEADERS",
8219 + "name": "Get Signed Object Headers",
8220 + "description": "Get headers for a presigned object retrieval."
8221 + },
8222 {
8223 "slug": "SUPABASE_GETS_PROJECT_S_AUTH_CONFIG",
8224 "name": "Get project's auth config",
7970 - "description": "Retrieves the project's complete read-only authentication configuration, detailing all settings (e.g., providers, MFA, email/SMS, JWT, security policies) but excluding sensitive secrets."
8225 + "description": "Retrieves a project's authentication configuration, including provider, MFA, email, SMS, JWT and security settings. The response can contain sensitive secrets."
8226 },
8227 {
8228 "slug": "SUPABASE_GETS_PROJECT_S_SERVICE_HEALTH_STATUS",
@@ -7982,22 +8237,77 @@
8237 {
8238 "slug": "SUPABASE_GET_SSO_PROVIDER",
8239 "name": "Get a SSO provider by its UUID",
7985 - "description": "Retrieves the configuration details for a specific Single Sign-On (SSO) provider (e.g., SAML, Google, GitHub, Azure AD), identified by its UUID, within a Supabase project."
8240 + "description": "Retrieves configuration details for a project's SAML Single Sign-On provider by UUID."
8241 + },
8242 + {
8243 + "slug": "SUPABASE_GET_STORAGE_BUCKET",
8244 + "name": "Get Storage Bucket",
8245 + "description": "Get bucket details. Uses a secret/service-role project key and bypasses Row Level Security."
8246 + },
8247 + {
8248 + "slug": "SUPABASE_GET_STORAGE_BUCKET_HEADERS",
8249 + "name": "Get Storage Bucket Headers",
8250 + "description": "Get bucket response headers. Uses a secret/service-role project key and bypasses Row Level Security."
8251 + },
8252 + {
8253 + "slug": "SUPABASE_GET_STORAGE_BUCKET_LIST_HEADERS",
8254 + "name": "Get Storage Bucket List Headers",
8255 + "description": "Get bucket-list response headers. Uses a secret/service-role project key and bypasses Row Level Security."
8256 + },
8257 + {
8258 + "slug": "SUPABASE_GET_STORAGE_CONFIG",
8259 + "name": "Get Storage Config",
8260 + "description": "Get project Storage configuration."
8261 + },
8262 + {
8263 + "slug": "SUPABASE_GET_STORAGE_HEALTH",
8264 + "name": "Get Storage Health",
8265 + "description": "Check the Storage service health, distinct from Management API health."
8266 + },
8267 + {
8268 + "slug": "SUPABASE_GET_STORAGE_HEALTH_HEADERS",
8269 + "name": "Get Storage Health Headers",
8270 + "description": "Get Storage service health response headers."
8271 + },
8272 + {
8273 + "slug": "SUPABASE_GET_STORAGE_OBJECT_HEADERS",
8274 + "name": "Get Storage Object Headers",
8275 + "description": "Retrieve object information headers. Uses a secret/service-role project key and bypasses Row Level Security."
8276 + },
8277 + {
8278 + "slug": "SUPABASE_GET_STORAGE_OBJECT_INFO",
8279 + "name": "Get Storage Object Info",
8280 + "description": "Retrieve object information. Uses a secret/service-role project key and bypasses Row Level Security."
8281 + },
8282 + {
8283 + "slug": "SUPABASE_GET_STORAGE_OBJECT_INFO_HEADERS",
8284 + "name": "Get Storage Object Info Headers",
8285 + "description": "Get object information headers. Uses a secret/service-role project key and bypasses Row Level Security."
8286 },
8287 {
8288 "slug": "SUPABASE_GET_TABLE_SCHEMAS",
8289 "name": "Get Table Schemas",
7990 - "description": "Retrieves column details, types, and constraints for multiple database tables to help debug schema issues and write accurate SQL queries. Use the SUPABASE_LIST_TABLES action first to discover available tables, the fetch their detailed schemas."
8290 + "description": "Retrieve column details, types, primary and unique constraints, and optionally foreign keys for multiple database tables. Some returned metadata uses placeholders, and index information is not fetched."
8291 },
8292 {
8293 "slug": "SUPABASE_HANDLE_RESUMABLE_UPLOAD_SIGN_OPTIONS",
8294 "name": "OPTIONS for resumable upload sign",
7995 - "description": "Handles CORS preflight OPTIONS request for TUS resumable upload signing. Use when preparing cross-origin resumable upload requests to verify allowed methods and headers."
8295 + "description": "Send an OPTIONS request to the TUS resumable upload signing endpoint."
8296 },
8297 {
8298 "slug": "SUPABASE_HANDLE_RESUMABLE_UPLOAD_SIGN_OPTIONS_WITH_ID",
8299 "name": "OPTIONS for resumable upload sign",
8000 - "description": "Handles CORS preflight OPTIONS request for TUS resumable upload signing endpoints. Use when preparing cross-origin resumable upload requests to verify allowed methods and headers."
8300 + "description": "Send an OPTIONS request to a TUS resumable upload signing endpoint for a specified path."
8301 + },
8302 + {
8303 + "slug": "SUPABASE_INSERT_TABLE_ROWS",
8304 + "name": "Insert Table Rows",
8305 + "description": "Insert rows or upsert on primary/UNIQUE keys in an exposed table or view. Uses a secret or service_role project key and bypasses Row Level Security. OAuth needs secrets:read; fine-grained PATs need api_gateway_keys_read and api_gateway_keys_secret_read to reveal project keys. Upserts can overwrite data."
8306 + },
8307 + {
8308 + "slug": "SUPABASE_INVITE_EXTERNAL_JIT_ACCESS",
8309 + "name": "Invite External Jit Access",
8310 + "description": "Invite an external user for JIT database access."
8311 },
8312 {
8313 "slug": "SUPABASE_INVOKE_DATABASE_FUNCTION",
@@ -8009,15 +8319,25 @@
8319 "name": "Invoke Edge Function",
8320 "description": "Tool to invoke a deployed Supabase Edge Function over HTTPS. Use for testing and debugging Edge Functions with configurable method, headers, body, and authentication."
8321 },
8322 + {
8323 + "slug": "SUPABASE_INVOKE_READ_ONLY_FUNCTION",
8324 + "name": "Invoke Read Only Function",
8325 + "description": "Invoke a known exposed Postgres function using GET in a read-only transaction. Not an Edge Function or arbitrary SQL executor. Database writes are rejected by PostgREST's GET transaction mode. Uses a secret/service_role key that bypasses Row Level Security, so reads can expose all rows. External side effects of a function are not prevented by a database read-only transaction. Supports table-valued projection, filters, ordering, pagination, and counts. OAuth needs secrets:read; fine-grained PATs need api_gateway_keys_read and api_gateway_keys_secret_read to reveal project keys."
8326 + },
8327 + {
8328 + "slug": "SUPABASE_LIST_ACTION_RUNS",
8329 + "name": "List Action Runs",
8330 + "description": "List one page of action runs for a project."
8331 + },
8332 {
8333 "slug": "SUPABASE_LIST_ALL_ORGANIZATIONS",
8334 "name": "List all organizations",
8015 - "description": "Lists all organizations (ID and name only) associated with the Supabase account, excluding project details within these organizations."
8335 + "description": "Lists organizations associated with the authenticated Supabase account, returning their IDs, slugs, and names."
8336 },
8337 {
8338 "slug": "SUPABASE_LIST_ALL_PROJECTS",
8339 "name": "List all projects",
8020 - "description": "Retrieves a list of all Supabase projects, including their ID, name, region, and status, for the authenticated user. Authentication: - Requires a valid Bearer token in the Authorization header. - Token format: 'Bearer <access_token>' where access_token is either: - A Personal Access Token (PAT) generated from https://supabase.com/dashboard/account/tokens - An OAuth2 access token with the 'Projects.Read' scope Required Scope: - Projects.Read: Allows retrieval of project metadata. Returns: List of Project objects containing id, name, organization_id, region, status, database info, and created_at."
8340 + "description": "Lists Supabase projects for the authenticated user, including project ID, name, organization ID, region, status, database information, and creation time. OAuth access requires the projects:read scope."
8341 },
8342 {
8343 "slug": "SUPABASE_LIST_BACKUPS",
@@ -8044,6 +8364,11 @@
8364 "name": "List all functions",
8365 "description": "Lists metadata for all Edge Functions in a Supabase project (specified by 'ref'), excluding function code or logs; the project must exist."
8366 },
8367 + {
8368 + "slug": "SUPABASE_LIST_JIT_ACCESS",
8369 + "name": "List Jit Access",
8370 + "description": "List all user-to-role mappings for JIT access."
8371 + },
8372 {
8373 "slug": "SUPABASE_LIST_MIGRATION_HISTORY",
8374 "name": "List migration history",
@@ -8054,6 +8379,21 @@
8379 "name": "List members of an organization",
8380 "description": "Retrieves all members of a Supabase organization, identified by its unique slug, including their user ID, username, email, role, and MFA status."
8381 },
8382 + {
8383 + "slug": "SUPABASE_LIST_ORGANIZATION_PROJECTS",
8384 + "name": "List Organization Projects",
8385 + "description": "List one page of projects for an organization."
8386 + },
8387 + {
8388 + "slug": "SUPABASE_LIST_PROJECT_ADDONS",
8389 + "name": "List Project Addons",
8390 + "description": "List billing addons and compute instance selections. Changes may affect billing; inspect the project plan before modifying addons."
8391 + },
8392 + {
8393 + "slug": "SUPABASE_LIST_PROJECT_RESTORE_VERSIONS",
8394 + "name": "List Project Restore Versions",
8395 + "description": "List available restore versions for a project."
8396 + },
8397 {
8398 "slug": "SUPABASE_LIST_PROJECT_SECRETS",
8399 "name": "List project secrets",
@@ -8067,22 +8407,52 @@
8407 {
8408 "slug": "SUPABASE_LIST_SQL_SNIPPETS",
8409 "name": "List SQL snippets for the logged in user",
8070 - "description": "Retrieves a list of SQL snippets for the logged-in user, optionally filtered by a specific Supabase project if `project_ref` is provided."
8410 + "description": "Retrieves the first page of SQL snippets for the logged-in user, optionally filtered by Supabase project. The response may contain a pagination cursor, but this tool cannot request subsequent pages."
8411 },
8412 {
8413 "slug": "SUPABASE_LIST_SSO_PROVIDERS",
8414 "name": "List all SSO providers",
8415 "description": "Lists all configured Single Sign-On (SSO) providers for a Supabase project, requiring the project reference ID (`ref`) of an existing project."
8416 },
8417 + {
8418 + "slug": "SUPABASE_LIST_STORAGE_BUCKETS",
8419 + "name": "List Storage Buckets",
8420 + "description": "List Storage buckets through the data-plane API. Uses a secret/service-role project key and bypasses Row Level Security."
8421 + },
8422 + {
8423 + "slug": "SUPABASE_LIST_STORAGE_OBJECTS",
8424 + "name": "List Storage Objects",
8425 + "description": "Search for objects under a prefix. Uses a secret/service-role project key and bypasses Row Level Security."
8426 + },
8427 + {
8428 + "slug": "SUPABASE_LIST_STORAGE_OBJECTS_V2",
8429 + "name": "List Storage Objects V2",
8430 + "description": "Search for objects under a prefix using list v2. Uses a secret/service-role project key and bypasses Row Level Security."
8431 + },
8432 {
8433 "slug": "SUPABASE_LIST_TABLES",
8434 "name": "List Database Tables",
8080 - "description": "Lists all tables and views in specified database schemas, providing a quick overview of database structure to help identify available tables before fetching detailed schemas."
8435 + "description": "Lists tables and optionally views in Supabase database schemas, providing an overview of database structure. Schema discovery can fall back to public, and per-schema failures are reported alongside any partial results."
8436 },
8437 {
8438 "slug": "SUPABASE_MERGE_BRANCH",
8439 "name": "Merge a database branch",
8085 - "description": "Merges a database branch, applying all schema changes and migrations from the branch to the target database. Use this action when you need to promote changes from a database branch to production or another target environment after testing and validation are complete. This operation is irreversible - once merged, the changes cannot be automatically rolled back."
8440 + "description": "Initiates a merge of a database branch into its target database. An optional migration version can limit how far migrations are merged; the response identifies the triggered workflow run."
8441 + },
8442 + {
8443 + "slug": "SUPABASE_MODIFY_DATABASE_DISK",
8444 + "name": "Modify Database Disk",
8445 + "description": "Modify database disk configuration."
8446 + },
8447 + {
8448 + "slug": "SUPABASE_MOVE_STORAGE_OBJECT",
8449 + "name": "Move Storage Object",
8450 + "description": "Move an object. Uses a secret/service-role project key and bypasses Row Level Security."
8451 + },
8452 + {
8453 + "slug": "SUPABASE_OAUTH_AUTHORIZE_PROJECT_CLAIM",
8454 + "name": "Oauth Authorize Project Claim",
8455 + "description": "Initiate OAuth authorization to claim a project. Returns redirect responses without following them; continue the browser flow using headers.location. An authorization redirect does not prove the claim has completed."
8456 },
8457 {
8458 "slug": "SUPABASE_PATCH_MIGRATION",
@@ -8094,40 +8464,140 @@
8464 "name": "Patch project network restrictions",
8465 "description": "Updates project's network restrictions by incrementally adding or removing IPv4/IPv6 CIDR blocks. Use when you need to modify existing restrictions without replacing the entire configuration."
8466 },
8467 + {
8468 + "slug": "SUPABASE_PAUSE_PROJECT",
8469 + "name": "Pause Project",
8470 + "description": "Pause a project, making its services unavailable until it is restored."
8471 + },
8472 + {
8473 + "slug": "SUPABASE_POST_RESUMABLE_UPLOAD",
8474 + "name": "Post Resumable Upload",
8475 + "description": "Create a TUS upload through the wildcard creation route (an alias of base POST). Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
8476 + },
8477 + {
8478 + "slug": "SUPABASE_POST_RESUMABLE_UPLOAD_SIGNED",
8479 + "name": "Post Resumable Upload Signed",
8480 + "description": "Create a signed TUS upload through the wildcard creation route (an alias of base POST). Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
8481 + },
8482 + {
8483 + "slug": "SUPABASE_PURGE_BUCKET_CACHE",
8484 + "name": "Purge Bucket Cache",
8485 + "description": "Purge cache for a bucket or its transformations. Uses a secret/service-role project key and bypasses Row Level Security."
8486 + },
8487 + {
8488 + "slug": "SUPABASE_PURGE_OBJECT_CACHE",
8489 + "name": "Purge Object Cache",
8490 + "description": "Purge cache for an object or its transformations. Uses a secret/service-role project key and bypasses Row Level Security."
8491 + },
8492 + {
8493 + "slug": "SUPABASE_PURGE_STORAGE_CACHE",
8494 + "name": "Purge Storage Cache",
8495 + "description": "Purge cache for the tenant or tenant transformations. Uses a secret/service-role project key and bypasses Row Level Security."
8496 + },
8497 {
8498 "slug": "SUPABASE_PUSH_BRANCH",
8499 "name": "Push a database branch",
8500 "description": "Pushes a database branch, applying migrations and changes to the specified branch. Use when you need to deploy schema changes or migrations to a database branch."
8501 },
8502 + {
8503 + "slug": "SUPABASE_REMOVE_PROJECT_ADDON",
8504 + "name": "Remove Project Addon",
8505 + "description": "Remove billing addons or revert compute sizing. Changes may affect billing; inspect the project plan before modifying addons."
8506 + },
8507 + {
8508 + "slug": "SUPABASE_RENDER_AUTHENTICATED_IMAGE",
8509 + "name": "Render Authenticated Image",
8510 + "description": "Render an authenticated image with transformations. Uses a secret/service-role project key and bypasses Row Level Security."
8511 + },
8512 + {
8513 + "slug": "SUPABASE_RENDER_PUBLIC_IMAGE",
8514 + "name": "Render Public Image",
8515 + "description": "Render a public image with transformations."
8516 + },
8517 + {
8518 + "slug": "SUPABASE_RENDER_SIGNED_IMAGE",
8519 + "name": "Render Signed Image",
8520 + "description": "Render a signed image with transformations."
8521 + },
8522 + {
8523 + "slug": "SUPABASE_REPLACE_BUCKET_LIFECYCLE",
8524 + "name": "Replace Bucket Lifecycle",
8525 + "description": "Replace bucket lifecycle configuration. Uses a secret/service-role project key and bypasses Row Level Security."
8526 + },
8527 {
8528 "slug": "SUPABASE_RESET_DATABASE_BRANCH",
8529 "name": "Reset a database branch",
8530 "description": "Resets an existing Supabase database branch, identified by `branch_id`, to its initial clean state, irreversibly deleting all its current data and schema changes."
8531 },
8532 + {
8533 + "slug": "SUPABASE_RESTART_PROJECT",
8534 + "name": "Restart Project",
8535 + "description": "Restart a project, temporarily interrupting its services. Newly provisioned projects must wait ten minutes."
8536 + },
8537 + {
8538 + "slug": "SUPABASE_RESTORE_BRANCH",
8539 + "name": "Restore Branch",
8540 + "description": "Restore a scheduled branch deletion."
8541 + },
8542 {
8543 "slug": "SUPABASE_RESTORE_PITR_BACKUP",
8544 "name": "Restore database PITR backup",
8545 "description": "Restores a Supabase project's database to a specific Unix timestamp using Point-in-Time Recovery (PITR), overwriting the current state; requires a paid plan with PITR and physical backups enabled."
8546 },
8547 + {
8548 + "slug": "SUPABASE_RESTORE_PROJECT",
8549 + "name": "Restore Project",
8550 + "description": "Restore the given project."
8551 + },
8552 + {
8553 + "slug": "SUPABASE_ROLLBACK_MIGRATIONS",
8554 + "name": "Rollback Migrations",
8555 + "description": "Rollback database migrations and remove them from history."
8556 + },
8557 {
8558 "slug": "SUPABASE_RUN_READ_ONLY_QUERY",
8559 "name": "Execute read-only database query",
8115 - "description": "[Beta] Run a SQL query as supabase_read_only_user. Use when you need to safely execute SELECT queries without risk of modifying data. Only read operations are allowed."
8560 + "description": "Run a read-only SQL query against a Supabase project as supabase_read_only_user. This beta endpoint requires all entity references to be schema-qualified."
8561 },
8562 {
8563 "slug": "SUPABASE_SELECT_FROM_TABLE",
8564 "name": "Select From Table",
8120 - "description": "Tool to select rows from a Supabase/PostgREST table. Use for read-only queries with filtering, sorting, and pagination."
8565 + "description": "Select rows from a Supabase/PostgREST table or view, with column selection, filtering, sorting, and pagination. When a project API key is not supplied, the tool may use a service-role key, which bypasses row-level security."
8566 + },
8567 + {
8568 + "slug": "SUPABASE_SHUTDOWN_REALTIME",
8569 + "name": "Shutdown Realtime",
8570 + "description": "Shut down the project Realtime service connections, disconnecting active clients."
8571 + },
8572 + {
8573 + "slug": "SUPABASE_TERMINATE_RESUMABLE_UPLOAD",
8574 + "name": "Terminate Resumable Upload",
8575 + "description": "Terminate a TUS resumable upload. Uses a secret/service-role project key and bypasses Row Level Security. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
8576 + },
8577 + {
8578 + "slug": "SUPABASE_TERMINATE_RESUMABLE_UPLOAD_SIGNED",
8579 + "name": "Terminate Resumable Upload Signed",
8580 + "description": "Terminate a signed resumable upload. Implements one TUS protocol step; callers retain Location and Upload-Offset for continuation."
8581 + },
8582 + {
8583 + "slug": "SUPABASE_UPDATE_ACTION_RUN_STATUS",
8584 + "name": "Update Action Run Status",
8585 + "description": "Update the status of an action run."
8586 },
8587 {
8588 "slug": "SUPABASE_UPDATE_A_FUNCTION",
8589 "name": "Update a function",
8125 - "description": "Updates an existing Supabase Edge Function's properties (like name, slug, source code, JWT settings, import map) identified by project `ref` and `function_slug`, supporting plain text code or ESZIP for the body. Use RETRIEVE_A_FUNCTION_BODY action first to get the current source code, as this action requires sending the complete function code, not just the changes."
8590 + "description": "Updates an existing Supabase Edge Function's properties, including its name, slug, source code, JWT settings, and import map, using its project reference and function slug."
8591 },
8592 {
8593 "slug": "SUPABASE_UPDATE_API_KEY",
8594 "name": "Update API key",
8130 - "description": "Updates an existing Supabase project API key's metadata including name, description, and JWT template configuration. This action modifies key properties without regenerating the actual key value. Use this action when you need to change a key's display name, update its description for better organization, or modify the JWT role template for secret-type keys. Note: This does not rotate or regenerate the key string itself - the key value remains unchanged unless explicitly revealed with reveal=true."
8595 + "description": "Updates an existing Supabase project API key's name, description, or JWT template without regenerating the key. It can request that the key value be revealed in the response."
8596 + },
8597 + {
8598 + "slug": "SUPABASE_UPDATE_BACKUP_SCHEDULE",
8599 + "name": "Update Backup Schedule",
8600 + "description": "Update the project's backup schedule."
8601 },
8602 {
8603 "slug": "SUPABASE_UPDATE_BRANCH",
@@ -8137,17 +8607,22 @@
8607 {
8608 "slug": "SUPABASE_UPDATE_DATABASE_BRANCH_CONFIG",
8609 "name": "Update database branch config",
8140 - "description": "Updates the configuration of a Supabase database branch, allowing modification of its name, associated Git branch, reset-on-push behavior, persistence, and status. Note: Database branching requires a paid Supabase plan (Pro or higher). This action requires a valid branch_id which must be exactly 20 lowercase alphabetic characters. Authentication: - Requires a valid Bearer token in the Authorization header. - Token format: 'Bearer <access_token>' Required Scope: - Environment:Write"
8610 + "description": "Updates a Supabase database branch's configuration, including its name, associated Git branch, persistence, and status. The reset-on-push field is deprecated and ignored by Supabase."
8611 },
8612 {
8613 "slug": "SUPABASE_UPDATE_DATABASE_PASSWORD",
8614 "name": "Update database password",
8145 - "description": "Updates the database password for a Supabase project. Use when needing to rotate credentials or recover database access."
8615 + "description": "Updates the database password for a Supabase project. Use it to rotate credentials or recover database access."
8616 },
8617 {
8618 "slug": "SUPABASE_UPDATE_FUNCTIONS",
8619 "name": "Bulk update functions",
8150 - "description": "Tool to bulk update Edge Functions in a Supabase project. Use when you need to update multiple functions at once with new configurations such as status, version, or other properties."
8620 + "description": "Bulk updates Edge Functions in a Supabase project with configurations such as status and version. The operation can create new functions or replace existing ones; version increments must be supplied manually."
8621 + },
8622 + {
8623 + "slug": "SUPABASE_UPDATE_JIT_ACCESS",
8624 + "name": "Update Jit Access",
8625 + "description": "Update a user mapping for JIT access."
8626 },
8627 {
8628 "slug": "SUPABASE_UPDATE_JIT_ACCESS_CONFIG",
@@ -8157,7 +8632,7 @@
8632 {
8633 "slug": "SUPABASE_UPDATE_PGSODIUM_CONFIG",
8634 "name": "Update pgsodium root key",
8160 - "description": "Critically updates or initializes a Supabase project's pgsodium root encryption key for security setup or key rotation, requiring secure backup of the new key to prevent irreversible data loss."
8635 + "description": "Updates a Supabase project's pgsodium root encryption key. Changing the root key can make data encrypted with the previous key inaccessible."
8636 },
8637 {
8638 "slug": "SUPABASE_UPDATE_PROJECT",
@@ -8172,12 +8647,12 @@
8647 {
8648 "slug": "SUPABASE_UPDATE_PROJECT_CUSTOM_HOSTNAME",
8649 "name": "Update project's custom hostname configuration",
8175 - "description": "Updates the custom hostname for a Supabase project, requiring subsequent DNS changes to a user-controlled domain for SSL certificate issuance and domain ownership."
8650 + "description": "Updates the custom hostname for a Supabase project, requiring subsequent DNS changes for SSL certificate issuance and domain ownership. API errors may be returned in an error message field."
8651 },
8652 {
8653 "slug": "SUPABASE_UPDATE_PROJECT_LEGACY_API_KEYS",
8654 "name": "Update project legacy API keys",
8180 - "description": "Tool to disable or re-enable JWT-based legacy API keys (anon, service_role) for a Supabase project. Use when you need to toggle legacy API key access for security or migration purposes. Note: This API endpoint may be removed in the future - check for HTTP 404 Not Found if the endpoint is no longer available."
8655 + "description": "Deprecated by the provider; no sunset date or replacement is announced. Disable or re-enable JWT-based legacy API keys (anon, service_role). The endpoint may return HTTP 404 when unavailable. Behavior is unchanged."
8656 },
8657 {
8658 "slug": "SUPABASE_UPDATE_PROJECT_POSTGRES_CONFIG",
@@ -8192,7 +8667,12 @@
8667 {
8668 "slug": "SUPABASE_UPDATE_PROJECT_SUPAVISOR_CONFIG",
8669 "name": "Update database pooler config",
8195 - "description": "Updates the Supavisor (database pooler) configuration, such as `default_pool_size`, for an existing Supabase project identified by `ref`; the `pool_mode` parameter in the request is deprecated and ignored."
8670 + "description": "Updates Supavisor (database pooler) configuration, including default pool size and pool mode, for an existing Supabase project identified by its reference."
8671 + },
8672 + {
8673 + "slug": "SUPABASE_UPDATE_REALTIME_CONFIG",
8674 + "name": "Update Realtime Config",
8675 + "description": "Update Realtime configuration."
8676 },
8677 {
8678 "slug": "SUPABASE_UPDATE_SSL_ENFORCEMENT_CONFIG",
@@ -8204,6 +8684,36 @@
8684 "name": "Update an SSO provider by its UUID",
8685 "description": "Updates an existing SSO provider's SAML metadata, associated email domains, or attribute mappings for a Supabase project, identified by `ref` and `provider_id`."
8686 },
8687 + {
8688 + "slug": "SUPABASE_UPDATE_STORAGE_BUCKET",
8689 + "name": "Update Storage Bucket",
8690 + "description": "Update bucket properties. Uses a secret/service-role project key and bypasses Row Level Security."
8691 + },
8692 + {
8693 + "slug": "SUPABASE_UPDATE_STORAGE_CONFIG",
8694 + "name": "Update Storage Config",
8695 + "description": "Update project Storage configuration."
8696 + },
8697 + {
8698 + "slug": "SUPABASE_UPDATE_STORAGE_OBJECT",
8699 + "name": "Update Storage Object",
8700 + "description": "Update the object at an existing key. Uses a secret/service-role project key and bypasses Row Level Security."
8701 + },
8702 + {
8703 + "slug": "SUPABASE_UPDATE_TABLE_ROWS",
8704 + "name": "Update Table Rows",
8705 + "description": "Update matching rows in an exposed Supabase table or updatable view. Uses a secret or service_role project key, bypassing Row Level Security. PostgREST warns that unfiltered PATCH updates every row: filters are required unless allow_all_rows=true. Filters can still match every row; check them carefully. OAuth needs secrets:read; fine-grained PATs need api_gateway_keys_read and api_gateway_keys_secret_read to reveal the project key."
8706 + },
8707 + {
8708 + "slug": "SUPABASE_UPLOAD_SIGNED_OBJECT",
8709 + "name": "Upload Signed Object",
8710 + "description": "Upload an object using a presigned URL."
8711 + },
8712 + {
8713 + "slug": "SUPABASE_UPLOAD_STORAGE_OBJECT",
8714 + "name": "Upload Storage Object",
8715 + "description": "Upload a new object. Uses a secret/service-role project key and bypasses Row Level Security."
8716 + },
8717 {
8718 "slug": "SUPABASE_UPSERT_MIGRATION",
8719 "name": "Upsert migration",
@@ -8320,9 +8830,9 @@
8830 "composioManagedAuthSchemes": [
8831 "OAUTH2"
8832 ],
8323 - "toolCount": 329,
8833 + "toolCount": 331,
8834 "triggerCount": 5,
8325 - "version": "20261029_00",
8835 + "version": "20261103_00",
8836 "tools": [
8837 {
8838 "slug": "OUTLOOK_ACCEPT_EVENT",
@@ -8337,7 +8847,7 @@
8847 {
8848 "slug": "OUTLOOK_ADD_MAIL_ATTACHMENT",
8849 "name": "Add mail attachment",
8340 - "description": "Tool to add an attachment to an email message. Use when you have a message ID and need to attach a small (<3 MB) file or reference."
8850 + "description": "Adds a small file attachment to an Outlook email message identified by its message ID, using an uploaded file or base64-encoded content."
8851 },
8852 {
8853 "slug": "OUTLOOK_BATCH_MOVE_MESSAGES",
@@ -8357,7 +8867,7 @@
8867 {
8868 "slug": "OUTLOOK_CANCEL_CALENDAR_EVENT",
8869 "name": "Cancel user's calendar event",
8360 - "description": "Tool to cancel an event in a specific calendar for a specified user and send cancellation notifications to all attendees. Use when you need to cancel a meeting or event in a specific calendar on behalf of a user."
8870 + "description": "Cancels an organizer's event in a specified user's calendar and sends cancellation notifications to attendees. An optional comment can accompany the cancellation."
8871 },
8872 {
8873 "slug": "OUTLOOK_CANCEL_CALENDAR_GROUP_CALENDAR_EVENT",
@@ -8367,7 +8877,7 @@
8877 {
8878 "slug": "OUTLOOK_CANCEL_EVENT",
8879 "name": "Cancel user calendar event",
8370 - "description": "Tool to cancel a calendar event for a specified user and send cancellation notifications to all attendees. Use when you need to cancel a meeting or event on behalf of a specific user."
8880 + "description": "Cancel a calendar event for a specified user and send cancellation notifications to attendees. The calendar owner must be the meeting organizer; an optional comment can be sent with the cancellation."
8881 },
8882 {
8883 "slug": "OUTLOOK_COPY_MAIL_FOLDER",
@@ -8377,7 +8887,7 @@
8887 {
8888 "slug": "OUTLOOK_COPY_ME_MAIL_FOLDER",
8889 "name": "Copy child mail folder",
8380 - "description": "Tool to copy a child mail folder to a destination folder. Use when you need to duplicate a folder structure."
8890 + "description": "Copies a child mail folder and its contents to a destination folder in the user's mailbox."
8891 },
8892 {
8893 "slug": "OUTLOOK_COPY_MESSAGE",
@@ -8412,7 +8922,7 @@
8922 {
8923 "slug": "OUTLOOK_CREATE_CALENDAR",
8924 "name": "Create calendar",
8415 - "description": "Tool to create a new calendar in the signed-in user's mailbox. Use when organizing events into a separate calendar."
8925 + "description": "Creates a new calendar in the signed-in user's or a specified user's mailbox, for organizing events into a separate calendar."
8926 },
8927 {
8928 "slug": "OUTLOOK_CREATE_CALENDAR_EVENT",
@@ -8422,7 +8932,7 @@
8932 {
8933 "slug": "OUTLOOK_CREATE_CALENDAR_EVENT_ATTACHMENT",
8934 "name": "Create calendar event attachment",
8425 - "description": "Tool to create a new attachment for an event in a specific calendar. Use when you need to attach a file or item to an event within a particular calendar."
8935 + "description": "Creates a file or item attachment on an event in a specific calendar using the authenticated user's mailbox. This action supports delegated access, not app-only authentication."
8936 },
8937 {
8938 "slug": "OUTLOOK_CREATE_CALENDAR_EVENT_ATTACHMENT_UPLOAD_SESSION",
@@ -8507,7 +9017,7 @@
9017 {
9018 "slug": "OUTLOOK_CREATE_GROUP_EVENT",
9019 "name": "Create Microsoft 365 group event",
8510 - "description": "Create an event in a Microsoft 365 group's default calendar. Supplying attendees sends meeting invitations to them."
9020 + "description": "Create an event in a Microsoft 365 group's default calendar using delegated access. Supplying attendees sends meeting invitations to them."
9021 },
9022 {
9023 "slug": "OUTLOOK_CREATE_MAIL_FOLDER",
@@ -8577,7 +9087,7 @@
9087 {
9088 "slug": "OUTLOOK_CREATE_ME_EVENT",
9089 "name": "Create calendar event for user",
8580 - "description": "Tool to create a new calendar event for a specific user. Use when you need to create events in a user's calendar."
9090 + "description": "Create a new calendar event in a user's default calendar."
9091 },
9092 {
9093 "slug": "OUTLOOK_CREATE_ME_EVENT_ATTACHMENT_UPLOAD_SESSION",
@@ -8597,7 +9107,7 @@
9107 {
9108 "slug": "OUTLOOK_CREATE_ME_MAIL_FOLDER_MESSAGE_REPLY_ALL_DRAFT",
9109 "name": "Create reply-all draft for mail folder message",
8600 - "description": "Deprecated: Use OUTLOOK_CREATE_REPLY_ALL_DRAFT instead, which supports both /me and /users/{user_id} endpoints with timezone support."
9110 + "description": "Creates a reply-all draft for a message in a specified mail folder, optionally including a comment. This tool is deprecated."
9111 },
9112 {
9113 "slug": "OUTLOOK_CREATE_ME_MESSAGE_REPLY_ALL_DRAFT",
@@ -8612,7 +9122,7 @@
9122 {
9123 "slug": "OUTLOOK_CREATE_ME_REPLY_DRAFT",
9124 "name": "Create reply draft",
8615 - "description": "Deprecated: Use OUTLOOK_CREATE_DRAFT_REPLY instead, which adds comment, cc_emails, and bcc_emails support."
9125 + "description": "Deprecated. Creates a reply draft for a specified message in the authenticated user's or another user's mailbox."
9126 },
9127 {
9128 "slug": "OUTLOOK_CREATE_MESSAGE_ATTACHMENT",
@@ -8652,7 +9162,7 @@
9162 {
9163 "slug": "OUTLOOK_CREATE_USER_EVENT_ATTACHMENT_UPLOAD_SESSION",
9164 "name": "Create user event attachment upload session",
8655 - "description": "Deprecated: Use OUTLOOK_CREATE_ME_EVENT_ATTACHMENT_UPLOAD_SESSION instead, which supports both /me and /users/{user_id} endpoints."
9165 + "description": "Creates an upload session for a file attachment on a specified user's calendar event and returns the upload URL and session details. This tool is deprecated."
9166 },
9167 {
9168 "slug": "OUTLOOK_CREATE_USER_EVENT_CALENDAR_PERMISSION",
@@ -8697,7 +9207,7 @@
9207 {
9208 "slug": "OUTLOOK_DECLINE_EVENT",
9209 "name": "Decline calendar event",
8700 - "description": "Tool to decline an invitation to a calendar event. Use when the user wants to decline a meeting or event invitation. The API returns 202 Accepted with no content on success."
9210 + "description": "Declines a calendar event invitation, optionally including a comment or proposed new time and controlling whether a response is sent. Returns a success message when the request is accepted."
9211 },
9212 {
9213 "slug": "OUTLOOK_DELETE_CALENDAR",
@@ -8837,7 +9347,7 @@
9347 {
9348 "slug": "OUTLOOK_DELETE_MAIL_FOLDER",
9349 "name": "Delete mail folder",
8840 - "description": "Delete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder."
9350 + "description": "Delete a mail folder from a user's mailbox. The tool rejects well-known system folder names as folder identifiers."
9351 },
9352 {
9353 "slug": "OUTLOOK_DELETE_MAIL_FOLDER_MESSAGE",
@@ -8922,7 +9432,7 @@
9432 {
9433 "slug": "OUTLOOK_DELETE_MESSAGE_ATTACHMENT",
9434 "name": "Delete Message Attachment",
8925 - "description": "Tool to delete an attachment from a message in a nested mail folder structure. Use when removing attachments from messages located in child folders within mail folders."
9435 + "description": "Delete an attachment from a message in a mail folder or its child folder."
9436 },
9437 {
9438 "slug": "OUTLOOK_DELETE_MESSAGE_EXTENSION",
@@ -8937,7 +9447,7 @@
9447 {
9448 "slug": "OUTLOOK_DELETE_PRIMARY_CALENDAR_PERMISSION",
9449 "name": "Delete User Calendar Permission",
8940 - "description": "Tool to delete a calendar permission from a specific user's calendar. Use when revoking calendar sharing access for a particular user."
9450 + "description": "Delete a calendar permission from a user's primary calendar to revoke calendar sharing access."
9451 },
9452 {
9453 "slug": "OUTLOOK_DELETE_TODO_TASK",
@@ -8962,7 +9472,7 @@
9472 {
9473 "slug": "OUTLOOK_DELETE_USER_CONTACT_EXTENSION",
9474 "name": "Delete user contact extension",
8965 - "description": "Deprecated: Use OUTLOOK_DELETE_CONTACTS_EXTENSIONS instead, which supports both /me and /users/{user_id} endpoints."
9475 + "description": "Deletes an extension from a contact in a user's child contact folder. This tool is deprecated."
9476 },
9477 {
9478 "slug": "OUTLOOK_DELETE_USER_EVENT_PERMANENTLY",
@@ -8977,7 +9487,7 @@
9487 {
9488 "slug": "OUTLOOK_DELETE_USER_MESSAGE_ATTACHMENT",
9489 "name": "Delete user message attachment",
8980 - "description": "Deprecated: Use OUTLOOK_DELETE_ME_MESSAGES_ATTACHMENTS instead, which supports both /me and /users/{user_id} endpoints."
9490 + "description": "Deprecated. Deletes an attachment from a message in the authenticated user's mailbox or a specified user's mailbox."
9491 },
9492 {
9493 "slug": "OUTLOOK_DISMISS_CALENDAR_EVENT_REMINDER",
@@ -8987,7 +9497,7 @@
9497 {
9498 "slug": "OUTLOOK_DISMISS_EVENT_REMINDER",
9499 "name": "Dismiss event reminder",
8990 - "description": "Tool to dismiss a reminder for a specific calendar event. Use when you need to turn off or remove a reminder alert for an event."
9500 + "description": "Dismiss a reminder for a specific event in the signed-in user's or specified user's default calendar."
9501 },
9502 {
9503 "slug": "OUTLOOK_DISMISS_EVENT_REMINDER_FROM_GROUP",
@@ -9012,7 +9522,7 @@
9522 {
9523 "slug": "OUTLOOK_FIND_MEETING_TIMES",
9524 "name": "Find Meeting Times",
9015 - "description": "Suggests meeting times based on organizer and attendee availability, time constraints, and duration requirements. Use when you need to find optimal meeting slots across multiple participants' schedules."
9525 + "description": "Suggest meeting times based on organizer and attendee availability, time constraints, and duration requirements. Requires delegated access with a work or school account."
9526 },
9527 {
9528 "slug": "OUTLOOK_FORWARD_MESSAGE",
@@ -9027,7 +9537,7 @@
9537 {
9538 "slug": "OUTLOOK_GET_CALENDAR",
9539 "name": "Get specific calendar",
9030 - "description": "Deprecated: Use OUTLOOK_GET_USER_CALENDAR instead, which supports both /me and /users/{user_id} endpoints and adds $select field filtering."
9540 + "description": "Retrieves a specific calendar by ID from the signed-in user's calendars. This tool is deprecated."
9541 },
9542 {
9543 "slug": "OUTLOOK_GET_CALENDAR_EVENT",
@@ -9052,12 +9562,12 @@
9562 {
9563 "slug": "OUTLOOK_GET_CALENDAR_GROUP",
9564 "name": "Get calendar group",
9055 - "description": "Tool to retrieve the properties and relationships of a calendar group object. Use when you need to get details of a specific calendar group by its ID."
9565 + "description": "Retrieve the properties of a specific Outlook calendar group by its ID, with optional property selection."
9566 },
9567 {
9568 "slug": "OUTLOOK_GET_CALENDAR_GROUP_CALENDAR_EVENT_EXTENSION",
9569 "name": "Get event extension",
9060 - "description": "Tool to retrieve an open extension from a calendar event within a specific calendar group and calendar. Use when you need to access custom data stored with an event."
9570 + "description": "Retrieve an open extension's identifiers and metadata from an event in a specified calendar group and calendar. The response does not include arbitrary custom extension data."
9571 },
9572 {
9573 "slug": "OUTLOOK_GET_CALENDAR_GROUP_EVENT_ATTACHMENT",
@@ -9067,12 +9577,12 @@
9577 {
9578 "slug": "OUTLOOK_GET_CALENDAR_GROUP_SCHEDULE",
9579 "name": "Get User Calendar Group Schedule",
9070 - "description": "Tool to retrieve free/busy schedule information for a specific user's calendar within a calendar group. Use when you need availability data from a particular user's calendar that belongs to a calendar group."
9580 + "description": "Retrieve free/busy availability for specified users, distribution lists, or resources over a time period using a user's calendar within a calendar group."
9581 },
9582 {
9583 "slug": "OUTLOOK_GET_CALENDAR_PERMISSION",
9584 "name": "Get user calendar permission",
9075 - "description": "Tool to retrieve a specific calendar permission for a user's calendar. Use when you need to check who has access to a specific user's calendar and their permission level."
9585 + "description": "Retrieve a specific permission for a user's default calendar, including the recipient or delegate and permission level."
9586 },
9587 {
9588 "slug": "OUTLOOK_GET_CALENDAR_PERMISSION_FROM_CALENDAR",
@@ -9107,7 +9617,7 @@
9617 {
9618 "slug": "OUTLOOK_GET_CONTACT_EXTENSION",
9619 "name": "Get contact extension",
9110 - "description": "Tool to retrieve an open extension from a contact in Microsoft Graph. Use when you need to access custom data stored with a contact."
9620 + "description": "Retrieves an open extension from a contact in a specified contact folder in Microsoft Graph. The response contains extension identification metadata, not the extension's custom data fields."
9621 },
9622 {
9623 "slug": "OUTLOOK_GET_CONTACT_FOLDER",
@@ -9124,6 +9634,11 @@
9634 "name": "Get contact from folder",
9635 "description": "Tool to retrieve a specific contact from a contact folder by its ID. Use when you need to access contact details from a specific folder rather than the default contacts location."
9636 },
9637 + {
9638 + "slug": "OUTLOOK_GET_CONTACT_PHOTO_METADATA",
9639 + "name": "Get contact photo metadata",
9640 + "description": "Retrieve dimensions and optional media metadata for a contact's photo."
9641 + },
9642 {
9643 "slug": "OUTLOOK_GET_DRAFTS_MAIL_FOLDER",
9644 "name": "Get drafts mail folder",
@@ -9142,7 +9657,7 @@
9657 {
9658 "slug": "OUTLOOK_GET_EVENT_ATTACHMENT",
9659 "name": "Get event attachment",
9145 - "description": "Tool to retrieve a specific attachment from an Outlook calendar event by attachment ID. Use when you need to download or access the content of a particular event attachment."
9660 + "description": "Retrieve a specific attachment from an Outlook calendar event by attachment ID. The response includes attachment details and, for file attachments, may include base64-encoded content."
9661 },
9662 {
9663 "slug": "OUTLOOK_GET_EVENT_CALENDAR_FROM_GROUP",
@@ -9157,17 +9672,17 @@
9672 {
9673 "slug": "OUTLOOK_GET_GROUP_CALENDAR",
9674 "name": "Get Microsoft 365 group calendar",
9160 - "description": "Retrieve metadata for a Microsoft 365 group's default calendar."
9675 + "description": "Retrieve metadata for a Microsoft 365 group's default calendar using delegated work or school account access."
9676 },
9677 {
9678 "slug": "OUTLOOK_GET_GROUP_EVENT",
9679 "name": "Get Microsoft 365 group event",
9165 - "description": "Retrieve one calendar event owned by a Microsoft 365 group."
9680 + "description": "Retrieve one calendar event owned by a Microsoft 365 group using delegated access."
9681 },
9682 {
9683 "slug": "OUTLOOK_GET_GROUP_POST_ATTACHMENT",
9684 "name": "Get group post attachment",
9170 - "description": "Retrieve one attachment from a Microsoft 365 group conversation post."
9685 + "description": "Retrieve one attachment from a Microsoft 365 group conversation post using delegated access."
9686 },
9687 {
9688 "slug": "OUTLOOK_GET_INFERENCE_CLASSIFICATION",
@@ -9182,7 +9697,7 @@
9697 {
9698 "slug": "OUTLOOK_GET_MAIL_DELTA",
9699 "name": "Get mail delta",
9185 - "description": "Retrieve incremental changes (delta) of messages in a mailbox. FIRST RUN: Returns ALL messages in folder (use top=50 to limit). Response has @odata.deltaLink. SUBSEQUENT: Pass stored deltaLink to get only NEW/UPDATED/DELETED messages since last sync. Properties available: id, subject, from, receivedDateTime, isRead, etc. NOT available: internetMessageHeaders, full body, attachment content (response size limits)."
9700 + "description": "Retrieve incremental message changes in one mailbox folder, defaulting to Inbox. Page through initial or subsequent results using the returned next link, then store the delta link for the next synchronization."
9701 },
9702 {
9703 "slug": "OUTLOOK_GET_MAIL_FOLDER",
@@ -9217,7 +9732,7 @@
9732 {
9733 "slug": "OUTLOOK_GET_ME_CALENDAR",
9734 "name": "Get user's default calendar",
9220 - "description": "Tool to get the properties and relationships of the signed-in user's default calendar. Use when you need to retrieve calendar details for the authenticated user."
9735 + "description": "Retrieve properties of the default calendar for the signed-in user or a specified user."
9736 },
9737 {
9738 "slug": "OUTLOOK_GET_ME_CONTACT_FOLDERS_CHILD_FOLDER",
@@ -9242,7 +9757,7 @@
9757 {
9758 "slug": "OUTLOOK_GET_ME_CONTACTS_EXTENSIONS",
9759 "name": "Get user contact extension",
9245 - "description": "Tool to retrieve a specific open extension from a user's contact. Use when you need to access custom data stored with a contact."
9760 + "description": "Retrieve the identifying metadata of a specific open extension on a user's contact."
9761 },
9762 {
9763 "slug": "OUTLOOK_GET_ME_EVENT_ATTACHMENT",
@@ -9262,7 +9777,7 @@
9777 {
9778 "slug": "OUTLOOK_GET_ME_MAIL_FOLDERS_MESSAGES_EXTENSIONS",
9779 "name": "Get message extension",
9265 - "description": "Tool to retrieve a specific extension from a message in a user's mailbox. Use when you need to read custom data stored in a message extension."
9780 + "description": "Retrieve identifying details for a specific extension on a message in a user's mail folder. The response does not retain arbitrary custom extension properties."
9781 },
9782 {
9783 "slug": "OUTLOOK_GET_ME_MESSAGE_MIME_CONTENT",
@@ -9282,7 +9797,7 @@
9797 {
9798 "slug": "OUTLOOK_GET_MESSAGE_EXTENSION",
9799 "name": "Get user message extension",
9285 - "description": "Tool to retrieve a specific extension from a user's message. Use when you need to read custom data stored in a message extension."
9800 + "description": "Retrieve the identifying metadata of a specific extension on a user's message."
9801 },
9802 {
9803 "slug": "OUTLOOK_GET_NESTED_FOLDER_MESSAGE_ATTACHMENT",
@@ -9312,7 +9827,7 @@
9827 {
9828 "slug": "OUTLOOK_GET_SUPPORTED_TIME_ZONES",
9829 "name": "Get supported time zones",
9315 - "description": "Tool to get the list of time zones supported for a user as configured on their mailbox server. Use when setting up an Outlook client or configuring user time zone preferences."
9830 + "description": "Get the time zones supported for a user as configured on their mailbox server, using delegated authentication. Use when setting up an Outlook client or configuring user time zone preferences."
9831 },
9832 {
9833 "slug": "OUTLOOK_GET_USER_BY_EMAIL",
@@ -9322,7 +9837,7 @@
9837 {
9838 "slug": "OUTLOOK_GET_USER_CALENDAR",
9839 "name": "Get user's calendar",
9325 - "description": "Tool to get the properties and relationships of a specific calendar for a user. Use when you need to retrieve details for a particular calendar by its ID for any user."
9840 + "description": "Retrieves properties of a specific user's calendar by calendar ID, with optional property selection."
9841 },
9842 {
9843 "slug": "OUTLOOK_GET_USER_CALENDAR_ALLOWED_SHARING_ROLES",
@@ -9397,7 +9912,7 @@
9912 {
9913 "slug": "OUTLOOK_LIST_CALENDAR_GROUPS",
9914 "name": "List Outlook calendar groups",
9400 - "description": "Tool to list calendar groups in the signed-in user's mailbox. Use when you need to retrieve calendar groups with optional OData queries."
9915 + "description": "List calendar groups in the signed-in user's or a specified user's mailbox, with optional OData queries."
9916 },
9917 {
9918 "slug": "OUTLOOK_LIST_CALENDAR_PERMISSIONS",
@@ -9407,12 +9922,12 @@
9922 {
9923 "slug": "OUTLOOK_LIST_CALENDARS",
9924 "name": "List Outlook calendars",
9410 - "description": "Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries."
9925 + "description": "List calendars in the signed-in user's or a specified user's mailbox, with optional OData queries."
9926 },
9927 {
9928 "slug": "OUTLOOK_LIST_CALENDAR_VIEW_DELTA",
9929 "name": "List calendar view delta",
9415 - "description": "Tool to get calendar events that have been added, deleted, or updated in a calendar view. Use when you need to track changes to events within a specific time range."
9930 + "description": "Retrieve calendar-view delta events for a specified time range, including changes since a prior sync. Deleted entries do not retain their removal marker in the response."
9931 },
9932 {
9933 "slug": "OUTLOOK_LIST_CHAT_MESSAGES",
@@ -9457,7 +9972,7 @@
9972 {
9973 "slug": "OUTLOOK_LIST_CONTACTS_DELTA",
9974 "name": "List contacts delta",
9460 - "description": "Retrieve incremental changes (delta) of contacts in a specified folder. Use when syncing contacts without fetching the entire set each time. FIRST RUN: Returns ALL contacts in folder. Response has @odata.deltaLink. SUBSEQUENT: Pass stored deltaLink to get only NEW/UPDATED/DELETED contacts since last sync."
9975 + "description": "Retrieve incremental changes to contacts in a specified folder for synchronization. The initial sync may require paging before a delta link is returned; use the stored delta link for subsequent changes."
9976 },
9977 {
9978 "slug": "OUTLOOK_LIST_DIRECT_GROUP_MEMBERSHIPS",
@@ -9467,7 +9982,7 @@
9982 {
9983 "slug": "OUTLOOK_LIST_EMAIL_RULES",
9984 "name": "List Email Rules",
9470 - "description": "List all email rules from inbox. No server-side filtering is supported; all rule narrowing must be done client-side after retrieval. Each rule includes a `sequence` field defining execution order and may include a `stopProcessingRules` flag affecting downstream rule execution."
9985 + "description": "List inbox email rules for the authenticated or specified user. Results may include rule conditions, actions, sequence, and stop-processing settings; use top and skip to page through rules, and narrow results client-side."
9986 },
9987 {
9988 "slug": "OUTLOOK_LIST_EVENT_ATTACHMENTS",
@@ -9517,7 +10032,7 @@
10032 {
10033 "slug": "OUTLOOK_LIST_LICENSE_DETAILS",
10034 "name": "List license details",
9520 - "description": "List a user's assigned Microsoft product licenses and service plans."
10035 + "description": "List the authenticated user's assigned Microsoft product licenses and service plans."
10036 },
10037 {
10038 "slug": "OUTLOOK_LIST_MAIL_FOLDER_MESSAGE_ATTACHMENTS",
@@ -9542,7 +10057,7 @@
10057 {
10058 "slug": "OUTLOOK_LIST_MAIL_FOLDERS_DELTA",
10059 "name": "List mail folders delta",
9545 - "description": "Tool to get incremental changes to mail folders. Use when you need to track additions, deletions, or updates to mail folders without fetching the entire folder list each time."
10060 + "description": "Retrieve incremental mail-folder changes for a mailbox using delta or continuation tokens. Deleted folder entries do not retain their deletion marker in the response."
10061 },
10062 {
10063 "slug": "OUTLOOK_LIST_MASTER_CATEGORIES",
@@ -9552,7 +10067,7 @@
10067 {
10068 "slug": "OUTLOOK_LIST_ME_CALENDAR_PERMISSIONS",
10069 "name": "List user calendar permissions",
9555 - "description": "Tool to list calendar permissions for a specific user's calendar. Use when you need to see who has access to a user's calendar and their permission levels."
10070 + "description": "List sharing permissions and permission levels for a specific user's default calendar."
10071 },
10072 {
10073 "slug": "OUTLOOK_LIST_ME_EVENT_INSTANCES",
@@ -9567,7 +10082,7 @@
10082 {
10083 "slug": "OUTLOOK_LIST_MESSAGES",
10084 "name": "List Messages",
9570 - "description": "List or query Outlook messages from one folder (Inbox by default) or mailbox-wide with folder='allfolders'. Use simple filter fields for common conditions, filter for a raw OData expression, or search for full-text matching. Supports field selection, sorting, page size, offset, and opaque continuation tokens. Microsoft Graph does not allow search with filter, orderby, or skip; use OUTLOOK_QUERY_EMAILS only when you want its stricter single-folder OData validation."
10085 + "description": "List or query Outlook messages in one folder (Inbox by default) or across the mailbox, with filters, search, field selection, sorting, and pagination. Some filters apply after each page is fetched, so empty pages can precede further results; search drops server-side filters, sorting, and offset."
10086 },
10087 {
10088 "slug": "OUTLOOK_LIST_NOTIFICATION_SUBSCRIPTIONS",
@@ -9607,12 +10122,12 @@
10122 {
10123 "slug": "OUTLOOK_LIST_SENT_ITEMS_MESSAGES",
10124 "name": "List sent items messages",
9610 - "description": "Tool to list all messages in the SentItems mail folder of the signed-in user's mailbox. Use when you need to retrieve sent messages with optional filtering and sorting."
10125 + "description": "List a page of messages in the SentItems folder of the signed-in user or a specified user's mailbox, with optional filtering and sorting. Use the returned continuation token to retrieve further pages."
10126 },
10127 {
10128 "slug": "OUTLOOK_LIST_TO_DO_LISTS",
10129 "name": "List To Do task lists",
9615 - "description": "Tool to list Microsoft To Do task lists for the signed-in user. Use when you need to discover available task lists before listing or creating tasks. Returns todoTaskList objects with id and displayName that can be used in downstream operations."
10130 + "description": "List Microsoft To Do task lists for the signed-in user or a specified user. Use to discover task lists before listing or creating tasks; results include list IDs and may include display names."
10131 },
10132 {
10133 "slug": "OUTLOOK_LIST_TODO_TASKS",
@@ -9627,7 +10142,7 @@
10142 {
10143 "slug": "OUTLOOK_LIST_USER_CALENDAR_EVENTS_ATTACHMENTS",
10144 "name": "List user calendar event attachments",
9630 - "description": "Tool to list attachments for a user's calendar event. Use when you need to retrieve all attachments from a specific event in a user's calendar."
10145 + "description": "List a page of attachments for a specific event in a user's calendar. The response may include a next link when more results are available."
10146 },
10147 {
10148 "slug": "OUTLOOK_LIST_USER_CALENDAR_GROUP_EVENT_INSTANCES",
@@ -9662,7 +10177,7 @@
10177 {
10178 "slug": "OUTLOOK_LIST_USERS",
10179 "name": "List users",
9665 - "description": "Tool to list or search users in Microsoft Entra ID. Pass a plain person's name to `search`; the tool builds Graph's tokenized display-name query and may broaden an empty multi-token search to candidates matching any token. Verify a candidate's display name or address before use. Use `filter` for exact email or account-property conditions."
10180 + "description": "List or search Microsoft Entra ID users by plain display name, exact email, or account-property filters. Multi-token name searches may return broader candidates, and results can include the signed-in user regardless of the requested filter, so verify matches before use. Use page tokens to continue through results; the maximum page size is 999."
10181 },
10182 {
10183 "slug": "OUTLOOK_MOVE_MAIL_FOLDER",
@@ -9702,7 +10217,7 @@
10217 {
10218 "slug": "OUTLOOK_QUERY_EMAILS",
10219 "name": "Query Emails",
9705 - "description": "Query one Outlook mail folder with a validated raw OData filter. Best for precise server-side metadata conditions when validation and corrective guidance for OData syntax are useful. Returns 100 messages by default, up to 1000 per request, with projection, sorting, offset, and opaque continuation-token pagination. • Searches SINGLE folder only (inbox, sentitems, etc.) - NOT across all folders • For mailbox-wide OData filtering or full-text search: Use OUTLOOK_LIST_MESSAGES with folder='allfolders' • Server-side filters: dates, importance, isRead, hasAttachments, subjects, conversationId • Pagination: use the returned next_page_token (pass it back as page_token) until it is absent • Limitations: Recipient/body filtering requires OUTLOOK_SEARCH_MESSAGES"
10220 + "description": "Query one Outlook mail folder using a validated OData filter, with field selection, sorting, offset, and continuation-token pagination. Requests up to 100 messages by default and up to 1,000 per page; sorting may be dropped if Graph rejects it as inefficient."
10221 },
10222 {
10223 "slug": "OUTLOOK_REPLY_ALL",
@@ -9714,6 +10229,11 @@
10229 "name": "Reply to Email",
10230 "description": "Sends a reply to an Outlook email message with optional HTML formatting, attachments, CC, and BCC recipients."
10231 },
10232 + {
10233 + "slug": "OUTLOOK_REPORT_MESSAGE",
10234 + "name": "Report message",
10235 + "description": "Report a message as unknown, junk, not junk, or phishing. Reporting influences Microsoft's future mail filtering and cannot be retracted as an ordinary field update; when is_message_move_requested is true, Microsoft Graph can also move the message out of its current folder. On success, this beta operation may return either a command result with properties such as Status=Success or the message object documented by Microsoft Graph. The documented unknownFutureValue enum member is a forward-compatibility sentinel and is intentionally not exposed as a selectable report action. This action uses Microsoft Graph's beta API, which is subject to change and is not supported by Microsoft for production applications."
10236 + },
10237 {
10238 "slug": "OUTLOOK_SEARCH_EVENTS",
10239 "name": "Search calendar events",
@@ -9762,7 +10282,7 @@
10282 {
10283 "slug": "OUTLOOK_SNOOZE_USER_EVENT_REMINDER",
10284 "name": "Snooze user event reminder",
9765 - "description": "Tool to snooze a reminder for a user's calendar event to a new time. Use when you need to postpone an event reminder for a specific user."
10285 + "description": "Snoozes a reminder for an event in a user's default calendar to a new time."
10286 },
10287 {
10288 "slug": "OUTLOOK_TRANSLATE_EXCHANGE_IDS",
@@ -9772,7 +10292,7 @@
10292 {
10293 "slug": "OUTLOOK_UPDATE_CALENDAR_EVENT",
10294 "name": "Update calendar event",
9775 - "description": "Updates specified fields of an existing Outlook calendar event. Implementation note: To avoid unintentionally clearing properties, the action first fetches the existing event, merges only the provided fields, and then PATCHes the merged updates. Unspecified fields remain unchanged."
10295 + "description": "Updates specified fields of an existing Outlook calendar event, including subject, time, attendees, location, categories, and recurrence."
10296 },
10297 {
10298 "slug": "OUTLOOK_UPDATE_CALENDAR_EVENT_IN_CALENDAR",
@@ -9852,12 +10372,12 @@
10372 {
10373 "slug": "OUTLOOK_UPDATE_INFERENCE_CLASSIFICATION",
10374 "name": "Update Inference Classification",
9855 - "description": "Tool to update the inferenceClassification resource for a user. Use when needing to refresh or sync the Focused Inbox classification settings. Note: The inferenceClassification resource has no writable properties; actual message classification rules are managed through the overrides collection."
10375 + "description": "Request an update to a user's Focused Inbox inference classification resource. This action cannot change classification settings or rules; manage message classification rules through the overrides collection."
10376 },
10377 {
10378 "slug": "OUTLOOK_UPDATE_MAILBOX_SETTINGS",
10379 "name": "Update mailbox settings",
9860 - "description": "Tool to update mailbox settings for the signed-in user. Use when you need to configure automatic replies, default time zone, language, or working hours. Example: schedule automatic replies for vacation."
10380 + "description": "Updates mailbox settings for the signed-in user or a specified user, including automatic replies, default time zone, language, and working hours."
10381 },
10382 {
10383 "slug": "OUTLOOK_UPDATE_MAIL_FOLDER",
@@ -9877,17 +10397,17 @@
10397 {
10398 "slug": "OUTLOOK_UPDATE_TODO_TASK",
10399 "name": "Update To Do task",
9880 - "description": "Tool to update an existing task in Microsoft To Do. Use when modifying a task's title, status, importance, due date, reminder, body, or categories. Only the fields you provide will be changed."
10400 + "description": "Updates an existing Microsoft To Do task's title, status, importance, due date, reminder, body, completion date, or categories. Providing a reminder date also enables the reminder."
10401 },
10402 {
10403 "slug": "OUTLOOK_UPDATE_USER_CALENDAR",
10404 "name": "Update user calendar",
9885 - "description": "Tool to update the properties of a user's calendar. Use when you need to rename a calendar or change its color theme for a specific user."
10405 + "description": "Update the name or color of a user's default calendar. At least one of these properties must be supplied."
10406 },
10407 {
10408 "slug": "OUTLOOK_UPDATE_USER_CALENDAR_CALENDAR_EVENT",
10409 "name": "Update user calendar event",
9890 - "description": "Deprecated: Use OUTLOOK_UPDATE_CALENDAR_EVENT_IN_CALENDAR instead, which supports both /me and /users/{user_id} endpoints and additional fields (is_all_day, importance, sensitivity, reminders)."
10410 + "description": "Update an event in a specified user's calendar by calendar ID and event ID. This tool is deprecated."
10411 },
10412 {
10413 "slug": "OUTLOOK_UPDATE_USER_CALENDAR_EVENT",
@@ -9917,7 +10437,7 @@
10437 {
10438 "slug": "OUTLOOK_UPDATE_USER_CONTACTS_EXTENSIONS",
10439 "name": "Update user contact extension",
9920 - "description": "Tool to update an open extension on a contact in a user's contact folder. Use when you need to modify custom properties stored in a contact extension for a specific user."
10440 + "description": "Updates an open extension on a contact in a child folder of a user's contact folder, including its custom properties."
10441 },
10442 {
10443 "slug": "OUTLOOK_UPDATE_USER_CONTACTS_EXTENSIONS_DIRECT",
@@ -9927,7 +10447,7 @@
10447 {
10448 "slug": "OUTLOOK_UPDATE_USER_EVENT_EXTENSION",
10449 "name": "Update user event extension",
9930 - "description": "Deprecated: Use OUTLOOK_UPDATE_EVENT_EXTENSION_IN_CALENDAR_GROUP instead, which supports both /me and /users/{user_id} endpoints and uses the correct @odata.type prefix."
10450 + "description": "Update an open extension on a user's event in a calendar group, including its extension name and optional custom properties. This tool is deprecated."
10451 },
10452 {
10453 "slug": "OUTLOOK_UPDATE_USER_EVENTS_EXTENSIONS",
@@ -10124,7 +10644,7 @@
10644 ],
10645 "toolCount": 28,
10646 "triggerCount": 0,
10127 - "version": "20261029_00",
10647 + "version": "20261101_00",
10648 "tools": [
10649 {
10650 "slug": "PERPLEXITYAI_CANCEL_AGENT_RESPONSE",
@@ -10139,7 +10659,7 @@
10659 {
10660 "slug": "PERPLEXITYAI_CREATE_CHAT_COMPLETION",
10661 "name": "Create Chat Completion",
10142 - "description": "Sonar support ended 2026-09-27. Generate a chat-compatible response via Agent. Non-streaming requests using model/messages/max_tokens/temperature/top_p migrate to POST /v1/agent with the provider's Sonar-to-effort mapping. Requests with other legacy controls, tool-role messages, or streaming retain the provider's /v1/sonar compatibility route so existing callers keep their original request/response contract. Prefer Execute Agent for new integrations. Returns choices, citations, search results, and token usage in the existing chat-completion shape. Recency and date filters are mutually exclusive. The legacy stop parameter is not supported by the provider."
10662 + "description": "Generate a chat-compatible response from conversation messages, with optional search controls. Streaming responses are collected into a chat-completion result; recency and date filters are mutually exclusive. DEPRECATED: Sonar support has ended; prefer Execute Agent for new integrations."
10663 },
10664 {
10665 "slug": "PERPLEXITYAI_CREATE_CONTEXTUALIZED_EMBEDDINGS",
@@ -10219,7 +10739,7 @@
10739 {
10740 "slug": "PERPLEXITYAI_GET_SKILL_DOWNLOAD_URL",
10741 "name": "Get Skill Download URL",
10222 - "description": "Get a short-lived URL to download a skill bundle as a zip. Omit revision to select the active revision. Returns the URL only; does not fetch the bundle or forward API credentials to the download URL."
10742 + "description": "Get a short-lived URL to download a skill bundle as a ZIP, optionally for a specific revision; omit the revision to select the active revision. The response may also include revision and name metadata, and the bundle is not fetched."
10743 },
10744 {
10745 "slug": "PERPLEXITYAI_GET_USAGE_ANALYTICS",
@@ -10234,7 +10754,7 @@
10754 {
10755 "slug": "PERPLEXITYAI_LIST_ASYNC_CHAT_COMPLETIONS",
10756 "name": "List Async Chat Completions",
10237 - "description": "Deprecated by the provider on 2026-09-27: asynchronous Sonar is no longer supported. List Async Chat Completions (GET /v1/async/sonar). For new asynchronous work use Agent background mode and Get Agent Response with a response id. Agent retrieval is not a replacement for listing all legacy jobs. Retrieves a list of all asynchronous chat completion requests for the authenticated user. Use this to see the status of all your pending, completed, and failed async jobs."
10757 + "description": "List a page of legacy asynchronous Sonar chat completion requests for the authenticated user, including their statuses. The response may include a next-page token, but this action does not accept one."
10758 },
10759 {
10760 "slug": "PERPLEXITYAI_LIST_MODELS",
@@ -10305,7 +10825,7 @@
10825 ],
10826 "toolCount": 84,
10827 "triggerCount": 0,
10308 - "version": "20261023_00",
10828 + "version": "20261101_00",
10829 "tools": [
10830 {
10831 "slug": "TWITTER_ADD_LIST_MEMBER",
@@ -10385,7 +10905,7 @@
10905 {
10906 "slug": "TWITTER_FULL_ARCHIVE_SEARCH",
10907 "name": "Search full archive of tweets",
10388 - "description": "Searches the full archive of public Tweets from March 2006 onwards; use 'start_time' and 'end_time' together for a defined time window."
10908 + "description": "Searches the full archive of public Tweets from March 2006 onwards, with optional time bounds. Search queries are normalized, and parseable time bounds outside the supported range are adjusted."
10909 },
10910 {
10911 "slug": "TWITTER_GET_BLOCKED_USERS",
@@ -10410,7 +10930,7 @@
10930 {
10931 "slug": "TWITTER_GET_DM_EVENT",
10932 "name": "Get DM events by ID",
10413 - "description": "Fetches a specific Direct Message (DM) event by its unique ID, allowing optional expansion of related data like users or tweets; ensure the `event_id` refers to an existing DM event accessible to the authenticated user."
10933 + "description": "Fetches a specific Direct Message event by ID, with optional related-data expansions. The response model retains expanded tweets but not expanded users."
10934 },
10935 {
10936 "slug": "TWITTER_GET_LIST",
@@ -10505,7 +11025,7 @@
11025 {
11026 "slug": "TWITTER_GET_USER_LIST_MEMBERSHIPS",
11027 "name": "Get a user's list memberships",
10508 - "description": "Retrieves all Twitter Lists a specified user is a member of, including public Lists and private Lists the authenticated user is authorized to view."
11028 + "description": "Retrieves a page of Twitter Lists a specified user is a member of, including public Lists and private Lists the authenticated user is authorized to view. Use the returned pagination token to retrieve further pages."
11029 },
11030 {
11031 "slug": "TWITTER_GET_USER_MENTIONS",
@@ -10590,7 +11110,7 @@
11110 {
11111 "slug": "TWITTER_RECENT_SEARCH",
11112 "name": "Search recent tweets",
10593 - "description": "Searches Tweets from the last 7 days matching a query (using X's search syntax), ideal for real-time analysis, trend monitoring, or retrieving posts from specific users (e.g., `from:username`) DEFAULT FIELDS: Tweet objects always return 'id' and 'text' by default. User objects always return 'id', 'name', and 'username' by default when expanded. Do not request these default fields in field parameters. IMPORTANT LIMITATION - Impression Counts: The public_metrics.impression_count field returns 0 for search results from other users. Impression data is a non-public metric only available for tweets owned by the authenticated user. To filter by engagement, use retweet_count, like_count, or quote_count instead. Example - Get original tweets from Elon Musk since Sept 20, 2025: { \"query\": \"from:elonmusk -is:retweet -is:reply\", \"start_time\": \"2025-09-20T00:00:00Z\", \"max_results\": 50, \"tweet_fields\": [\"created_at\",\"public_metrics\",\"text\"], \"expansions\": [\"author_id\",\"attachments.media_keys\",\"referenced_tweets.id\"] }"
11113 + "description": "Searches Tweets from the last seven days using X query syntax, with optional fields, expansions, sorting, and time or ID bounds. Timestamp and ID bounds cannot be combined in the same request. Requests for more than 100 results are automatically paginated up to 2,000; use the returned next token to continue when more results are available."
11114 },
11115 {
11116 "slug": "TWITTER_REMOVE_LIST_MEMBER",
@@ -10695,22 +11215,22 @@
11215 {
11216 "slug": "TWITTER_UPLOAD_LARGE_MEDIA",
11217 "name": "Upload Large Media",
10698 - "description": "Use this to upload a single media file to X/Twitter. Automatically uses chunked upload for GIFs, videos, and images larger than 5 MB. Max file size: 512 MB; max video duration: 140 seconds. After upload, poll TWITTER_GET_MEDIA_UPLOAD_STATUS until processing_info.state=='succeeded' before attaching the media_id to a tweet — GIFs and videos take 30–120 seconds to process. A terminal 'failed' state means the media_id is unusable and the file must be re-uploaded. For small images (<5MB, no GIF/video), TWITTER_UPLOAD_MEDIA is simpler. For GIFs, videos, or files over 5MB, this action is currently the only working option - TWITTER_UPLOAD_MEDIA explicitly rejects those file types, so it is not a full replacement for this action's primary use case, despite what an earlier deprecation notice here claimed."
11218 + "description": "Uploads a single media file to X/Twitter using simple or chunked upload based on its category and size. For chunked uploads, it polls pending processing and raises an error if processing fails or polling times out."
11219 },
11220 {
11221 "slug": "TWITTER_UPLOAD_MEDIA",
11222 "name": "Upload Media",
10703 - "description": "Upload media (images only) to X/Twitter using the v2 API. Supports tweet_image, dm_image, and subtitles media categories only. One file per call; the returned media_id expires (see expires_after_secs in response), so upload immediately before creating the tweet. For GIFs, videos, or any file larger than ~5 MB, use TWITTER_UPLOAD_LARGE_MEDIA instead."
11223 + "description": "Uploads one image or subtitle file under 5 MiB to X/Twitter using the v2 API, with tweet_image, dm_image, or subtitles categories. The returned media identifier expires; the response includes its expiry interval."
11224 },
11225 {
11226 "slug": "TWITTER_USER_HOME_TIMELINE_BY_USER_ID",
11227 "name": "Get user reverse chronological timeline",
10708 - "description": "Retrieves the home timeline (reverse chronological feed) for the authenticated Twitter user. Returns tweets from accounts the user follows as well as the user's own tweets, in reverse chronological order. Useful for displaying the personalized feed without algorithmic sorting. CRITICAL: The 'id' parameter MUST be the authenticated user's own numeric Twitter user ID - use TWITTER_USER_LOOKUP_ME to get your ID first. This endpoint cannot fetch another user's home timeline, and passing any ID that doesn't match the authenticating user (including phone numbers or other user IDs) will result in an error. DEFAULT FIELDS: Tweet objects always return 'id' and 'text' by default. User objects always return 'id', 'name', and 'username' by default when expanded. Do not request these default fields in field parameters."
11228 + "description": "Retrieves the authenticated Twitter user's reverse chronological home timeline, including posts from followed accounts and the user's own posts. The user ID is fetched automatically when omitted; a supplied ID that differs from the authenticated user's ID is replaced with the authenticated ID."
11229 },
11230 {
11231 "slug": "TWITTER_USER_LIKE_POST",
11232 "name": "Like a tweet",
10713 - "description": "Allows the authenticated user to like a specific, accessible Tweet, provided neither user has blocked the other and the authenticated user is not restricted from liking. The authenticated user's ID is automatically determined from the OAuth token - you only need to provide the tweet_id."
11233 + "description": "Likes a specific, accessible Tweet for the authenticated user, provided neither user has blocked the other and the user is not restricted from liking. The request requires a user ID and Tweet ID; the authenticated user ID is fetched for the operation."
11234 },
11235 {
11236 "slug": "TWITTER_USER_LOOKUP_BY_USERNAME",
@@ -10802,7 +11322,7 @@
11322 ],
11323 "toolCount": 105,
11324 "triggerCount": 7,
10805 - "version": "20261022_00",
11325 + "version": "20261101_00",
11326 "tools": [
11327 {
11328 "slug": "GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE",
@@ -10852,7 +11372,7 @@
11372 {
11373 "slug": "GOOGLEDRIVE_CREATE_DRIVE",
11374 "name": "Create Shared Drive",
10855 - "description": "Tool to create a new shared drive. Use when you need to programmatically create a new shared drive for collaboration or storage."
11375 + "description": "Creates a Google shared drive for collaboration or storage. When reusing a request ID, an existing drive returned is not guaranteed to be the drive originally created with that ID."
11376 },
11377 {
11378 "slug": "GOOGLEDRIVE_CREATE_FILE",
@@ -10862,12 +11382,12 @@
11382 {
11383 "slug": "GOOGLEDRIVE_CREATE_FILE_FROM_TEXT",
11384 "name": "Create a File from Text",
10865 - "description": "Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types. Returns flat metadata fields (`id`, `mimeType`, `name`) at the top level — not nested under a `file` object. Created files are private by default; use a sharing tool afterward for collaborative access. Rapid successive calls may trigger `403 rateLimitExceeded` or `429 userRateLimitExceeded`; apply exponential backoff between retries. Does not support shared-drive targets in all cases."
11385 + "description": "Creates a Google Drive file from text, with support for Google Workspace formats and an optional parent folder. Returns file metadata at the top level; files can inherit parent permissions, and shared-drive targets are not supported in all cases."
11386 },
11387 {
11388 "slug": "GOOGLEDRIVE_CREATE_FOLDER",
11389 "name": "Create a folder",
10870 - "description": "Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE_FIND_FOLDER first to verify the parent exists or find its ID. Google Drive permits duplicate folder names, so always store and reuse the folder ID returned by this action rather than relying on names for future lookups."
11390 + "description": "Creates a Google Drive folder, optionally inside an existing parent specified by ID or exact name. If multiple folders match a parent name, it uses the first match; use a parent ID to avoid ambiguity."
11391 },
11392 {
11393 "slug": "GOOGLEDRIVE_CREATE_PERMISSION",
@@ -10882,7 +11402,7 @@
11402 {
11403 "slug": "GOOGLEDRIVE_CREATE_REPLY",
11404 "name": "Create Reply",
10885 - "description": "Tool to create a reply to a comment in Google Drive. Use when you need to respond to an existing comment on a file."
11405 + "description": "Create a plain-text reply to a comment on a Google Drive file, optionally resolving or reopening the parent comment."
11406 },
11407 {
11408 "slug": "GOOGLEDRIVE_CREATE_SHORTCUT_TO_FILE",
@@ -10922,12 +11442,12 @@
11442 {
11443 "slug": "GOOGLEDRIVE_DELETE_PERMISSION",
11444 "name": "Delete Permission",
10925 - "description": "Deletes a permission from a file by permission ID. Deletion is irreversible — confirm the target user, group, or permission type before executing. IMPORTANT: You must first call GOOGLEDRIVE_LIST_PERMISSIONS to get valid permission IDs. To fully revoke public access, the type='anyone' (link-sharing) permission must be explicitly deleted; revoking other permissions leaves the file publicly accessible via link. Use when you need to revoke access for a specific user or group from a file."
11445 + "description": "Deletes a specified permission from a file or shared drive by permission ID; deleting other permissions does not remove an existing public-access permission. Check the returned success flag: an owner permission that cannot be removed returns success=false."
11446 },
11447 {
11448 "slug": "GOOGLEDRIVE_DELETE_PROPERTY",
11449 "name": "Delete Property (v2 API)",
10930 - "description": "Tool to delete a property from a file using Google Drive API v2. Use when you need to remove custom key-value metadata from a file."
11450 + "description": "Delete a custom property from a Google Drive file using API v2. The property is selected by key and visibility; visibility defaults to private when omitted."
11451 },
11452 {
11453 "slug": "GOOGLEDRIVE_DELETE_REPLY",
@@ -10957,7 +11477,7 @@
11477 {
11478 "slug": "GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION",
11479 "name": "Download file via operation",
10960 - "description": "Tool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are valid for 24 hours from creation. Returns a response containing `downloaded_file_content.s3url` — a short-lived S3 URL; fetch the actual file bytes from that URL promptly after the call."
11480 + "description": "Starts a long-running operation to download a Drive file, including Google Vids files, or export supported Google Workspace documents. Returns operation status and metadata; operations are valid for 24 hours from creation."
11481 },
11482 {
11483 "slug": "GOOGLEDRIVE_DOWNLOAD_FILE_REVISION",
@@ -10967,7 +11487,7 @@
11487 {
11488 "slug": "GOOGLEDRIVE_EDIT_FILE",
11489 "name": "Edit File",
10970 - "description": "Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). IMPORTANT: This action only works with files that have binary content (text files, PDFs, images, etc.). It does NOT support editing Google Workspace native files (Google Docs, Sheets, Slides, etc.). For Google Workspace files, use the Google Docs API, Google Sheets API, or Google Slides API directly. Preserves the original file_id (unlike GOOGLEDRIVE_UPLOAD_FILE which creates a new ID)."
11490 + "description": "Replaces the entire content of an existing Google Drive binary file with UTF-8 text while retaining its file ID. Google Docs, Sheets, Slides, and other checked Workspace file types are not supported."
11491 },
11492 {
11493 "slug": "GOOGLEDRIVE_EMPTY_TRASH",
@@ -11047,7 +11567,7 @@
11567 {
11568 "slug": "GOOGLEDRIVE_GET_FILE_V2",
11569 "name": "Get File (v2 API) (Deprecated)",
11050 - "description": "DEPRECATED: Use GetFileMetadata instead. Tool to get a file's metadata or content by ID from Google Drive API v2. Use when you need file metadata with alt=json, or file content with alt=media."
11570 + "description": "Retrieves metadata for a Google Drive file by ID using the v2 API, optionally selecting fields for a partial response. DEPRECATED: Use GetFileMetadata instead. This action does not support returning file content as a media download."
11571 },
11572 {
11573 "slug": "GOOGLEDRIVE_GET_FORM",
@@ -11072,7 +11592,7 @@
11592 {
11593 "slug": "GOOGLEDRIVE_GET_PRESENTATION",
11594 "name": "Get Google Slides Presentation",
11075 - "description": "Retrieve a Google Slides presentation and its complete page structures by ID."
11595 + "description": "Retrieves a Google Slides presentation by ID, including its page structures. An optional field selector can limit the returned data."
11596 },
11597 {
11598 "slug": "GOOGLEDRIVE_GET_PRESENTATION_PAGE_THUMBNAIL",
@@ -11127,27 +11647,27 @@
11647 {
11648 "slug": "GOOGLEDRIVE_LIST_APPROVALS",
11649 "name": "List Approvals",
11130 - "description": "Tool to list approvals on a file for workflow-based access control. Use when you need to retrieve all approvals associated with a specific file in Google Drive."
11650 + "description": "Lists a page of approvals associated with a Google Drive file, with pagination for browsing subsequent pages. Approval details are unavailable through this action."
11651 },
11652 {
11653 "slug": "GOOGLEDRIVE_LIST_CHANGES",
11654 "name": "List Changes",
11135 - "description": "Tool to list the changes for a user or shared drive. Use when a full incremental change feed is needed (for simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE instead). Tracks modifications such as creations, deletions, or permission changes. The pageToken is optional - if not provided, the current start page token will be automatically fetched; an empty result is valid if no recent activity has occurred. Example usage: ```json { \"pageToken\": \"22633\", \"pageSize\": 100, \"includeRemoved\": true } ``` Returns changes with timestamps, file IDs, and modification details. Paginate by following `nextPageToken` until it is absent — stopping early will silently omit changes. Save `newStartPageToken` to monitor future changes efficiently."
11655 + "description": "Lists a page of changes for a user or shared drive; without a page token, it obtains a current start token and lists subsequent changes rather than earlier activity. Follow nextPageToken to continue and save newStartPageToken for future monitoring."
11656 },
11657 {
11658 "slug": "GOOGLEDRIVE_LIST_CHILDREN_V2",
11659 "name": "List Folder Children (v2)",
11140 - "description": "Tool to list a folder's children using Google Drive API v2. Use when you need to retrieve all files and folders within a specific folder."
11660 + "description": "Lists a page of child references for a folder using Google Drive API v2. Follow the returned nextPageToken to retrieve additional pages."
11661 },
11662 {
11663 "slug": "GOOGLEDRIVE_LIST_COMMENTS",
11664 "name": "List Comments",
11145 - "description": "Tool to list all comments for a file in Google Drive. Results are paginated; iterate using nextPageToken until absent to retrieve all comments. Filtering by author, content, or other criteria must be done client-side. Use commentId, createdTime, and author from results to uniquely identify comments before acting on them."
11665 + "description": "Lists comments on a Google Drive file, with pagination, an option to include deleted comments, and a minimum modification-time filter. Filter by author or content client-side."
11666 },
11667 {
11668 "slug": "GOOGLEDRIVE_LIST_FILE_LABELS",
11669 "name": "List File Labels",
11150 - "description": "Tool to list the labels already applied to a file in Google Drive. An empty labels array is a valid response indicating no labels are applied, not an error. This tool shows only applied labels; label_id and field_id values required by other Drive label tools must be obtained from admin configuration."
11670 + "description": "Lists labels applied to a Google Drive file, including label IDs and applied field IDs. An empty labels array is a valid response; additional pages may be available."
11671 },
11672 {
11673 "slug": "GOOGLEDRIVE_LIST_FILE_PROPERTIES",
@@ -11157,7 +11677,7 @@
11677 {
11678 "slug": "GOOGLEDRIVE_LIST_FILES",
11679 "name": "List Files and Folders (Deprecated)",
11160 - "description": "DEPRECATED: Use GOOGLEDRIVE_FIND_FILE instead. Tool to list a user's files and folders in Google Drive. Use this to search or browse for files and folders based on various criteria."
11680 + "description": "Lists and searches Google Drive files and folders using filters such as a folder, search query, or drive selection. Results are paginated; a 404 response is returned as an empty list and does not establish that no files match. DEPRECATED: Use GOOGLEDRIVE_FIND_FILE instead."
11681 },
11682 {
11683 "slug": "GOOGLEDRIVE_LIST_FORM_RESPONSES",
@@ -11172,12 +11692,12 @@
11692 {
11693 "slug": "GOOGLEDRIVE_LIST_PERMISSIONS",
11694 "name": "List Permissions",
11175 - "description": "Tool to list a file's permissions. Use when you need to retrieve all permissions associated with a specific file or shared drive."
11695 + "description": "Lists a page of permissions for a file or shared drive. Use the returned next page token to retrieve further pages when present."
11696 },
11697 {
11698 "slug": "GOOGLEDRIVE_LIST_REPLIES",
11699 "name": "List Replies to Comment",
11180 - "description": "Tool to list replies to a comment in Google Drive. Use this when you need to retrieve all replies associated with a specific comment on a file."
11700 + "description": "List a page of replies to a specific comment on a Google Drive file. Supports pagination and optionally including deleted replies."
11701 },
11702 {
11703 "slug": "GOOGLEDRIVE_LIST_REVISIONS",
@@ -11227,7 +11747,7 @@
11747 {
11748 "slug": "GOOGLEDRIVE_RESUMABLE_UPLOAD",
11749 "name": "Resumable Upload",
11230 - "description": "Tool to start and complete a Google Drive resumable upload session. Use for files larger than ~5 MB to avoid timeouts or size-limit failures. HTTP 308 means continue the session from the correct byte offset; HTTP 410 means the session expired and a full restart with a new session is required."
11750 + "description": "Upload a file to Google Drive using a resumable session, creating a new file or updating an existing file by ID. The upload is sent in chunks."
11751 },
11752 {
11753 "slug": "GOOGLEDRIVE_STOP_WATCH_CHANNEL",
@@ -11247,7 +11767,7 @@
11767 {
11768 "slug": "GOOGLEDRIVE_UNTRASH_FILE",
11769 "name": "Untrash File",
11250 - "description": "Tool to restore a file from the trash. Use when you need to recover a deleted file. This action updates the file's metadata to set the 'trashed' property to false. Only works while the file remains in trash — recovery is impossible after trash is emptied via GOOGLEDRIVE_EMPTY_TRASH or auto-purged by policy."
11770 + "description": "Restore a file from Google Drive trash. The file must still be in the trash; this does not recover permanently deleted files."
11771 },
11772 {
11773 "slug": "GOOGLEDRIVE_UPDATE_COMMENT",
@@ -11302,7 +11822,7 @@
11822 {
11823 "slug": "GOOGLEDRIVE_UPLOAD_FILE",
11824 "name": "Upload File",
11305 - "description": "Uploads a file (max 5MB) to Google Drive, placing it in the specified folder or root if no valid folder ID is provided. Always creates a new file (never updates existing); use GOOGLEDRIVE_EDIT_FILE to update with a stable file_id. Uploaded files are private by default; configure sharing via GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE."
11825 + "description": "Upload a new file to Google Drive, optionally placing it in a specified folder. If no folder ID is provided, it is uploaded to the Drive root."
11826 },
11827 {
11828 "slug": "GOOGLEDRIVE_UPLOAD_FROM_URL",
@@ -11317,7 +11837,7 @@
11837 {
11838 "slug": "GOOGLEDRIVE_WATCH_CHANGES",
11839 "name": "Watch Drive Changes",
11320 - "description": "Tool to subscribe to changes for a user or shared drive in Google Drive. Use when you need to monitor a Google Drive for modifications and receive notifications at a specified webhook URL. Notifications may be batched rather than per-change; design handlers to be idempotent and fetch all changes since the last known page_token on each notification."
11840 + "description": "Subscribe to Google Drive changes for a user or shared drive and receive notifications at a webhook URL. Supply a start or continuation page token; notifications may cover multiple changes, so fetch changes since the last known token."
11841 },
11842 {
11843 "slug": "GOOGLEDRIVE_WATCH_FILE",
@@ -11432,7 +11952,7 @@
11952 ],
11953 "toolCount": 48,
11954 "triggerCount": 10,
11435 - "version": "20261008_00",
11955 + "version": "20261101_00",
11956 "tools": [
11957 {
11958 "slug": "GOOGLEDOCS_COPY_DOCUMENT",
@@ -11442,7 +11962,7 @@
11962 {
11963 "slug": "GOOGLEDOCS_CREATE_AND_POPULATE_TABLE",
11964 "name": "Create and Populate Table in Google Doc",
11445 - "description": "Creates a new table in a Google Document and populates its cells with provided text data in a single operation. Use this action when you need to insert a structured table with predefined content into a document. The action handles both table creation and cell population automatically, eliminating the need for separate operations."
11965 + "description": "Creates a table in a Google Document and attempts to populate its cells with the provided text. Table creation and cell population are separate steps, so a failure after creation can leave the table in the document."
11966 },
11967 {
11968 "slug": "GOOGLEDOCS_CREATE_DOCUMENT",
@@ -11467,7 +11987,7 @@
11987 {
11988 "slug": "GOOGLEDOCS_CREATE_FOOTER",
11989 "name": "Create Footer",
11470 - "description": "Tool to create a new footer in a Google Document. Use when you need to add a footer, optionally specifying its type and the section it applies to."
11990 + "description": "Creates a footer in a Google document for the specified type and optional section. If the API reports that a footer already exists, the tool may return the document's existing default footer ID instead."
11991 },
11992 {
11993 "slug": "GOOGLEDOCS_CREATE_FOOTNOTE",
@@ -11477,7 +11997,7 @@
11997 {
11998 "slug": "GOOGLEDOCS_CREATE_HEADER",
11999 "name": "Create Header",
11480 - "description": "Tool to create a new header in a Google Document, optionally with text content. Use this tool when you need to add a header to a document. You can provide: - document_id: The ID of the document (required) - type: The header type (DEFAULT is the standard header) - text: Optional text content to add to the header - section_break_location: Optional location for section-specific headers"
12000 + "description": "Creates a header in a Google Document, optionally for a specified section, and can add text. For a document-level default header, it may reuse an existing header; text insertion is attempted separately and its success is reported."
12001 },
12002 {
12003 "slug": "GOOGLEDOCS_CREATE_NAMED_RANGE",
@@ -11507,7 +12027,7 @@
12027 {
12028 "slug": "GOOGLEDOCS_DELETE_HEADER",
12029 "name": "Delete Header",
11510 - "description": "Deletes the header from the specified section or the default header if no section is specified. Use this tool to remove a header from a Google Document."
12030 + "description": "Deletes a specified header by ID from a Google Document, optionally targeting a document tab."
12031 },
12032 {
12033 "slug": "GOOGLEDOCS_DELETE_NAMED_RANGE",
@@ -11567,7 +12087,7 @@
12087 {
12088 "slug": "GOOGLEDOCS_INSERT_IMAGE_IN_TABLE_CELL",
12089 "name": "Insert Image in Table Cell",
11570 - "description": "Inserts an image from a given URI into a specific table cell in a Google Document. Use this action when you need to add an image to a particular cell within a table. The action identifies the target cell by table start index, row index, and column index, then inserts the image at the specified position within that cell's content."
12090 + "description": "Inserts an image from a URI at a position in a Google Document table cell identified by table start index, row and column. The table lookup searches top-level body content, including the specified top-level tab when provided."
12091 },
12092 {
12093 "slug": "GOOGLEDOCS_INSERT_INLINE_IMAGE",
@@ -11602,7 +12122,7 @@
12122 {
12123 "slug": "GOOGLEDOCS_INSERT_TEXT_IN_TABLE_CELL",
12124 "name": "Insert Text in Table Cell",
11605 - "description": "Inserts text into a specific cell of a table in a Google Document by row and column position. Use this action when you need to add or update text content in a table cell at a known row and column index. To use this action, you must first retrieve the document structure using GOOGLEDOCS_GET_DOCUMENT_BY_ID to find the table's start index. Then specify the target cell by its zero-based row and column indices (e.g., row_index=0, column_index=0 for the top-left cell)."
12125 + "description": "Insert text into a Google Docs table using the table's start index and zero-based row and column positions. Existing table content can cause the text to be inserted outside the requested cell."
12126 },
12127 {
12128 "slug": "GOOGLEDOCS_LIST_DRIVE_ITEM_PERMISSIONS",
@@ -11617,7 +12137,7 @@
12137 {
12138 "slug": "GOOGLEDOCS_REPLACE_ALL_TEXT",
12139 "name": "Replace All Text in Document",
11620 - "description": "Tool to replace all occurrences of a specified text string with another text string throughout a Google Document. Use when you need to perform a global find and replace operation within a document."
12140 + "description": "Replaces occurrences of text in a Google Document, either across the document or in selected tabs. Supports case-sensitive matching and regular expressions."
12141 },
12142 {
12143 "slug": "GOOGLEDOCS_REPLACE_IMAGE",
@@ -11637,17 +12157,17 @@
12157 {
12158 "slug": "GOOGLEDOCS_UPDATE_DOCUMENT_BATCH",
12159 "name": "Update Document Batch (Deprecated)",
11640 - "description": "DEPRECATED: Use UpdateExistingDocument instead. Tool to apply one or more updates to a Google Document. Use when you need to perform batch operations on a document, such as inserting text, updating styles, or modifying document structure. Supports 35+ request types including insertText, replaceAllText, updateTextStyle, createParagraphBullets, insertTable, createHeader/Footer, and more. Each request is validated before being applied. If any request is invalid, the entire operation fails and nothing is applied."
12160 + "description": "Applies a batch of updates to a Google Document, such as inserting text, updating styles, and modifying tables or document structure. Text-style requests with empty ranges are filtered out before the remaining requests are submitted; optional write control helps manage concurrent edits. DEPRECATED: Use UpdateExistingDocument instead."
12161 },
12162 {
12163 "slug": "GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN",
12164 "name": "Update Document Markdown",
11645 - "description": "Replaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document."
12165 + "description": "Replaces the body content of a Google Docs tab with rendered Markdown; requires edit permissions. If no tab is specified, the first tab is updated."
12166 },
12167 {
12168 "slug": "GOOGLEDOCS_UPDATE_DOCUMENT_SECTION_MARKDOWN",
12169 "name": "Update Document Section Markdown",
11650 - "description": "Tool to insert or replace a section of a Google Docs document with Markdown content. Use when you need to update only a section of a document by specifying start and optional end indices. Supports full Markdown formatting."
12170 + "description": "Insert or replace a section of a Google Docs document with rendered Markdown, using start and optional end indices, or append when no start index is provided. A replacement may leave the original content in place while inserting the new content."
12171 },
12172 {
12173 "slug": "GOOGLEDOCS_UPDATE_DOCUMENT_STYLE",
@@ -11657,12 +12177,12 @@
12177 {
12178 "slug": "GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT",
12179 "name": "Update existing document",
11660 - "description": "Applies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method."
12180 + "description": "Applies a batch of edits to a specified Google Doc, such as inserting, deleting, or formatting text."
12181 },
12182 {
12183 "slug": "GOOGLEDOCS_UPDATE_TABLE_ROW_STYLE",
12184 "name": "Update Table Row Style",
11665 - "description": "Tool to update the style of a table row in a Google Document. Use when you need to modify the appearance of specific rows within a table, such as setting minimum row height or marking rows as headers."
12185 + "description": "Updates the style of selected rows in a Google Document table, including minimum row height and overflow prevention."
12186 },
12187 {
12188 "slug": "GOOGLEDOCS_UPDATE_TAB_PROPERTIES",
@@ -11791,9 +12311,9 @@
12311 "composioManagedAuthSchemes": [
12312 "OAUTH2"
12313 ],
11794 - "toolCount": 324,
12314 + "toolCount": 336,
12315 "triggerCount": 2,
11796 - "version": "20261029_00",
12316 + "version": "20261103_00",
12317 "tools": [
12318 {
12319 "slug": "HUBSPOT_ADD_ASSET_ASSOCIATION",
@@ -11863,12 +12383,12 @@
12383 {
12384 "slug": "HUBSPOT_ARCHIVE_EMAIL",
12385 "name": "ArchiveEmail email",
11866 - "description": "Archives the HubSpot email specified by `emailId` by moving it to the recycling bin, making it inaccessible unless restored."
12386 + "description": "Archives a HubSpot CRM email engagement by its numeric object ID, moving it to the recycling bin."
12387 },
12388 {
12389 "slug": "HUBSPOT_ARCHIVE_EMAILS",
12390 "name": "Archive emails",
11871 - "description": "Archives multiple HubSpot emails by their IDs."
12391 + "description": "Archives multiple HubSpot CRM email engagement records by their IDs."
12392 },
12393 {
12394 "slug": "HUBSPOT_ARCHIVE_FEEDBACK_SUBMISSION",
@@ -11955,6 +12475,11 @@
12475 "name": "Batch read workflow ID mappings",
12476 "description": "Resolves current flow IDs and legacy workflow IDs in one batch."
12477 },
12478 + {
12479 + "slug": "HUBSPOT_BATCH_READ_WORKFLOWS",
12480 + "name": "Batch read workflows",
12481 + "description": "Retrieves multiple HubSpot automation workflows by flow ID."
12482 + },
12483 {
12484 "slug": "HUBSPOT_BATCH_UPDATE_QUOTES",
12485 "name": "Batch update quotes",
@@ -12048,12 +12573,12 @@
12573 {
12574 "slug": "HUBSPOT_CREATE_CONTACT_FROM_NL",
12575 "name": "Create Contact From Natural Language",
12051 - "description": "Creates a new contact in HubSpot from a natural language description. Fetches the contact property schema at runtime, uses an LLM to generate the correct property payload, and creates the contact."
12576 + "description": "Creates a HubSpot contact from a natural language description, using the contact property schema and an LLM-generated property payload. Requires an OpenAI API key and can include supplied associations."
12577 },
12578 {
12579 "slug": "HUBSPOT_CREATE_CONTACTS",
12580 "name": "Create contacts",
12056 - "description": "Creates multiple new HubSpot contacts in a single batch operation."
12581 + "description": "Creates multiple HubSpot contacts in a batch, with contact properties and optional associations to existing CRM records. Custom properties should use the internal names of properties already defined in the account."
12582 },
12583 {
12584 "slug": "HUBSPOT_CREATE_CONTENT_TEMPLATE",
@@ -12063,7 +12588,7 @@
12588 {
12589 "slug": "HUBSPOT_CREATE_CRM_OBJECT_FROM_NL",
12590 "name": "Create CRM Object From Natural Language",
12066 - "description": "Creates a new CRM object (contact, deal, company, ticket, or custom object) in HubSpot from a natural language description. Fetches the object's property schema at runtime, uses an LLM to generate the correct property payload, and creates the object."
12591 + "description": "Creates a HubSpot CRM record from a natural-language description, including contacts, deals, companies, tickets, and custom objects. Optional associations can link the new record to other CRM objects."
12592 },
12593 {
12594 "slug": "HUBSPOT_CREATE_CRM_OBJECT_WITH_PROPERTIES",
@@ -12078,7 +12603,7 @@
12603 {
12604 "slug": "HUBSPOT_CREATE_DEAL_FROM_NL",
12605 "name": "Create Deal From Natural Language",
12081 - "description": "Creates a new deal in HubSpot from a natural language description. Fetches the deal property schema and pipeline stages at runtime, uses an LLM to generate the correct property payload, and creates the deal."
12606 + "description": "Creates a HubSpot deal from a natural language description using an LLM and the deal property schema. It attempts to fetch pipeline stages for context and accepts an optional pipeline override and associations."
12607 },
12608 {
12609 "slug": "HUBSPOT_CREATE_DEALS",
@@ -12098,7 +12623,7 @@
12623 {
12624 "slug": "HUBSPOT_CREATE_EMAILS",
12625 "name": "Create emails",
12101 - "description": "Creates multiple HubSpot emails in a single batch operation."
12626 + "description": "Creates multiple HubSpot CRM email engagement records in a single batch operation using supplied email properties."
12627 },
12628 {
12629 "slug": "HUBSPOT_CREATE_ENGAGEMENT",
@@ -12113,7 +12638,7 @@
12638 {
12639 "slug": "HUBSPOT_CREATE_FEEDBACK_SUBMISSION",
12640 "name": "Create feedback submission",
12116 - "description": "Creates a new HubSpot feedback submission to record customer feedback (e.g., survey responses, support interactions), optionally associating it with CRM objects."
12641 + "description": "Creates a HubSpot feedback submission with properties and an associations list, which may be empty."
12642 },
12643 {
12644 "slug": "HUBSPOT_CREATE_LANDING_PAGE",
@@ -12233,12 +12758,12 @@
12758 {
12759 "slug": "HUBSPOT_DELETE_CALL",
12760 "name": "Delete call",
12236 - "description": "Permanently deletes a HubSpot call record by its ID. This action removes a call engagement from the CRM. Use this action when you need to remove a specific call record that is no longer needed or was created in error. This action is irreversible - the call record cannot be recovered once deleted."
12761 + "description": "Deletes a HubSpot call record by its ID. The action returns error details in its response when the delete request fails."
12762 },
12763 {
12764 "slug": "HUBSPOT_DELETE_CALLING_EXTENSION_SETTINGS",
12765 "name": "Delete calling extension settings",
12241 - "description": "Permanently deletes the settings for a calling extension app, specified by its `appId`, rendering it unusable for all connected HubSpot accounts; this operation is irreversible."
12766 + "description": "Deletes the settings for a calling extension app identified by its app ID. The action returns error details in its response when the delete request fails."
12767 },
12768 {
12769 "slug": "HUBSPOT_DELETE_CAMPAIGN",
@@ -12318,12 +12843,17 @@
12843 {
12844 "slug": "HUBSPOT_DELETE_VIDEO_CONFERENCING_APP_SETTINGS",
12845 "name": "Delete video conferencing app settings",
12321 - "description": "Irreversibly deletes all settings for a video conferencing application identified by its `appId` in HubSpot, removing its configuration and preventing it from functioning until reconfigured; existing meetings and historical data are unaffected. Note: This API requires developer API key (hapikey) authentication from your HubSpot developer account, not OAuth tokens."
12846 + "description": "Deletes the settings for a specified HubSpot video conferencing application."
12847 },
12848 {
12849 "slug": "HUBSPOT_DELETE_WORKFLOW",
12850 "name": "Delete workflow",
12326 - "description": "Permanently deletes a HubSpot workflow by its ID; deleted workflows cannot be restored via the API and the ID must exist."
12851 + "description": "Permanently deletes a HubSpot workflow by its ID; deleted workflows cannot be restored via the API and the ID must exist. API error responses are returned in the result."
12852 + },
12853 + {
12854 + "slug": "HUBSPOT_DOWNLOAD_CMS_SOURCE_FILE",
12855 + "name": "Download CMS source file",
12856 + "description": "Download one file from HubSpot's CMS developer filesystem."
12857 },
12858 {
12859 "slug": "HUBSPOT_ENROLL_CONTACT_IN_WORKFLOW",
@@ -12353,7 +12883,7 @@
12883 {
12884 "slug": "HUBSPOT_GET_ACCOUNT_INFO",
12885 "name": "Get Account Information",
12356 - "description": "Gets current HubSpot account info (email, hubId, user details) using access-token lookup."
12886 + "description": "Retrieves current HubSpot account details, including the account ID, time zone, currencies, UI domain and data hosting location."
12887 },
12888 {
12889 "slug": "HUBSPOT_GET_ACTIVE_IMPORTS_LIST",
@@ -12368,7 +12898,7 @@
12898 {
12899 "slug": "HUBSPOT_GET_AGGREGATED_STATISTICS",
12900 "name": "Get aggregated statistics",
12371 - "description": "Retrieves aggregated statistics for marketing emails, optionally within an ISO8601 formatted time range, by email IDs, or specific email properties."
12901 + "description": "Retrieves aggregated marketing email statistics for a time range, with optional email ID and property parameters. Missing start and end timestamps default to 30 days ago and the current time, respectively."
12902 },
12903 {
12904 "slug": "HUBSPOT_GET_ALL_MARKETING_EMAILS_FOR_A_HUBSPOT_ACCOUNT",
@@ -12400,6 +12930,16 @@
12930 "name": "Get campaigns",
12931 "description": "Retrieves multiple HubSpot campaigns."
12932 },
12933 + {
12934 + "slug": "HUBSPOT_GET_CMS_SOURCE_METADATA",
12935 + "name": "Get CMS source metadata",
12936 + "description": "Retrieves metadata for one HubSpot CMS source path."
12937 + },
12938 + {
12939 + "slug": "HUBSPOT_GET_COMMUNICATION_STATUS",
12940 + "name": "Get communication status",
12941 + "description": "Retrieves detailed HubSpot communication statuses for an email address."
12942 + },
12943 {
12944 "slug": "HUBSPOT_GET_COMPANY",
12945 "name": "Get company",
@@ -12410,6 +12950,11 @@
12950 "name": "Get contact IDs",
12951 "description": "Fetches a list of contact IDs for a specific HubSpot campaign based on interaction type."
12952 },
12953 + {
12954 + "slug": "HUBSPOT_GET_CONTACT_WORKFLOW_ENROLLMENTS",
12955 + "name": "Get contact workflow enrollments",
12956 + "description": "Return the workflows in which a HubSpot contact is currently enrolled."
12957 + },
12958 {
12959 "slug": "HUBSPOT_GET_CRM_EXPORT_STATUS",
12960 "name": "Get CRM export status",
@@ -12465,10 +13010,20 @@
13010 "name": "Get exchange rate",
13011 "description": "Retrieves one HubSpot account exchange rate by ID."
13012 },
13013 + {
13014 + "slug": "HUBSPOT_GET_FILE",
13015 + "name": "Get file",
13016 + "description": "Retrieves one HubSpot file-manager record by file ID."
13017 + },
13018 + {
13019 + "slug": "HUBSPOT_GET_FILE_IMPORT_STATUS",
13020 + "name": "Get file import status",
13021 + "description": "Retrieves the status and result of a HubSpot URL file import task."
13022 + },
13023 {
13024 "slug": "HUBSPOT_GET_IMPORT_RECORD_INFORMATION",
13025 "name": "Get import record information",
12471 - "description": "Retrieves a comprehensive summary of a specific HubSpot CRM import record by its `importId`, including status, progress, updates, results, and errors; useful for monitoring and troubleshooting data imports."
13026 + "description": "Retrieves a HubSpot CRM import record by ID, including its status, metadata, and import configuration when available."
13027 },
13028 {
13029 "slug": "HUBSPOT_GET_LANDING_PAGE",
@@ -12523,7 +13078,7 @@
13078 {
13079 "slug": "HUBSPOT_GET_PRODUCTS",
13080 "name": "Get products",
12526 - "description": "Retrieves multiple HubSpot products by their IDs."
13081 + "description": "Retrieves multiple HubSpot products in a batch by their IDs or by values of a specified alternate unique identifier property."
13082 },
13083 {
13084 "slug": "HUBSPOT_GET_QUOTE",
@@ -12568,7 +13123,7 @@
13123 {
13124 "slug": "HUBSPOT_GET_TICKETS",
13125 "name": "Get tickets",
12571 - "description": "Retrieves multiple HubSpot tickets by their IDs."
13126 + "description": "Retrieves multiple HubSpot tickets in a batch by ticket IDs or values of an alternate unique identifier property."
13127 },
13128 {
13129 "slug": "HUBSPOT_GET_WORKFLOW_BY_ID",
@@ -12588,7 +13143,7 @@
13143 {
13144 "slug": "HUBSPOT_GET_WORKFLOWS",
13145 "name": "Get all workflows",
12591 - "description": "Retrieves a list of workflow summaries (ID, name, type, status) from HubSpot, using the 'limit' parameter for pagination."
13146 + "description": "Retrieves workflow summaries from HubSpot in a single request, applying the limit locally to the returned list."
13147 },
13148 {
13149 "slug": "HUBSPOT_LIST_ALL_ENGAGEMENTS",
@@ -12598,7 +13153,7 @@
13153 {
13154 "slug": "HUBSPOT_LIST_ASSETS",
13155 "name": "List assets",
12601 - "description": "Lists assets of a specific `assetType` for a given HubSpot marketing `campaignGuid`, optionally including performance metrics for a date range."
13156 + "description": "Lists assets of a specified type associated with a HubSpot marketing campaign, with pagination and optional date-range parameters. Responses are validated against a file-asset schema and do not expose performance metrics."
13157 },
13158 {
13159 "slug": "HUBSPOT_LIST_ASSOCIATED_ENGAGEMENTS",
@@ -12643,22 +13198,22 @@
13198 {
13199 "slug": "HUBSPOT_LIST_COMPANY_ACTIVITIES",
13200 "name": "List company activities",
12646 - "description": "List all activity/engagement associations from a company to a specified activity type (calls, emails, meetings, notes, or tasks). Returns the IDs of associated engagement records. Use this action when you need to retrieve all activities of a specific type for a company to build a timeline or activity history."
13201 + "description": "Lists a page of activity associations for a HubSpot company and a specified activity type, such as calls, emails, meetings, notes, or tasks. Returns associated record IDs and association metadata, with a cursor for further pages when available."
13202 },
13203 {
13204 "slug": "HUBSPOT_LIST_COMPANY_CALLS",
13205 "name": "List company calls",
12651 - "description": "Lists all calls associated with a specific HubSpot company. Returns call IDs and their association types with the company. Use this action when you need to retrieve all call activity records linked to a company without fetching full call details. For full call properties, use the returned call IDs with a call read action."
13206 + "description": "Lists a page of call associations for a HubSpot company, returning call IDs and association types. A cursor can be used to retrieve further pages."
13207 },
13208 {
13209 "slug": "HUBSPOT_LIST_COMPANY_MEETINGS",
13210 "name": "List company meetings",
12656 - "description": "List all meetings associated with a specific company in HubSpot. Returns meeting IDs and association metadata for meetings linked to the company record. Use this action when you need to retrieve all meetings scheduled with or related to a particular company."
13211 + "description": "Lists a page of meetings associated with a HubSpot company, returning meeting IDs and association metadata. A cursor can be used to retrieve further pages."
13212 },
13213 {
13214 "slug": "HUBSPOT_LIST_CONTACT_NOTES",
13215 "name": "List contact notes",
12661 - "description": "List all notes associated with a specific HubSpot contact. Returns note IDs and association metadata. Use this action when you need to retrieve all notes linked to a contact record. To get full note details (body, timestamp, etc.), use the note IDs with a batch read action."
13216 + "description": "Lists a page of notes associated with a HubSpot contact, returning note IDs and association metadata. A cursor can be used to retrieve further pages."
13217 },
13218 {
13219 "slug": "HUBSPOT_LIST_CONTACT_PROPERTIES",
@@ -12673,7 +13228,7 @@
13228 {
13229 "slug": "HUBSPOT_LIST_CONTACT_TASKS",
13230 "name": "List contact tasks",
12676 - "description": "List all tasks associated with a specific contact. Returns task IDs and association metadata for tasks linked to the given contact. Use this action when you need to retrieve all tasks related to a contact, such as viewing pending action items or following up on contact-related to-dos."
13231 + "description": "Lists a page of tasks associated with a HubSpot contact, returning task IDs and association metadata. A cursor can be used to retrieve further pages."
13232 },
13233 {
13234 "slug": "HUBSPOT_LIST_CONTENT_TEMPLATES",
@@ -12698,12 +13253,12 @@
13253 {
13254 "slug": "HUBSPOT_LIST_DEAL_ACTIVITIES",
13255 "name": "List deal activities",
12701 - "description": "Retrieves activities (notes, calls, emails, meetings, tasks) associated with a specific HubSpot deal. Use this action when you need to view the complete activity timeline for a deal, including all engagement types. This provides a comprehensive view of interactions and communications related to the deal, which is useful for understanding deal history and next steps."
13256 + "description": "Retrieves the first page of note, call, email, meeting, and task associations for a HubSpot deal, including activity IDs and association metadata. The returned count covers the retrieved associations, not necessarily all activities."
13257 },
13258 {
13259 "slug": "HUBSPOT_LIST_DEAL_MEETINGS",
13260 "name": "List deal meetings",
12706 - "description": "List all meetings associated with a specific deal in HubSpot. Returns meeting IDs and association metadata. Use this action when you need to retrieve meetings linked to a deal without fetching full meeting details. This is useful for understanding deal activity, tracking customer interactions, or building reports of engagement touchpoints."
13261 + "description": "Lists a page of meetings associated with a HubSpot deal, returning meeting IDs and association metadata. Use the returned cursor to request another page."
13262 },
13263 {
13264 "slug": "HUBSPOT_LIST_DEALS",
@@ -12743,7 +13298,12 @@
13298 {
13299 "slug": "HUBSPOT_LIST_FEEDBACK_SUBMISSIONS",
13300 "name": "List feedback submissions page",
12746 - "description": "Retrieves a paginated list of feedback submissions from HubSpot, allowing specification of properties (including history), associated object IDs, and filtering by archive status."
13301 + "description": "Retrieves a paginated list of HubSpot feedback submissions, with property selection and archive-status filtering. Returned properties are limited to the response model; requested property histories and associated object IDs are not represented in it."
13302 + },
13303 + {
13304 + "slug": "HUBSPOT_LIST_FORM_SUBMISSIONS",
13305 + "name": "List form submissions",
13306 + "description": "Lists one cursor-paginated page of submissions for a HubSpot form."
13307 },
13308 {
13309 "slug": "HUBSPOT_LIST_GRANTED_SCOPES",
@@ -12768,7 +13328,7 @@
13328 {
13329 "slug": "HUBSPOT_LIST_OBJECT_ASSOCIATIONS",
13330 "name": "List object associations",
12771 - "description": "List all associations from a single CRM record to a specified target object type. Use when you need to expand associations for a single record without fetching the full CRM object."
13331 + "description": "Lists a page of associations from a single CRM record to a specified target object type without fetching the full CRM object. Use the returned paging cursor to request further pages."
13332 },
13333 {
13334 "slug": "HUBSPOT_LIST_PRODUCTS",
@@ -12870,6 +13430,11 @@
13430 "name": "Merge tickets",
13431 "description": "Merges two HubSpot tickets into one."
13432 },
13433 + {
13434 + "slug": "HUBSPOT_MOVE_LIST_TO_FOLDER",
13435 + "name": "Move list to folder",
13436 + "description": "Move a HubSpot CRM list to a folder, including the root folder."
13437 + },
13438 {
13439 "slug": "HUBSPOT_PARTIALLY_UPDATE_CRM_OBJECT_BY_ID",
13440 "name": "Partially update CRM object by ID",
@@ -12943,7 +13508,7 @@
13508 {
13509 "slug": "HUBSPOT_READ_BUDGET",
13510 "name": "Read budget",
12946 - "description": "Fetches detailed budget (total, spent, remaining) and spend information for a marketing campaign, including an 'order' field for sequencing budget/spend items (0 is oldest)."
13511 + "description": "Retrieves budget totals for a specified HubSpot marketing campaign by its campaign ID."
13512 },
13513 {
13514 "slug": "HUBSPOT_READ_CONTACT",
@@ -12963,12 +13528,12 @@
13528 {
13529 "slug": "HUBSPOT_READ_EMAIL",
13530 "name": "ReadEmail Email",
12966 - "description": "Call this to retrieve an existing HubSpot email by its `emailId` or an alternative unique `idProperty`."
13531 + "description": "Retrieves an existing HubSpot CRM email object by its email ID or by the value of an alternative unique property, with the property name specified separately."
13532 },
13533 {
13534 "slug": "HUBSPOT_READ_FEEDBACK_SUBMISSION_BY_ID",
13535 "name": "Read feedback submission by id",
12971 - "description": "Reads a HubSpot feedback submission by its ID, optionally using a custom unique 'idProperty', and allows specifying properties to return including history and associations."
13536 + "description": "Reads a HubSpot feedback submission by ID or a custom unique property, with selected properties and property history. The returned properties are limited to the fields represented in the response model."
13537 },
13538 {
13539 "slug": "HUBSPOT_READ_LEGACY_CONTACT_PROFILE",
@@ -13013,7 +13578,7 @@
13578 {
13579 "slug": "HUBSPOT_REMOVE_CONTACT_SECONDARY_EMAIL",
13580 "name": "Remove contact secondary email",
13016 - "description": "Remove one secondary email address from a HubSpot contact."
13581 + "description": "Removes one secondary email address from a HubSpot contact identified by its legacy contact VID."
13582 },
13583 {
13584 "slug": "HUBSPOT_REMOVE_DEAL",
@@ -13093,7 +13658,7 @@
13658 {
13659 "slug": "HUBSPOT_RETRIEVE_LINE_ITEMS",
13660 "name": "Retrieve line items list",
13096 - "description": "Fetches a paginated list of HubSpot CRM line items, allowing selection of specific properties (including history), associated object IDs, and filtering by archive status; ensure property and association names are valid HubSpot internal names."
13661 + "description": "Fetches a paginated list of HubSpot CRM line items, with archive filtering and optional associated object IDs. Returned properties are limited to the fields supported by the response model; requested property history is not retained."
13662 },
13663 {
13664 "slug": "HUBSPOT_RETRIEVE_OBJECT_SCHEMA",
@@ -13108,7 +13673,7 @@
13673 {
13674 "slug": "HUBSPOT_RETRIEVE_OWNERS",
13675 "name": "Retrieve owners",
13111 - "description": "Retrieves a list of all owners in the HubSpot CRM, including their ID, first name, last name, email, and user ID."
13676 + "description": "Retrieves a page of HubSpot CRM owners, including their ID, name, email, and user ID. The response may include paging information, but this action does not accept a cursor to retrieve further pages."
13677 },
13678 {
13679 "slug": "HUBSPOT_RETRIEVE_PAGE_OF_CRM_OWNERS",
@@ -13118,7 +13683,7 @@
13683 {
13684 "slug": "HUBSPOT_RETRIEVE_PIPELINE_STAGE_BY_ID",
13685 "name": "Retrieve pipeline stage by id",
13121 - "description": "Fetches detailed properties and metadata (e.g., label, display order, custom properties) for a specific stage within a HubSpot CRM pipeline, identified by its `objectType`, `pipelineId`, and `stageId`."
13686 + "description": "Retrieves details and metadata for a specific HubSpot CRM pipeline stage identified by object type, pipeline ID, and stage ID."
13687 },
13688 {
13689 "slug": "HUBSPOT_RETRIEVE_PIPELINE_STAGES",
@@ -13133,7 +13698,12 @@
13698 {
13699 "slug": "HUBSPOT_RETRIEVE_VIDEO_CONFERENCE_SETTINGS_BY_ID",
13700 "name": "Retrieve video conference settings by id",
13136 - "description": "Retrieves video conference application settings, such as webhook URLs and user/account management configurations, for a specified `appId`."
13701 + "description": "Retrieves video conference application settings for a specified app, including meeting webhook URLs and a user verification URL."
13702 + },
13703 + {
13704 + "slug": "HUBSPOT_SCHEDULE_BLOG_POST",
13705 + "name": "Schedule blog post",
13706 + "description": "Schedules a HubSpot blog post to publish at a specified date and time."
13707 },
13708 {
13709 "slug": "HUBSPOT_SCHEDULE_LANDING_PAGE",
@@ -13145,6 +13715,11 @@
13715 "name": "Search campaigns",
13716 "description": "Searches for HubSpot campaigns."
13717 },
13718 + {
13719 + "slug": "HUBSPOT_SEARCH_CMS_CONTENT",
13720 + "name": "Search CMS content",
13721 + "description": "Search HubSpot's indexed CMS content."
13722 + },
13723 {
13724 "slug": "HUBSPOT_SEARCH_COMPANIES",
13725 "name": "Search companies",
@@ -13163,7 +13738,7 @@
13738 {
13739 "slug": "HUBSPOT_SEARCH_CRM_OBJECTS_BY_CRITERIA",
13740 "name": "Search crm objects by criteria",
13166 - "description": "Searches HubSpot CRM objects (e.g., 'contacts', 'companies') by `objectType` using complex criteria including filters, sorting, and pagination; property names used in filters, sorts, and returned properties must be valid for the specified `objectType`."
13741 + "description": "Searches HubSpot CRM objects by object type using a text query or filter groups, with sorting and pagination. At least one query or filter group is required; property names must be valid for the specified object type."
13742 },
13743 {
13744 "slug": "HUBSPOT_SEARCH_DEALS",
@@ -13173,12 +13748,12 @@
13748 {
13749 "slug": "HUBSPOT_SEARCH_EMAILS",
13750 "name": "Search emails",
13176 - "description": "Searches for HubSpot emails using flexible criteria and filters."
13751 + "description": "Searches HubSpot CRM email engagement records using a text query, with selectable properties and paginated results."
13752 },
13753 {
13754 "slug": "HUBSPOT_SEARCH_FEEDBACK_SUBMISSIONS",
13755 "name": "Search feedback submissions",
13181 - "description": "Searches for feedback submissions in HubSpot CRM using text query, filter groups, sorting, and pagination, returning specified properties."
13756 + "description": "Searches HubSpot CRM feedback submissions using a text query, filter groups, sorting, and pagination. Returned properties are limited to the fields represented in the response model."
13757 },
13758 {
13759 "slug": "HUBSPOT_SEARCH_LINE_ITEMS_BY_CRITERIA",
@@ -13208,7 +13783,7 @@
13783 {
13784 "slug": "HUBSPOT_START_IMPORT",
13785 "name": "Initiate data import process",
13211 - "description": "Call this action to start an asynchronous data import into HubSpot CRM using uploaded files and a detailed `importRequest` JSON configuration, ensuring this JSON correctly maps file columns to HubSpot properties and files align with these mappings."
13786 + "description": "Starts an asynchronous HubSpot CRM import using one uploaded file and an import configuration JSON mapping its columns to HubSpot properties."
13787 },
13788 {
13789 "slug": "HUBSPOT_UPDATE_A_MARKETING_EMAIL",
@@ -13258,7 +13833,7 @@
13833 {
13834 "slug": "HUBSPOT_UPDATE_CONTACT",
13835 "name": "Update contact",
13261 - "description": "Updates properties for an existing HubSpot contact."
13836 + "description": "Updates properties for an existing HubSpot contact. Known read-only properties are filtered out; if no properties remain, the current contact is returned without an update."
13837 },
13838 {
13839 "slug": "HUBSPOT_UPDATE_CONTACTS",
@@ -13288,7 +13863,7 @@
13863 {
13864 "slug": "HUBSPOT_UPDATE_EMAILS",
13865 "name": "Update emails",
13291 - "description": "Updates multiple HubSpot emails in a single batch operation."
13866 + "description": "Updates multiple HubSpot CRM email engagement records by ID in a single batch operation."
13867 },
13868 {
13869 "slug": "HUBSPOT_UPDATE_EMAIL_SUBSCRIPTIONS",
@@ -13348,7 +13923,7 @@
13923 {
13924 "slug": "HUBSPOT_UPDATE_PIPELINE_STAGE",
13925 "name": "Update pipeline stage by ids",
13351 - "description": "Partially updates a HubSpot CRM pipeline stage identified by `objectType`, `pipelineId`, and `stageId`, requiring `metadata` in the request; unspecified fields are unchanged."
13926 + "description": "Partially updates a HubSpot CRM pipeline stage identified by object type, pipeline ID, and stage ID. Metadata can be supplied along with other stage fields."
13927 },
13928 {
13929 "slug": "HUBSPOT_UPDATE_PRODUCT",
@@ -13370,6 +13945,11 @@
13945 "name": "Partial update quote by quote id",
13946 "description": "Performs a partial update on an existing HubSpot quote's specified properties, identifying the quote by `quoteId` (either its internal ID or a custom unique property value if `idProperty` is provided)."
13947 },
13948 + {
13949 + "slug": "HUBSPOT_UPDATE_SITE_PAGE",
13950 + "name": "Update site page",
13951 + "description": "Partially update one HubSpot site page without changing omitted properties."
13952 + },
13953 {
13954 "slug": "HUBSPOT_UPDATE_SITE_PAGE_DRAFT",
13955 "name": "Update site page draft",
@@ -13388,12 +13968,12 @@
13968 {
13969 "slug": "HUBSPOT_UPDATE_TOKEN_ON_EVENT_TEMPLATE",
13970 "name": "Update token on event template",
13391 - "description": "Updates the label or options of an existing token within a specified HubSpot CRM event template; token name and data type remain unchanged."
13971 + "description": "Updates an existing token in a HubSpot CRM event template, including its label, options, or CRM object property mapping. The token name and data type remain unchanged."
13972 },
13973 {
13974 "slug": "HUBSPOT_UPDATE_VIDEO_CONFERENCE_APP_SETTINGS",
13975 "name": "Update video conference app settings",
13396 - "description": "Updates webhook URLs (for creating/updating/deleting meetings, fetching accounts, verifying users) for a video conference application specified by `appId`. Requires developer API key authentication. All URLs must use HTTPS protocol and be publicly accessible."
13976 + "description": "Updates webhook URLs for a specified HubSpot video conference application, including URLs for creating, updating and deleting meetings, fetching accounts, and verifying users."
13977 },
13978 {
13979 "slug": "HUBSPOT_UPDATE_WORKFLOW",
@@ -13525,12 +14105,12 @@
14105 ],
14106 "toolCount": 48,
14107 "triggerCount": 12,
13528 - "version": "20260924_00",
14108 + "version": "20261101_00",
14109 "tools": [
14110 {
14111 "slug": "LINEAR_ARCHIVE_ISSUE",
14112 "name": "Archive issue",
13533 - "description": "Archives an existing Linear issue by its ID, removing it from active views while preserving its data for future reference. Use this action when you need to remove an issue from active work without permanently deleting it — for example, when an issue is no longer relevant, was created by mistake, or has been superseded by another issue. Archiving is reversible via the unarchive mutation, unlike permanent deletion. This action is irreversible through the API once completed, though issues can be manually unarchived in the Linear UI or via the issueUnarchive mutation."
14113 + "description": "Archives an existing Linear issue by its UUID or shorthand identifier, removing it from active views while preserving its data for future reference."
14114 },
14115 {
14116 "slug": "LINEAR_ARCHIVE_PROJECT",
@@ -13560,7 +14140,7 @@
14140 {
14141 "slug": "LINEAR_CREATE_LINEAR_ISSUE",
14142 "name": "Create linear issue",
13563 - "description": "Creates a new issue in a specified Linear project and team, requiring team_id and title, and allowing optional properties like description, assignee, state, priority, cycle, and due date. All UUID parameters (state_id, assignee_id, cycle_id, label_ids, project_id) must belong to the same team as team_id. The created issue's id is returned in data.id — capture it for use as parent_id in sub-issues or follow-up operations. No template_id field exists; expand templates manually into title and description before calling."
14143 + "description": "Creates an issue in a specified Linear team with a title and optional project, description, assignee, state, priority, cycle, due date, and other properties. Returns the created issue's ID and URL."
14144 },
14145 {
14146 "slug": "LINEAR_CREATE_LINEAR_ISSUE_RELATION",
@@ -13570,7 +14150,7 @@
14150 {
14151 "slug": "LINEAR_CREATE_LINEAR_LABEL",
14152 "name": "Create a label",
13573 - "description": "Creates a new label in Linear for a specified team, used to categorize and organize issues. Label names must be unique within each team. If a label with the same name already exists, the existing label will be returned. Both new and existing labels return the same object structure; check the label's `createdAt` or compare IDs to determine if creation occurred."
14153 + "description": "Creates a label for a specified Linear team, or returns an existing exact-name match found in the team's initial label results. The response includes an execution message when an existing label is returned."
14154 },
14155 {
14156 "slug": "LINEAR_CREATE_LINEAR_PROJECT",
@@ -13615,12 +14195,12 @@
14195 {
14196 "slug": "LINEAR_GET_CURRENT_USER",
14197 "name": "Get current user",
13618 - "description": "Gets the currently authenticated user's ID, name, email, and other profile information — this is the account behind the API token, which may be a bot or service account rather than a human user. Use the returned `id` field (nested under `data.viewer`) for downstream Linear operations requiring user ID filtering. To search or compare other workspace members, use LINEAR_LIST_LINEAR_USERS instead."
14198 + "description": "Gets the currently authenticated Linear user's ID, name, email, and other profile information. The account behind the token may be a bot or service account; the user ID is returned under user.id."
14199 },
14200 {
14201 "slug": "LINEAR_GET_CYCLES_BY_TEAM_ID",
14202 "name": "Get cycles by team ID",
13623 - "description": "Retrieves all cycles for a specified Linear team ID; cycles are time-boxed work periods (like sprints). Results are team-scoped to the given team_id. To identify the active cycle, check that the current date (in UTC) falls between a cycle's startAt and endAt fields; either field may be null. Results may be paginated — follow page_info cursors to retrieve all cycles."
14203 + "description": "Lists cycles for a specified Linear team ID, including progress, creation and end times, and history. Results are paginated; follow page_info cursors to retrieve subsequent pages."
14204 },
14205 {
14206 "slug": "LINEAR_GET_ISSUE_DEFAULTS",
@@ -13630,7 +14210,7 @@
14210 {
14211 "slug": "LINEAR_GET_LINEAR_ISSUE",
14212 "name": "Get Linear issue",
13633 - "description": "Retrieves an existing Linear issue's comprehensive details, including id, identifier, title, description, timestamps, state, team, creator, attachments, comments (with user info and timestamps, use issue.comments.nodes for comment IDs), subscribers, and due date. Embedded screenshots are uploads.linear.app URLs in description/comment Markdown, not Attachment records; download them with LINEAR_GET_ATTACHMENT's upload_url input. Does not include parent, milestone, cycle, or relation graphs—use LINEAR_RUN_QUERY_OR_MUTATION for those. Optional fields (labels, project, state, assignee, cycle) may be null; guard against null when accessing nested properties. Returns null or 'Entity not found' for invalid IDs, cross-workspace IDs, or restricted teams. Rate limit: ~60 req/min; HTTP 429 on excess—apply exponential backoff and respect Retry-After headers."
14213 + "description": "Retrieves a Linear issue by UUID or shorthand identifier, including its details, parent, cycle, attachments, comments and subscribers. Optional related fields may be null; certain issue-not-found errors return a null issue with an explanatory message."
14214 },
14215 {
14216 "slug": "LINEAR_GET_LINEAR_PROJECT",
@@ -13650,7 +14230,7 @@
14230 {
14231 "slug": "LINEAR_LIST_ISSUE_DRAFTS",
14232 "name": "List issue drafts",
13653 - "description": "Tool to list issue drafts. Use when you need to fetch draft issues for review or further editing. Check `pageInfo.hasNextPage` in the response to determine if additional drafts exist beyond the current page."
14233 + "description": "Lists the connected user's issue drafts for review or editing. Results are paginated; check page_info.hasNextPage for additional drafts."
14234 },
14235 {
14236 "slug": "LINEAR_LIST_ISSUES_BY_TEAM_ID",
@@ -13660,17 +14240,17 @@
14240 {
14241 "slug": "LINEAR_LIST_LINEAR_CYCLES",
14242 "name": "Get all cycles",
13663 - "description": "Retrieves all cycles (time-boxed sprint iterations) org-wide from the Linear account; no filters applied. In large multi-team workspaces this produces heavy responses — filter client-side by team ID and date range using each cycle's startsAt/endsAt fields. Cycles are team-scoped; always group by team ID to avoid mixing sprints across teams. To identify the active sprint, verify the current UTC timestamp falls between startsAt and endsAt, and handle null startsAt/endsAt defensively. Timestamps are UTC. Results may be paginated; follow pageInfo.endCursor and hasNextPage until hasNextPage is false to avoid truncated lists."
14243 + "description": "Lists cycles across the Linear account without filters, including team IDs and scheduled end times. Results are paginated; use page_info.endCursor and hasNextPage to retrieve subsequent pages."
14244 },
14245 {
14246 "slug": "LINEAR_LIST_LINEAR_ISSUES",
14247 "name": "List Linear issues",
13668 - "description": "Lists non-archived Linear issues; if project_id is not specified, issues from all accessible projects are returned. Can filter by assignee_id. Only project_id and assignee_id server-side filters are supported; label, state, team, cycle, or date filters must be done client-side or via LINEAR_RUN_QUERY_OR_MUTATION. Response is a flat issues array plus page_info object (not GraphQL nodes/pageInfo). Fields like cycle membership, dueDate, completedAt, comments, and attachments are absent; use LINEAR_GET_LINEAR_ISSUE for enrichment. state and labels are nested objects (labels as labels.nodes array). Response order is not guaranteed; sort client-side after collecting all pages. No team_id filter; scope by project_id or use LINEAR_RUN_QUERY_OR_MUTATION."
14248 + "description": "Lists non-archived Linear issues with optional project and assignee filters, returning a paginated issues array and page_info. Issues include due dates; optional transition history includes completion timestamps and may be truncated or report per-issue errors."
14249 },
14250 {
14251 "slug": "LINEAR_LIST_LINEAR_LABELS",
14252 "name": "Get labels",
13673 - "description": "Retrieves labels from Linear. If team_id is provided, returns labels for that specific team; if omitted, returns all labels across the workspace. Label names are not unique across teams — always use returned IDs, not names, and track each label ID with its team ID. In large workspaces, results may paginate; follow pageInfo.hasNextPage and pageInfo.endCursor to retrieve all labels."
14253 + "description": "Retrieves paginated Linear issue labels for a specified team or across the workspace. Use page_info.hasNextPage and page_info.endCursor to fetch further pages."
14254 },
14255 {
14256 "slug": "LINEAR_LIST_LINEAR_PROJECTS",
@@ -13685,12 +14265,12 @@
14265 {
14266 "slug": "LINEAR_LIST_LINEAR_TEAMS",
14267 "name": "Get teams",
13688 - "description": "Retrieves all teams with their members and projects. Use stable team IDs or keys (not display names) for subsequent operations — names are non-unique. Results reflect only teams visible to the authenticated token scope; missing teams or members indicate permission limits. Large workspaces paginate via pageInfo.hasNextPage/endCursor — incomplete pagination silently drops teams or members. Members may belong to multiple teams; deduplicate user IDs when aggregating. Use LINEAR_GET_ALL_LINEAR_TEAMS instead when only identifiers are needed."
14268 + "description": "Lists visible Linear teams with their members and project IDs, with pagination for teams but not nested members or projects. An optional project ID filters each team's projects rather than the teams themselves."
14269 },
14270 {
14271 "slug": "LINEAR_LIST_LINEAR_USERS",
14272 "name": "List Linear users",
13693 - "description": "Lists all workspace users (not team-scoped) with their IDs, names, emails, and active status. Display names are non-unique — use email to disambiguate before extracting an ID. Only assign users with `active: true`. Returned IDs are UUID strings; pass them as-is to fields like `assignee_id` — never substitute names, emails, or tokens. When joining with other tools, always join on IDs."
14273 + "description": "Lists workspace users with IDs, names, emails, and active status. Results are paginated; use the returned cursor to retrieve subsequent pages."
14274 },
14275 {
14276 "slug": "LINEAR_LIST_PROJECT_UPDATES",
@@ -13700,7 +14280,7 @@
14280 {
14281 "slug": "LINEAR_REMOVE_ISSUE_LABEL",
14282 "name": "Remove label from Linear issue",
13703 - "description": "Removes a specified label from an existing Linear issue using their IDs; successful even if the label isn't on the issue. Operation is irreversible — obtain explicit user approval before executing. Use this tool instead of LINEAR_UPDATE_ISSUE to avoid replacing the entire label set."
14283 + "description": "Removes a specified label from a Linear issue using the issue and label IDs, and returns the updated issue and labels. If the label is absent, the label set is unchanged. The operation replaces the fetched label set, so concurrent label changes may be overwritten."
14284 },
14285 {
14286 "slug": "LINEAR_REMOVE_REACTION",
@@ -13715,12 +14295,12 @@
14295 {
14296 "slug": "LINEAR_RUN_QUERY_OR_MUTATION",
14297 "name": "Run Query or Mutation",
13718 - "description": "Execute any GraphQL query or mutation against Linear's API. USE WHEN: No dedicated action exists, need complex filtering, custom fields, or schema discovery. *** INTROSPECTION FIRST - NEVER GUESS FIELD NAMES *** Run introspection before unknown operations: - query { __type(name: \"Issue\") { fields { name } } } - query { __type(name: \"Mutation\") { fields { name } } } Linear uses nested objects (project { id }), NOT scalar IDs (projectId). KEY: All IDs are UUIDs. Filter: { field: { eq: value } }. Pagination: nodes[] + pageInfo."
14298 + "description": "Execute a Linear GraphQL query or mutation to retrieve or change accessible data. Use it for custom filtering, schema introspection, or operations without a dedicated action. When an operation partially succeeds, the response can include both data and errors."
14299 },
14300 {
14301 "slug": "LINEAR_SEARCH_ISSUES",
14302 "name": "Search Linear issues",
13723 - "description": "Search Linear issues using full-text search across identifier, title, and description. Use when you need to find issues by keywords or specific identifiers. Note: This endpoint only supports full-text search; for structured filtering by team, project, assignee, state, or labels, use LIST_ISSUES_BY_TEAM_ID instead."
14303 + "description": "Searches Linear issues by full-text query, with pagination and an option to include archived issues."
14304 },
14305 {
14306 "slug": "LINEAR_UNARCHIVE_PROJECT_UPDATE",
@@ -13735,7 +14315,7 @@
14315 {
14316 "slug": "LINEAR_UPDATE_ISSUE",
14317 "name": "Update issue",
13738 - "description": "Updates an existing Linear issue using its `issue_id`; requires at least one other attribute for modification, and all provided entity IDs (for state, assignee, labels, etc.) must be valid UUIDs — only `issueId` accepts key format (e.g., 'ENG-123'). All updated fields are fully overwritten, not merged; omit any field you do not intend to change."
14318 + "description": "Updates an existing Linear issue by ID, requiring at least one field to modify; supplied fields overwrite existing values and labels replace the label set. A team move combined with a state, project, or cycle update runs in two phases, so an error may leave the first phase applied."
14319 },
14320 {
14321 "slug": "LINEAR_UPDATE_LINEAR_COMMENT",
@@ -13755,7 +14335,7 @@
14335 {
14336 "slug": "LINEAR_UPDATE_TEAM",
14337 "name": "Update Team",
13758 - "description": "Updates an existing Linear team's settings and configuration. Use when you need to modify team properties like name, description, key, cycle settings, workflow states, or other team-level configurations. All fields except team_id are optional - only provide the fields you want to update."
14338 + "description": "Updates an existing Linear team's settings, including its name, key, cycle settings, and workflow state configuration. At least one update field must be provided."
14339 },
14340 {
14341 "slug": "LINEAR_VALIDATE_CREDENTIAL",
@@ -13919,7 +14499,7 @@
14499 ],
14500 "toolCount": 28,
14501 "triggerCount": 6,
13922 - "version": "20261013_00",
14502 + "version": "20261101_00",
14503 "tools": [
14504 {
14505 "slug": "AIRTABLE_CREATE_BASE",
@@ -13934,22 +14514,22 @@
14514 {
14515 "slug": "AIRTABLE_CREATE_FIELD",
14516 "name": "Create Field",
13937 - "description": "Creates a new field within a specified table in an Airtable base."
14517 + "description": "Creates a new field within a specified table in an Airtable base. The action first reads the base schema to resolve the table and check existing fields, so it requires schema read access as well as write access."
14518 },
14519 {
14520 "slug": "AIRTABLE_CREATE_MULTIPLE_RECORDS",
14521 "name": "Create multiple records (Deprecated)",
13942 - "description": "DEPRECATED: Use AIRTABLE_CREATE_RECORDS instead. Creates multiple new records in a specified Airtable table."
14522 + "description": "DEPRECATED: Use AIRTABLE_CREATE_RECORDS instead. Creates multiple records in a specified Airtable table in batches of up to 10; if a later batch fails, earlier batches may already have been created."
14523 },
14524 {
14525 "slug": "AIRTABLE_CREATE_RECORD",
14526 "name": "Create a record (Deprecated)",
13947 - "description": "DEPRECATED: Use CreateRecords instead. Creates a new record in a specified Airtable table; field values must conform to the table's column types."
14527 + "description": "DEPRECATED: Use CreateRecords instead. Creates a new record in a specified Airtable table; field values must conform to column types, null, empty-string and false values are omitted, and some values may be normalized before submission."
14528 },
14529 {
14530 "slug": "AIRTABLE_CREATE_RECORD_FROM_NATURAL_LANGUAGE",
14531 "name": "Create Record From Natural Language",
13952 - "description": "Creates a new record in an Airtable table from a natural language description. Fetches the table schema, uses an LLM to generate the correct field payload, and creates the record with typecast enabled for automatic type conversion."
14532 + "description": "Creates an Airtable record from a natural language description using the table schema and an LLM-generated field payload. Typecast is enabled by default and can be disabled."
14533 },
14534 {
14535 "slug": "AIRTABLE_CREATE_RECORDS",
@@ -13959,7 +14539,7 @@
14539 {
14540 "slug": "AIRTABLE_CREATE_TABLE",
14541 "name": "Create table",
13962 - "description": "Creates a new table within a specified existing Airtable base, allowing definition of its name, description, and field structure."
14542 + "description": "Creates a table in an existing Airtable base with a specified name, description, and field structure. Optionally returns an existing same-name table instead of creating one."
14543 },

This file is too large to show in full.

docs/public/openapi-v3.json
+102 -4
@@ -204,6 +204,7 @@
204 },
205 "name": {
206 "type": "string",
207 + "maxLength": 255,
208 "description": "The name of the integration"
209 },
210 "credentials": {
@@ -296,6 +297,7 @@
297 },
298 "name": {
299 "type": "string",
300 + "maxLength": 255,
301 "description": "The name of the integration"
302 },
303 "authScheme": {
@@ -438,6 +440,7 @@
440 "name": {
441 "type": "string",
442 "minLength": 1,
443 + "maxLength": 255,
444 "description": "The display name of the authentication configuration"
445 },
446 "credentials": {
@@ -564,6 +567,7 @@
567 "name": {
568 "type": "string",
569 "minLength": 1,
570 + "maxLength": 255,
571 "description": "The display name of the authentication configuration"
572 },
573 "scopes": {
@@ -650,6 +654,7 @@
654 "properties": {
655 "alias": {
656 "type": "string",
657 + "maxLength": 255,
658 "description": "A human-readable alias for this connected account. Pass an empty string to clear the alias. Must be unique per entity and toolkit within the project."
659 },
660 "connection": {
@@ -2555,6 +2560,7 @@
2560 }
2561 ],
2562 "requestBody": {
2563 + "required": true,
2564 "content": {
2565 "application/json": {
2566 "schema": {
@@ -4423,6 +4429,7 @@
4429 }
4430 ],
4431 "requestBody": {
4432 + "required": true,
4433 "content": {
4434 "application/json": {
4435 "schema": {
@@ -4610,6 +4617,7 @@
4617 },
4618 "alias": {
4619 "type": "string",
4620 + "maxLength": 255,
4621 "description": "A human-readable alias for this connected account. Must be unique per entity and toolkit within the project."
4622 },
4623 "callback_url": {
@@ -5786,6 +5794,7 @@
5794 }
5795 ],
5796 "requestBody": {
5797 + "required": true,
5798 "content": {
5799 "application/json": {
5800 "schema": {
@@ -6099,6 +6108,7 @@
6108 },
6109 "alias": {
6110 "type": "string",
6111 + "maxLength": 255,
6112 "description": "A human-readable alias for this connected account. Must be unique per entity and toolkit within the project."
6113 },
6114 "callback_url": {
@@ -7031,7 +7041,8 @@
7041 "type": "string"
7042 },
7043 "display_name": {
7034 - "type": "string"
7044 + "type": "string",
7045 + "maxLength": 75
7046 },
7047 "mask_secret_keys_in_connected_account": {
7048 "type": "boolean"
@@ -13157,7 +13168,7 @@
13168 "/api/v3/trigger_instances/{slug}/upsert": {
13169 "post": {
13170 "summary": "Create or update a trigger",
13160 - "description": "Creates a new trigger instance or updates an existing one with the same configuration. Triggers listen for events from external services (webhooks or polling) and can invoke your workflows. If a matching trigger already exists and is disabled, it will be re-enabled. Provide either a connected_account_id to pin a specific user connection, or a user_id to auto-resolve the first active connection for that user and the trigger's toolkit.",
13171 + "description": "Creates a new trigger instance or updates an existing one with the same configuration. Triggers listen for events from external services (webhooks or polling) and can invoke your workflows. If a matching trigger already exists and is disabled, it will be re-enabled. Provide either a connected_account_id to pin a specific user connection, or a user_id to auto-resolve the first active connection for that user and the trigger's toolkit. For a trigger that supports both webhooks and polling, Composio chooses the best way for the instance to receive events unless type sets one. When the instance polls because a webhook could not be set up, fallback_reason says why. An existing instance keeps its type, so an upsert asking for the other type returns 409.",
13172 "tags": [
13173 "Triggers"
13174 ],
@@ -13221,6 +13232,20 @@
13232 "additionalProperties": {},
13233 "description": "Trigger configuration"
13234 },
13235 + "type": {
13236 + "type": "string",
13237 + "enum": [
13238 + "poll",
13239 + "webhook"
13240 + ],
13241 + "description": "Whether this instance receives events by webhook or by polling, for a trigger that supports both. Omit it to let Composio choose the best one."
13242 + },
13243 + "polling_interval": {
13244 + "type": "integer",
13245 + "minimum": 1,
13246 + "maximum": 10080,
13247 + "description": "Minutes between polls, for an instance that polls for its events. It is checked whenever the instance could poll, even when Composio tries a webhook first, so an interval outside the toolkit's allowed range fails the request."
13248 + },
13249 "version": {
13250 "type": "string",
13251 "description": "DEPRECATED: This parameter will be removed in a future version. Please use toolkit_versions instead.",
@@ -13262,10 +13287,34 @@
13287 "trigger_id": {
13288 "type": "string",
13289 "description": "ID of the updated trigger"
13290 + },
13291 + "type": {
13292 + "type": "string",
13293 + "enum": [
13294 + "webhook",
13295 + "poll"
13296 + ],
13297 + "description": "How this trigger instance gets events: webhook (the provider notifies) or poll (a scheduled check).",
13298 + "example": "webhook"
13299 + },
13300 + "fallback_reason": {
13301 + "type": "string",
13302 + "nullable": true,
13303 + "description": "Set when Composio downgraded to a poll-based mechanism instead of webhooks for this trigger.",
13304 + "example": "No webhook endpoint found for toolkit \"gmail\". Create a webhook endpoint before setting up triggers."
13305 + },
13306 + "polling_interval": {
13307 + "type": "integer",
13308 + "nullable": true,
13309 + "description": "Minutes between scheduled polls for a poll instance.",
13310 + "example": 15
13311 }
13312 },
13313 "required": [
13268 - "trigger_id"
13314 + "trigger_id",
13315 + "type",
13316 + "fallback_reason",
13317 + "polling_interval"
13318 ]
13319 }
13320 }
@@ -13281,10 +13330,34 @@
13330 "trigger_id": {
13331 "type": "string",
13332 "description": "ID of the updated trigger"
13333 + },
13334 + "type": {
13335 + "type": "string",
13336 + "enum": [
13337 + "webhook",
13338 + "poll"
13339 + ],
13340 + "description": "How this trigger instance gets events: webhook (the provider notifies) or poll (a scheduled check).",
13341 + "example": "webhook"
13342 + },
13343 + "fallback_reason": {
13344 + "type": "string",
13345 + "nullable": true,
13346 + "description": "Set when Composio downgraded to a poll-based mechanism instead of webhooks for this trigger.",
13347 + "example": "No webhook endpoint found for toolkit \"gmail\". Create a webhook endpoint before setting up triggers."
13348 + },
13349 + "polling_interval": {
13350 + "type": "integer",
13351 + "nullable": true,
13352 + "description": "Minutes between scheduled polls for a poll instance.",
13353 + "example": 15
13354 }
13355 },
13356 "required": [
13287 - "trigger_id"
13357 + "trigger_id",
13358 + "type",
13359 + "fallback_reason",
13360 + "polling_interval"
13361 ]
13362 }
13363 }
@@ -13690,6 +13763,27 @@
13763 "additionalProperties": {},
13764 "description": "Configuration for the trigger"
13765 },
13766 + "type": {
13767 + "type": "string",
13768 + "enum": [
13769 + "webhook",
13770 + "poll"
13771 + ],
13772 + "description": "How this trigger instance gets events: webhook (the provider notifies) or poll (a scheduled check).",
13773 + "example": "webhook"
13774 + },
13775 + "fallback_reason": {
13776 + "type": "string",
13777 + "nullable": true,
13778 + "description": "Set when Composio downgraded to a poll-based mechanism instead of webhooks for this trigger.",
13779 + "example": "No webhook endpoint found for toolkit \"gmail\". Create a webhook endpoint before setting up triggers."
13780 + },
13781 + "polling_interval": {
13782 + "type": "integer",
13783 + "nullable": true,
13784 + "description": "Minutes between scheduled polls for a poll instance.",
13785 + "example": 15
13786 + },
13787 "egress_url": {
13788 "type": "string",
13789 "nullable": true,
@@ -13760,6 +13854,9 @@
13854 "user_id",
13855 "version",
13856 "trigger_config",
13857 + "type",
13858 + "fallback_reason",
13859 + "polling_interval",
13860 "egress_url",
13861 "state",
13862 "updated_at",
@@ -23758,6 +23855,7 @@
23855 },
23856 "alias": {
23857 "type": "string",
23858 + "maxLength": 255,
23859 "description": "A human-readable alias for this connected account. Must be unique per entity and toolkit within the project."
23860 },
23861 "callback_url": {
docs/public/openapi-webhooks.json
+6
@@ -111,6 +111,10 @@
111 "type": "string",
112 "description": "The trigger that fired (for example GITHUB_COMMIT_EVENT)."
113 },
114 + "toolkit_slug": {
115 + "type": "string",
116 + "description": "Lowercase slug of the toolkit of the connected account the trigger belongs to (for example one_drive). It matches the trigger type's toolkit, except for some older Slack bot triggers, which report `slack`. Use it instead of parsing `trigger_slug`."
117 + },
118 "trigger_id": {
119 "type": "string",
120 "description": "ID of the trigger instance."
@@ -134,6 +138,7 @@
138 "required": [
139 "log_id",
140 "trigger_slug",
141 + "toolkit_slug",
142 "trigger_id",
143 "connected_account_id",
144 "auth_config_id",
@@ -161,6 +166,7 @@
166 "metadata": {
167 "log_id": "log_abc123",
168 "trigger_slug": "GITHUB_COMMIT_EVENT",
169 + "toolkit_slug": "github",
170 "trigger_id": "ti_xyz789",
171 "connected_account_id": "ca_def456",
172 "auth_config_id": "ac_xyz789",
docs/public/openapi.json
+672 -153
@@ -121,9 +121,6 @@
121 "name": "Arena",
122 "description": "Arena conversations, messages and terms"
123 },
124 - {
125 - "name": "Invite Codes"
126 - },
124 {
125 "name": "Projects"
126 },
@@ -2094,6 +2091,7 @@
2091 },
2092 "name": {
2093 "type": "string",
2094 + "maxLength": 255,
2095 "description": "The name of the integration"
2096 },
2097 "credentials": {
@@ -2186,6 +2184,7 @@
2184 },
2185 "name": {
2186 "type": "string",
2187 + "maxLength": 255,
2188 "description": "The name of the integration"
2189 },
2190 "authScheme": {
@@ -2328,6 +2327,7 @@
2327 "name": {
2328 "type": "string",
2329 "minLength": 1,
2330 + "maxLength": 255,
2331 "description": "The display name of the authentication configuration"
2332 },
2333 "credentials": {
@@ -2454,6 +2454,7 @@
2454 "name": {
2455 "type": "string",
2456 "minLength": 1,
2457 + "maxLength": 255,
2458 "description": "The display name of the authentication configuration"
2459 },
2460 "scopes": {
@@ -2540,6 +2541,7 @@
2541 "properties": {
2542 "alias": {
2543 "type": "string",
2544 + "maxLength": 255,
2545 "description": "A human-readable alias for this connected account. Pass an empty string to clear the alias. Must be unique per entity and toolkit within the project."
2546 },
2547 "connection": {
@@ -3678,6 +3680,7 @@
3680 }
3681 ],
3682 "requestBody": {
3683 + "required": true,
3684 "content": {
3685 "application/json": {
3686 "schema": {
@@ -3783,7 +3786,8 @@
3786 },
3787 "cursor": {
3788 "type": "string",
3786 - "nullable": true
3789 + "nullable": true,
3790 + "description": "The `next_cursor` from the previous page. Omit it for the first page."
3791 },
3792 "filters": {
3793 "type": "array",
@@ -3946,7 +3950,8 @@
3950 },
3951 "next_cursor": {
3952 "type": "string",
3949 - "nullable": true
3953 + "nullable": true,
3954 + "description": "Opaque cursor for the next page; pass it back as `cursor`. Null when the page is empty."
3955 }
3956 },
3957 "required": [
@@ -6244,128 +6249,6 @@
6249 "x-api-version": "3.1"
6250 }
6251 },
6247 - "/api/v3.1/org/clanker/create_claim": {
6248 - "post": {
6249 - "summary": "Create a clanker-claim slug",
6250 - "description": "Mints a four-word claim slug (no email sent) tied to the org's clanker and restricted to the given human email. The human redeems it via POST /api/v3.1/org/clanker/redeem_claim while authenticated. On redeem, the human joins the org and is recorded as the humanOwner of the clanker. Called by external services (e.g. agents.composio.dev) using an org API key.",
6251 - "tags": [
6252 - "Invite Codes"
6253 - ],
6254 - "operationId": "postOrgClankerCreateClaim",
6255 - "security": [
6256 - {
6257 - "OrgApiKeyAuth": []
6258 - }
6259 - ],
6260 - "requestBody": {
6261 - "content": {
6262 - "application/json": {
6263 - "schema": {
6264 - "type": "object",
6265 - "properties": {
6266 - "human_email": {
6267 - "type": "string",
6268 - "format": "email",
6269 - "description": "Email of the human who will claim the clanker"
6270 - }
6271 - },
6272 - "required": [
6273 - "human_email"
6274 - ]
6275 - }
6276 - }
6277 - }
6278 - },
6279 - "responses": {
6280 - "200": {
6281 - "description": "Clanker claim invite created and emailed.",
6282 - "content": {
6283 - "application/json": {
6284 - "schema": {
6285 - "type": "object",
6286 - "properties": {
6287 - "claim_slug": {
6288 - "type": "string",
6289 - "description": "Four-word hyphen-separated slug (e.g. \"red-castle-amber-pine\") the human types into /redeem_claim. Valid for 7 days, restricted to the provided email."
6290 - },
6291 - "expires_at": {
6292 - "type": "string",
6293 - "format": "date-time",
6294 - "description": "ISO timestamp when this claim slug expires."
6295 - }
6296 - },
6297 - "required": [
6298 - "claim_slug",
6299 - "expires_at"
6300 - ]
6301 - }
6302 - }
6303 - }
6304 - },
6305 - "400": {
6306 - "description": "Bad request.",
6307 - "content": {
6308 - "application/json": {
6309 - "schema": {
6310 - "$ref": "#/components/schemas/Error"
6311 - }
6312 - }
6313 - }
6314 - },
6315 - "401": {
6316 - "description": "Unauthorized.",
6317 - "content": {
6318 - "application/json": {
6319 - "schema": {
6320 - "$ref": "#/components/schemas/Error"
6321 - }
6322 - }
6323 - }
6324 - },
6325 - "403": {
6326 - "description": "Forbidden.",
6327 - "content": {
6328 - "application/json": {
6329 - "schema": {
6330 - "$ref": "#/components/schemas/Error"
6331 - }
6332 - }
6333 - }
6334 - },
6335 - "404": {
6336 - "description": "Org has no clanker to claim.",
6337 - "content": {
6338 - "application/json": {
6339 - "schema": {
6340 - "$ref": "#/components/schemas/Error"
6341 - }
6342 - }
6343 - }
6344 - },
6345 - "409": {
6346 - "description": "Conflict. The org's clanker has already been claimed.",
6347 - "content": {
6348 - "application/json": {
6349 - "schema": {
6350 - "$ref": "#/components/schemas/Error"
6351 - }
6352 - }
6353 - }
6354 - },
6355 - "500": {
6356 - "description": "Internal server error.",
6357 - "content": {
6358 - "application/json": {
6359 - "schema": {
6360 - "$ref": "#/components/schemas/Error"
6361 - }
6362 - }
6363 - }
6364 - }
6365 - },
6366 - "x-api-version": "3.1"
6367 - }
6368 - },
6252 "/api/v3.1/connected_accounts/{nanoid}/revoke": {
6253 "post": {
6254 "summary": "Revoke a connected account at the provider",
@@ -6566,27 +6449,362 @@
6449 "content": {
6450 "application/json": {
6451 "schema": {
6569 - "type": "object",
6570 - "properties": {
6571 - "connected_account_id": {
6572 - "type": "string",
6573 - "description": "The connection that was completed."
6574 - },
6575 - "toolkit_slug": {
6576 - "type": "string",
6577 - "description": "The toolkit the connection belongs to."
6578 - }
6579 - },
6580 - "required": [
6581 - "connected_account_id",
6582 - "toolkit_slug"
6583 - ]
6452 + "type": "object",
6453 + "properties": {
6454 + "connected_account_id": {
6455 + "type": "string",
6456 + "description": "The connection that was completed."
6457 + },
6458 + "toolkit_slug": {
6459 + "type": "string",
6460 + "description": "The toolkit the connection belongs to."
6461 + }
6462 + },
6463 + "required": [
6464 + "connected_account_id",
6465 + "toolkit_slug"
6466 + ]
6467 + }
6468 + }
6469 + }
6470 + },
6471 + "400": {
6472 + "description": "Bad request — missing/malformed field, or identity mismatch (user_id does not match the connection owner).",
6473 + "content": {
6474 + "application/json": {
6475 + "schema": {
6476 + "$ref": "#/components/schemas/Error"
6477 + }
6478 + }
6479 + }
6480 + },
6481 + "401": {
6482 + "description": "Unauthorized - Authentication failed",
6483 + "content": {
6484 + "application/json": {
6485 + "schema": {
6486 + "$ref": "#/components/schemas/Error"
6487 + }
6488 + }
6489 + }
6490 + },
6491 + "404": {
6492 + "description": "Session not found, expired, already consumed, or not owned by the caller (masks cross-tenant); or the held authorization expired.",
6493 + "content": {
6494 + "application/json": {
6495 + "schema": {
6496 + "$ref": "#/components/schemas/Error"
6497 + }
6498 + }
6499 + }
6500 + },
6501 + "500": {
6502 + "description": "Internal server error - Failed to complete the connection.",
6503 + "content": {
6504 + "application/json": {
6505 + "schema": {
6506 + "$ref": "#/components/schemas/Error"
6507 + }
6508 + }
6509 + }
6510 + }
6511 + },
6512 + "x-api-version": "3.1"
6513 + }
6514 + },
6515 + "/api/v3.1/custom/toolkits": {
6516 + "post": {
6517 + "summary": "Create a custom toolkit",
6518 + "description": "Experimental: this endpoint may change. Creates a custom MCP toolkit and returns its slug. Set user_id to \"all\" to share the toolkit with every user in the project, or to a user ID to make it private to that user (\"default\" and other spellings of \"all\" are rejected). Access cannot be changed later. For a private toolkit, the response can include a connect_link to send that user to.",
6519 + "tags": [
6520 + "Toolkits"
6521 + ],
6522 + "operationId": "postCustomToolkits",
6523 + "security": [
6524 + {
6525 + "ApiKeyAuth": []
6526 + },
6527 + {
6528 + "UserApiKeyAuth": []
6529 + }
6530 + ],
6531 + "requestBody": {
6532 + "required": true,
6533 + "description": "Toolkit to create",
6534 + "content": {
6535 + "application/json": {
6536 + "schema": {
6537 + "type": "object",
6538 + "properties": {
6539 + "name": {
6540 + "type": "string",
6541 + "minLength": 1,
6542 + "maxLength": 200,
6543 + "description": "Display name of the toolkit"
6544 + },
6545 + "app_url": {
6546 + "type": "string",
6547 + "format": "uri",
6548 + "description": "MCP server URL. Must use https."
6549 + },
6550 + "logo_file": {
6551 + "type": "object",
6552 + "properties": {
6553 + "content": {
6554 + "type": "string",
6555 + "minLength": 1,
6556 + "maxLength": 4000000,
6557 + "pattern": "^[A-Za-z0-9+/]+={0,2}$",
6558 + "description": "Base64-encoded image, max 3MB decoded"
6559 + },
6560 + "mime_type": {
6561 + "type": "string",
6562 + "enum": [
6563 + "image/png",
6564 + "image/jpeg"
6565 + ],
6566 + "description": "Image MIME type"
6567 + }
6568 + },
6569 + "required": [
6570 + "content",
6571 + "mime_type"
6572 + ],
6573 + "additionalProperties": false,
6574 + "description": "Square PNG or JPEG logo, 256-1024px, max 3MB. Defaults to the Model Context Protocol logo."
6575 + },
6576 + "auth_schemes": {
6577 + "type": "array",
6578 + "items": {
6579 + "oneOf": [
6580 + {
6581 + "type": "object",
6582 + "properties": {
6583 + "mode": {
6584 + "type": "string",
6585 + "enum": [
6586 + "NO_AUTH"
6587 + ]
6588 + }
6589 + },
6590 + "required": [
6591 + "mode"
6592 + ],
6593 + "additionalProperties": false
6594 + },
6595 + {
6596 + "type": "object",
6597 + "properties": {
6598 + "mode": {
6599 + "type": "string",
6600 + "enum": [
6601 + "API_KEY"
6602 + ]
6603 + },
6604 + "headers": {
6605 + "type": "object",
6606 + "additionalProperties": {
6607 + "type": "string"
6608 + },
6609 + "description": "Headers sent to the MCP server. Use {{generic_api_key}} where the API key goes."
6610 + },
6611 + "api_key_field": {
6612 + "type": "object",
6613 + "properties": {
6614 + "display_name": {
6615 + "type": "string",
6616 + "minLength": 1,
6617 + "maxLength": 100,
6618 + "description": "Label for the API key input"
6619 + },
6620 + "description": {
6621 + "type": "string",
6622 + "minLength": 1,
6623 + "maxLength": 500,
6624 + "description": "Help text below the API key input"
6625 + }
6626 + },
6627 + "additionalProperties": false,
6628 + "description": "Label and help text for the API key input on the connect page"
6629 + },
6630 + "additional_fields": {
6631 + "type": "object",
6632 + "properties": {
6633 + "generic_id": {
6634 + "type": "object",
6635 + "properties": {
6636 + "display_name": {
6637 + "type": "string",
6638 + "minLength": 1,
6639 + "maxLength": 100,
6640 + "description": "Label shown to the user connecting their account"
6641 + },
6642 + "description": {
6643 + "type": "string",
6644 + "minLength": 1,
6645 + "maxLength": 500,
6646 + "description": "Help text below the input"
6647 + }
6648 + },
6649 + "required": [
6650 + "display_name"
6651 + ],
6652 + "additionalProperties": false
6653 + }
6654 + },
6655 + "required": [
6656 + "generic_id"
6657 + ],
6658 + "additionalProperties": false,
6659 + "description": "Additional values each user enters when connecting. Reference each field in a header, for example X-Org-Id: {{generic_id}}. Use display_name for the user-facing label. Every user must supply each declared field. Values are not secret."
6660 + }
6661 + },
6662 + "required": [
6663 + "mode",
6664 + "headers"
6665 + ],
6666 + "additionalProperties": false
6667 + },
6668 + {
6669 + "type": "object",
6670 + "properties": {
6671 + "mode": {
6672 + "type": "string",
6673 + "enum": [
6674 + "DCR_OAUTH"
6675 + ]
6676 + },
6677 + "discovery_url": {
6678 + "type": "string",
6679 + "format": "uri",
6680 + "description": "OAuth authorization server metadata URL, for example https://<auth server host>/.well-known/oauth-authorization-server. Use the URL your authorization server publishes; it can be on a different host from the MCP server or include a path.",
6681 + "example": "https://mcp.example.com/.well-known/oauth-authorization-server"
6682 + }
6683 + },
6684 + "required": [
6685 + "mode",
6686 + "discovery_url"
6687 + ],
6688 + "additionalProperties": false
6689 + }
6690 + ]
6691 + },
6692 + "minItems": 1,
6693 + "description": "How users authenticate to the MCP server"
6694 + },
6695 + "user_id": {
6696 + "anyOf": [
6697 + {
6698 + "type": "string",
6699 + "enum": [
6700 + "all"
6701 + ]
6702 + },
6703 + {
6704 + "type": "string",
6705 + "minLength": 1,
6706 + "maxLength": 256
6707 + }
6708 + ],
6709 + "description": "\"all\" to share the toolkit with every user in the project, or a user ID to make it private to that user. \"default\" and other spellings of \"all\" (such as \"ALL\" or \" all\") are rejected. Cannot be changed after create.",
6710 + "example": "all"
6711 + },
6712 + "callback_url": {
6713 + "type": "string",
6714 + "format": "uri",
6715 + "description": "URL to send the user to after they connect. Used only for connect_link."
6716 + }
6717 + },
6718 + "required": [
6719 + "name",
6720 + "app_url",
6721 + "auth_schemes",
6722 + "user_id"
6723 + ],
6724 + "additionalProperties": false
6725 + }
6726 + }
6727 + }
6728 + },
6729 + "responses": {
6730 + "200": {
6731 + "description": "Successfully created toolkit",
6732 + "content": {
6733 + "application/json": {
6734 + "schema": {
6735 + "type": "object",
6736 + "properties": {
6737 + "slug": {
6738 + "type": "string",
6739 + "description": "Slug of the created toolkit",
6740 + "example": "CUSTOM_NOTION_K7F2Q"
6741 + },
6742 + "connect_link": {
6743 + "type": "object",
6744 + "nullable": true,
6745 + "properties": {
6746 + "redirect_url": {
6747 + "type": "string",
6748 + "description": "Hosted connect page. Send the user here."
6749 + },
6750 + "expires_at": {
6751 + "type": "string",
6752 + "description": "When the link expires (ISO 8601)"
6753 + },
6754 + "connected_account_id": {
6755 + "type": "string",
6756 + "format": "connectedAccountId",
6757 + "description": "Connected account for the user. It becomes ACTIVE once they connect."
6758 + }
6759 + },
6760 + "required": [
6761 + "redirect_url",
6762 + "expires_at",
6763 + "connected_account_id"
6764 + ],
6765 + "description": "Link for a private toolkit's user to connect. Null for shared or no-auth toolkits, or if the link could not be created. To retry, call POST /api/v3.1/connected_accounts/link with an auth config for the toolkit, creating one with POST /api/v3.1/auth_configs if needed."
6766 + }
6767 + },
6768 + "required": [
6769 + "slug",
6770 + "connect_link"
6771 + ]
6772 + }
6773 + }
6774 + }
6775 + },
6776 + "400": {
6777 + "description": "Bad request - Invalid parameters",
6778 + "content": {
6779 + "application/json": {
6780 + "schema": {
6781 + "$ref": "#/components/schemas/Error"
6782 + }
6783 + }
6784 + }
6785 + },
6786 + "401": {
6787 + "description": "Unauthorized - Invalid or missing credentials",
6788 + "content": {
6789 + "application/json": {
6790 + "schema": {
6791 + "$ref": "#/components/schemas/Error"
6792 + }
6793 + }
6794 + }
6795 + },
6796 + "403": {
6797 + "description": "Forbidden - Your role cannot create custom toolkits",
6798 + "content": {
6799 + "application/json": {
6800 + "schema": {
6801 + "$ref": "#/components/schemas/Error"
6802 }
6803 }
6804 }
6805 },
6588 - "400": {
6589 - "description": "Bad request — missing/malformed field, or identity mismatch (user_id does not match the connection owner).",
6806 + "408": {
6807 + "description": "Request timeout",
6808 "content": {
6809 "application/json": {
6810 "schema": {
@@ -6595,8 +6813,8 @@
6813 }
6814 }
6815 },
6598 - "401": {
6599 - "description": "Unauthorized - Authentication failed",
6816 + "409": {
6817 + "description": "Conflict - This user already has a private toolkit for this MCP URL",
6818 "content": {
6819 "application/json": {
6820 "schema": {
@@ -6605,8 +6823,8 @@
6823 }
6824 }
6825 },
6608 - "404": {
6609 - "description": "Session not found, expired, already consumed, or not owned by the caller (masks cross-tenant); or the held authorization expired.",
6826 + "429": {
6827 + "description": "Too many requests - Retry after a short backoff",
6828 "content": {
6829 "application/json": {
6830 "schema": {
@@ -6616,7 +6834,7 @@
6834 }
6835 },
6836 "500": {
6619 - "description": "Internal server error - Failed to complete the connection.",
6837 + "description": "Internal server error - Failed to create toolkit",
6838 "content": {
6839 "application/json": {
6840 "schema": {
@@ -6792,6 +7010,214 @@
7010 }
7011 },
7012 "x-api-version": "3.1"
7013 + },
7014 + "patch": {
7015 + "summary": "Update a custom toolkit",
7016 + "description": "Experimental: this endpoint may change. Updates a custom toolkit's name, logo, or API key field text. Omitted fields keep their current value. To change app_url, auth_schemes, or user_id, delete and re-create the toolkit. On a project with 2FA enabled, updating a private toolkit requires the user_id it is private to.",
7017 + "tags": [
7018 + "Toolkits"
7019 + ],
7020 + "operationId": "patchCustomToolkitsBySlug",
7021 + "security": [
7022 + {
7023 + "ApiKeyAuth": []
7024 + },
7025 + {
7026 + "UserApiKeyAuth": []
7027 + }
7028 + ],
7029 + "parameters": [
7030 + {
7031 + "schema": {
7032 + "type": "string",
7033 + "minLength": 1,
7034 + "maxLength": 37,
7035 + "pattern": "^[a-zA-Z0-9_]+$",
7036 + "description": "Slug returned when the toolkit was created",
7037 + "example": "CUSTOM_NOTION_K7F2Q"
7038 + },
7039 + "required": true,
7040 + "description": "Custom toolkit slug",
7041 + "name": "slug",
7042 + "in": "path"
7043 + }
7044 + ],
7045 + "requestBody": {
7046 + "required": true,
7047 + "description": "Fields to update. Include at least one of name, logo_file, or api_key_field.",
7048 + "content": {
7049 + "application/json": {
7050 + "schema": {
7051 + "type": "object",
7052 + "properties": {
7053 + "name": {
7054 + "type": "string",
7055 + "minLength": 1,
7056 + "maxLength": 200,
7057 + "description": "Display name of the toolkit"
7058 + },
7059 + "logo_file": {
7060 + "type": "object",
7061 + "properties": {
7062 + "content": {
7063 + "type": "string",
7064 + "minLength": 1,
7065 + "maxLength": 4000000,
7066 + "pattern": "^[A-Za-z0-9+/]+={0,2}$",
7067 + "description": "Base64-encoded image, max 3MB decoded"
7068 + },
7069 + "mime_type": {
7070 + "type": "string",
7071 + "enum": [
7072 + "image/png",
7073 + "image/jpeg"
7074 + ],
7075 + "description": "Image MIME type"
7076 + }
7077 + },
7078 + "required": [
7079 + "content",
7080 + "mime_type"
7081 + ],
7082 + "additionalProperties": false,
7083 + "description": "Square PNG or JPEG logo, 256-1024px, max 3MB. Omit to keep the current logo."
7084 + },
7085 + "api_key_field": {
7086 + "type": "object",
7087 + "properties": {
7088 + "display_name": {
7089 + "type": "string",
7090 + "minLength": 1,
7091 + "maxLength": 100,
7092 + "description": "Label for the API key input"
7093 + },
7094 + "description": {
7095 + "type": "string",
7096 + "minLength": 1,
7097 + "maxLength": 500,
7098 + "description": "Help text below the API key input"
7099 + }
7100 + },
7101 + "additionalProperties": false,
7102 + "description": "Label and help text for the API key input on the connect page. API_KEY toolkits only."
7103 + },
7104 + "user_id": {
7105 + "type": "string",
7106 + "minLength": 1,
7107 + "maxLength": 256,
7108 + "description": "The user the toolkit is private to. Required to update a private toolkit when the project has 2FA enabled; optional for a toolkit shared with all users. Ignored when 2FA is disabled."
7109 + }
7110 + },
7111 + "additionalProperties": false
7112 + }
7113 + }
7114 + }
7115 + },
7116 + "responses": {
7117 + "200": {
7118 + "description": "Successfully updated toolkit",
7119 + "content": {
7120 + "application/json": {
7121 + "schema": {
7122 + "type": "object",
7123 + "properties": {
7124 + "success": {
7125 + "type": "boolean",
7126 + "enum": [
7127 + true
7128 + ],
7129 + "description": "The toolkit was updated"
7130 + }
7131 + },
7132 + "required": [
7133 + "success"
7134 + ]
7135 + }
7136 + }
7137 + }
7138 + },
7139 + "400": {
7140 + "description": "Bad request - Invalid parameters, or user_id missing for a private toolkit on a project with 2FA enabled",
7141 + "content": {
7142 + "application/json": {
7143 + "schema": {
7144 + "$ref": "#/components/schemas/Error"
7145 + }
7146 + }
7147 + }
7148 + },
7149 + "401": {
7150 + "description": "Unauthorized - Invalid or missing credentials",
7151 + "content": {
7152 + "application/json": {
7153 + "schema": {
7154 + "$ref": "#/components/schemas/Error"
7155 + }
7156 + }
7157 + }
7158 + },
7159 + "403": {
7160 + "description": "Forbidden - Your role cannot update custom toolkits, or user_id cannot use this toolkit",
7161 + "content": {
7162 + "application/json": {
7163 + "schema": {
7164 + "$ref": "#/components/schemas/Error"
7165 + }
7166 + }
7167 + }
7168 + },
7169 + "404": {
7170 + "description": "Not found - Toolkit not found",
7171 + "content": {
7172 + "application/json": {
7173 + "schema": {
7174 + "$ref": "#/components/schemas/Error"
7175 + }
7176 + }
7177 + }
7178 + },
7179 + "408": {
7180 + "description": "Request timeout",
7181 + "content": {
7182 + "application/json": {
7183 + "schema": {
7184 + "$ref": "#/components/schemas/Error"
7185 + }
7186 + }
7187 + }
7188 + },
7189 + "409": {
7190 + "description": "Conflict - The toolkit cannot be updated right now",
7191 + "content": {
7192 + "application/json": {
7193 + "schema": {
7194 + "$ref": "#/components/schemas/Error"
7195 + }
7196 + }
7197 + }
7198 + },
7199 + "429": {
7200 + "description": "Too many requests - Retry after a short backoff",
7201 + "content": {
7202 + "application/json": {
7203 + "schema": {
7204 + "$ref": "#/components/schemas/Error"
7205 + }
7206 + }
7207 + }
7208 + },
7209 + "500": {
7210 + "description": "Internal server error - Failed to update toolkit",
7211 + "content": {
7212 + "application/json": {
7213 + "schema": {
7214 + "$ref": "#/components/schemas/Error"
7215 + }
7216 + }
7217 + }
7218 + }
7219 + },
7220 + "x-api-version": "3.1"
7221 }
7222 },
7223 "/api/v3.1/toolkits/{toolkit_slug}/scopes/recommended": {
@@ -17225,6 +17651,7 @@
17651 }
17652 ],
17653 "requestBody": {
17654 + "required": true,
17655 "content": {
17656 "application/json": {
17657 "schema": {
@@ -19093,6 +19520,7 @@
19520 }
19521 ],
19522 "requestBody": {
19523 + "required": true,
19524 "content": {
19525 "application/json": {
19526 "schema": {
@@ -19280,6 +19708,7 @@
19708 },
19709 "alias": {
19710 "type": "string",
19711 + "maxLength": 255,
19712 "description": "A human-readable alias for this connected account. Must be unique per entity and toolkit within the project."
19713 },
19714 "callback_url": {
@@ -20456,6 +20885,7 @@
20885 }
20886 ],
20887 "requestBody": {
20888 + "required": true,
20889 "content": {
20890 "application/json": {
20891 "schema": {
@@ -20769,6 +21199,7 @@
21199 },
21200 "alias": {
21201 "type": "string",
21202 + "maxLength": 255,
21203 "description": "A human-readable alias for this connected account. Must be unique per entity and toolkit within the project."
21204 },
21205 "callback_url": {
@@ -21701,7 +22132,8 @@
22132 "type": "string"
22133 },
22134 "display_name": {
21704 - "type": "string"
22135 + "type": "string",
22136 + "maxLength": 75
22137 },
22138 "mask_secret_keys_in_connected_account": {
22139 "type": "boolean"
@@ -26011,7 +26443,7 @@
26443 "/api/v3.1/trigger_instances/{slug}/upsert": {
26444 "post": {
26445 "summary": "Create or update a trigger",
26014 - "description": "Creates a new trigger instance or updates an existing one with the same configuration. Triggers listen for events from external services (webhooks or polling) and can invoke your workflows. If a matching trigger already exists and is disabled, it will be re-enabled. Provide either a connected_account_id to pin a specific user connection, or a user_id to auto-resolve the first active connection for that user and the trigger's toolkit.",
26446 + "description": "Creates a new trigger instance or updates an existing one with the same configuration. Triggers listen for events from external services (webhooks or polling) and can invoke your workflows. If a matching trigger already exists and is disabled, it will be re-enabled. Provide either a connected_account_id to pin a specific user connection, or a user_id to auto-resolve the first active connection for that user and the trigger's toolkit. For a trigger that supports both webhooks and polling, Composio chooses the best way for the instance to receive events unless type sets one. When the instance polls because a webhook could not be set up, fallback_reason says why. An existing instance keeps its type, so an upsert asking for the other type returns 409.",
26447 "tags": [
26448 "Triggers"
26449 ],
@@ -26075,6 +26507,20 @@
26507 "additionalProperties": {},
26508 "description": "Trigger configuration"
26509 },
26510 + "type": {
26511 + "type": "string",
26512 + "enum": [
26513 + "poll",
26514 + "webhook"
26515 + ],
26516 + "description": "Whether this instance receives events by webhook or by polling, for a trigger that supports both. Omit it to let Composio choose the best one."
26517 + },
26518 + "polling_interval": {
26519 + "type": "integer",
26520 + "minimum": 1,
26521 + "maximum": 10080,
26522 + "description": "Minutes between polls, for an instance that polls for its events. It is checked whenever the instance could poll, even when Composio tries a webhook first, so an interval outside the toolkit's allowed range fails the request."
26523 + },
26524 "version": {
26525 "type": "string",
26526 "description": "DEPRECATED: This parameter will be removed in a future version. Please use toolkit_versions instead.",
@@ -26116,10 +26562,34 @@
26562 "trigger_id": {
26563 "type": "string",
26564 "description": "ID of the updated trigger"
26565 + },
26566 + "type": {
26567 + "type": "string",
26568 + "enum": [
26569 + "webhook",
26570 + "poll"
26571 + ],
26572 + "description": "How this trigger instance gets events: webhook (the provider notifies) or poll (a scheduled check).",
26573 + "example": "webhook"
26574 + },
26575 + "fallback_reason": {
26576 + "type": "string",
26577 + "nullable": true,
26578 + "description": "Set when Composio downgraded to a poll-based mechanism instead of webhooks for this trigger.",
26579 + "example": "No webhook endpoint found for toolkit \"gmail\". Create a webhook endpoint before setting up triggers."
26580 + },
26581 + "polling_interval": {
26582 + "type": "integer",
26583 + "nullable": true,
26584 + "description": "Minutes between scheduled polls for a poll instance.",
26585 + "example": 15
26586 }
26587 },
26588 "required": [
26122 - "trigger_id"
26589 + "trigger_id",
26590 + "type",
26591 + "fallback_reason",
26592 + "polling_interval"
26593 ]
26594 }
26595 }
@@ -26135,10 +26605,34 @@
26605 "trigger_id": {
26606 "type": "string",
26607 "description": "ID of the updated trigger"
26608 + },
26609 + "type": {
26610 + "type": "string",
26611 + "enum": [
26612 + "webhook",
26613 + "poll"
26614 + ],
26615 + "description": "How this trigger instance gets events: webhook (the provider notifies) or poll (a scheduled check).",
26616 + "example": "webhook"
26617 + },
26618 + "fallback_reason": {
26619 + "type": "string",
26620 + "nullable": true,
26621 + "description": "Set when Composio downgraded to a poll-based mechanism instead of webhooks for this trigger.",
26622 + "example": "No webhook endpoint found for toolkit \"gmail\". Create a webhook endpoint before setting up triggers."
26623 + },
26624 + "polling_interval": {
26625 + "type": "integer",
26626 + "nullable": true,
26627 + "description": "Minutes between scheduled polls for a poll instance.",
26628 + "example": 15
26629 }
26630 },
26631 "required": [
26141 - "trigger_id"
26632 + "trigger_id",
26633 + "type",
26634 + "fallback_reason",
26635 + "polling_interval"
26636 ]
26637 }
26638 }
@@ -26544,6 +27038,27 @@
27038 "additionalProperties": {},
27039 "description": "Configuration for the trigger"
27040 },
27041 + "type": {
27042 + "type": "string",
27043 + "enum": [
27044 + "webhook",
27045 + "poll"
27046 + ],
27047 + "description": "How this trigger instance gets events: webhook (the provider notifies) or poll (a scheduled check).",
27048 + "example": "webhook"
27049 + },
27050 + "fallback_reason": {
27051 + "type": "string",
27052 + "nullable": true,
27053 + "description": "Set when Composio downgraded to a poll-based mechanism instead of webhooks for this trigger.",
27054 + "example": "No webhook endpoint found for toolkit \"gmail\". Create a webhook endpoint before setting up triggers."
27055 + },
27056 + "polling_interval": {
27057 + "type": "integer",
27058 + "nullable": true,
27059 + "description": "Minutes between scheduled polls for a poll instance.",
27060 + "example": 15
27061 + },
27062 "egress_url": {
27063 "type": "string",
27064 "nullable": true,
@@ -26614,6 +27129,9 @@
27129 "user_id",
27130 "version",
27131 "trigger_config",
27132 + "type",
27133 + "fallback_reason",
27134 + "polling_interval",
27135 "egress_url",
27136 "state",
27137 "updated_at",
@@ -30722,6 +31240,7 @@
31240 },
31241 "alias": {
31242 "type": "string",
31243 + "maxLength": 255,
31244 "description": "A human-readable alias for this connected account. Must be unique per entity and toolkit within the project."
31245 },
31246 "callback_url": {