@devries-cameron20 / composio-1 / commits / a94f27dd3
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.

fix(docs): fetch latest versioned tools and triggers for toolkit pages

The generate-toolkits script was missing the `toolkit_versions=latest` query parameter when fetching tools and triggers. This caused MCP toolkits (e.g. Granola) to show 0 tools, and older toolkits to undercount (Gmail 23→40, Notion 28→46). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Sushmithamallesh committed Feb 11, 2026 at 23:38 UTC a94f27dd3dde22980f8d69877ca0dd8508084969
3 files changed +79660 -83476
docs/public/data/toolkits-list.json
+1486 -35117
@@ -3,40839 +3,7208 @@
3 "slug": "gmail",
4 "name": "Gmail",
5 "logo": "https://logos.composio.dev/api/gmail",
6 - "description": "Gmail is Google’s email service, featuring spam protection, search functions, and seamless integration with other G Suite apps for productivity",
6 "category": "email",
8 - "authSchemes": [
9 - "OAUTH2"
10 - ],
11 - "toolCount": 23,
12 - "triggerCount": 2,
13 - "version": "20260211_00",
14 - "authConfigDetails": [
15 - {
16 - "mode": "OAUTH2",
17 - "name": "gmail_oauth",
18 - "fields": {
19 - "auth_config_creation": {
20 - "required": [
21 - {
22 - "name": "client_id",
23 - "displayName": "Client id",
24 - "type": "string",
25 - "description": "Client id of the app",
26 - "required": true,
27 - "default": null
28 - },
29 - {
30 - "name": "client_secret",
31 - "displayName": "Client secret",
32 - "type": "string",
33 - "description": "Client secret of the app",
34 - "required": true,
35 - "default": null
36 - }
37 - ],
38 - "optional": [
39 - {
40 - "name": "oauth_redirect_uri",
41 - "displayName": "Redirect URI",
42 - "type": "string",
43 - "description": "Add this Redirect URL to your app's OAuth allow list.",
44 - "required": false,
45 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
46 - },
47 - {
48 - "name": "scopes",
49 - "displayName": "Scopes",
50 - "type": "string",
51 - "description": "Scopes to request from the user, comma separated",
52 - "required": false,
53 - "default": "https://www.googleapis.com/auth/userinfo.profile,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/contacts.readonly,https://www.googleapis.com/auth/contacts.other.readonly,https://www.googleapis.com/auth/profile.language.read,https://www.googleapis.com/auth/user.addresses.read,https://www.googleapis.com/auth/user.birthday.read,https://www.googleapis.com/auth/user.emails.read,https://www.googleapis.com/auth/user.phonenumbers.read,https://www.googleapis.com/auth/profile.emails.read,https://mail.google.com/"
54 - }
55 - ]
56 - },
57 - "connected_account_initiation": {
58 - "required": [],
59 - "optional": []
60 - }
61 - }
62 - }
63 - ]
7 + "toolCount": 40,
8 + "triggerCount": 2
9 },
10 {
11 "slug": "composio",
12 "name": "Composio",
13 "logo": "https://logos.composio.dev/api/composio",
69 - "description": "Composio enables AI Agents and LLMs to authenticate and integrate with various tools via function calling.",
14 "category": "ai agents",
71 - "authSchemes": [
72 - "NO_AUTH"
73 - ],
74 - "toolCount": 30,
75 - "triggerCount": 0,
76 - "version": "20260211_00",
77 - "authConfigDetails": [
78 - {
79 - "mode": "NO_AUTH",
80 - "name": "Composio",
81 - "fields": {
82 - "auth_config_creation": {
83 - "required": [],
84 - "optional": []
85 - },
86 - "connected_account_initiation": {
87 - "required": [],
88 - "optional": []
89 - }
90 - }
91 - }
92 - ]
15 + "toolCount": 25,
16 + "triggerCount": 0
17 },
18 {
19 "slug": "github",
20 "name": "GitHub",
21 "logo": "https://logos.composio.dev/api/github",
98 - "description": "GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features",
22 "category": "developer tools",
100 - "authSchemes": [
101 - "OAUTH2"
102 - ],
103 - "toolCount": 823,
104 - "triggerCount": 6,
105 - "version": "20260211_00",
106 - "authConfigDetails": [
107 - {
108 - "mode": "OAUTH2",
109 - "name": "github_oauth",
110 - "fields": {
111 - "auth_config_creation": {
112 - "required": [
113 - {
114 - "name": "client_id",
115 - "displayName": "Client id",
116 - "type": "string",
117 - "description": "Client id of the app",
118 - "required": true,
119 - "default": null
120 - },
121 - {
122 - "name": "client_secret",
123 - "displayName": "Client secret",
124 - "type": "string",
125 - "description": "Client secret of the app",
126 - "required": true,
127 - "default": null
128 - }
129 - ],
130 - "optional": [
131 - {
132 - "name": "oauth_redirect_uri",
133 - "displayName": "Redirect URI",
134 - "type": "string",
135 - "description": "Add this Redirect URL to your app's OAuth allow list.",
136 - "required": false,
137 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
138 - },
139 - {
140 - "name": "scopes",
141 - "displayName": "Scopes",
142 - "type": "string",
143 - "description": "Scopes to request from the user, comma separated",
144 - "required": false,
145 - "default": "repo,user,gist,notifications,project,workflow,codespace"
146 - }
147 - ]
148 - },
149 - "connected_account_initiation": {
150 - "required": [],
151 - "optional": []
152 - }
153 - }
154 - }
155 - ]
23 + "toolCount": 792,
24 + "triggerCount": 6
25 },
26 {
27 "slug": "googlecalendar",
28 "name": "Google Calendar",
29 "logo": "https://logos.composio.dev/api/googlecalendar",
161 - "description": "Google Calendar is a time management tool providing scheduling features, event reminders, and integration with email and other apps for streamlined organization",
30 "category": "scheduling & booking",
163 - "authSchemes": [
164 - "OAUTH2"
165 - ],
166 - "toolCount": 28,
167 - "triggerCount": 7,
168 - "version": "20260211_00",
169 - "authConfigDetails": [
170 - {
171 - "mode": "OAUTH2",
172 - "name": "googlecalendar_oauth",
173 - "fields": {
174 - "auth_config_creation": {
175 - "required": [
176 - {
177 - "name": "client_id",
178 - "displayName": "Client id",
179 - "type": "string",
180 - "description": "Client id of the app",
181 - "required": true,
182 - "default": null
183 - },
184 - {
185 - "name": "client_secret",
186 - "displayName": "Client secret",
187 - "type": "string",
188 - "description": "Client secret of the app",
189 - "required": true,
190 - "default": null
191 - }
192 - ],
193 - "optional": [
194 - {
195 - "name": "oauth_redirect_uri",
196 - "displayName": "Redirect URI",
197 - "type": "string",
198 - "description": "Add this Redirect URL to your app's OAuth allow list.",
199 - "required": false,
200 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
201 - },
202 - {
203 - "name": "scopes",
204 - "displayName": "Scopes",
205 - "type": "string",
206 - "description": "Scopes to request from the user, comma separated",
207 - "required": false,
208 - "default": "https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/calendar.events"
209 - }
210 - ]
211 - },
212 - "connected_account_initiation": {
213 - "required": [],
214 - "optional": []
215 - }
216 - }
217 - }
218 - ]
31 + "toolCount": 46,
32 + "triggerCount": 7
33 },
34 {
35 "slug": "notion",
36 "name": "Notion",
37 "logo": "https://logos.composio.dev/api/notion",
224 - "description": "Notion centralizes notes, docs, wikis, and tasks in a unified workspace, letting teams build custom workflows for collaboration and knowledge management",
38 "category": "notes",
226 - "authSchemes": [
227 - "OAUTH2",
228 - "API_KEY"
229 - ],
230 - "toolCount": 28,
231 - "triggerCount": 5,
232 - "version": "20260211_00",
233 - "authConfigDetails": [
234 - {
235 - "mode": "OAUTH2",
236 - "name": "notion_oauth",
237 - "fields": {
238 - "auth_config_creation": {
239 - "required": [
240 - {
241 - "name": "client_id",
242 - "displayName": "Client id",
243 - "type": "string",
244 - "description": "Client id of the app",
245 - "required": true,
246 - "default": null
247 - },
248 - {
249 - "name": "client_secret",
250 - "displayName": "Client secret",
251 - "type": "string",
252 - "description": "Client secret of the app",
253 - "required": true,
254 - "default": null
255 - }
256 - ],
257 - "optional": [
258 - {
259 - "name": "oauth_redirect_uri",
260 - "displayName": "Redirect URI",
261 - "type": "string",
262 - "description": "Add this Redirect URL to your app's OAuth allow list.",
263 - "required": false,
264 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
265 - },
266 - {
267 - "name": "scopes",
268 - "displayName": "Scopes",
269 - "type": "string",
270 - "description": "Scopes to request from the user, comma separated",
271 - "required": false,
272 - "default": ""
273 - }
274 - ]
275 - },
276 - "connected_account_initiation": {
277 - "required": [],
278 - "optional": []
279 - }
280 - }
281 - },
282 - {
283 - "mode": "API_KEY",
284 - "name": "notion_api_key",
285 - "fields": {
286 - "auth_config_creation": {
287 - "required": [],
288 - "optional": []
289 - },
290 - "connected_account_initiation": {
291 - "required": [
292 - {
293 - "name": "generic_api_key",
294 - "displayName": "API Key",
295 - "type": "string",
296 - "description": "Your notion API key for authentication. Obtain it from your notion settings.",
297 - "required": true,
298 - "default": null
299 - }
300 - ],
301 - "optional": []
302 - }
303 - }
304 - }
305 - ]
39 + "toolCount": 46,
40 + "triggerCount": 5
41 },
42 {
43 "slug": "googlesheets",
44 "name": "Google Sheets",
45 "logo": "https://logos.composio.dev/api/googlesheets",
311 - "description": "Google Sheets is a cloud-based spreadsheet tool enabling real-time collaboration, data analysis, and integration with other Google Workspace apps",
46 "category": "spreadsheets",
313 - "authSchemes": [
314 - "OAUTH2"
315 - ],
316 - "toolCount": 36,
317 - "triggerCount": 2,
318 - "version": "20260211_00",
319 - "authConfigDetails": [
320 - {
321 - "mode": "OAUTH2",
322 - "name": "google_sheets_oauth",
323 - "fields": {
324 - "auth_config_creation": {
325 - "required": [
326 - {
327 - "name": "client_id",
328 - "displayName": "Client id",
329 - "type": "string",
330 - "description": "Client id of the app",
331 - "required": true,
332 - "default": null
333 - },
334 - {
335 - "name": "client_secret",
336 - "displayName": "Client secret",
337 - "type": "string",
338 - "description": "Client secret of the app",
339 - "required": true,
340 - "default": null
341 - }
342 - ],
343 - "optional": [
344 - {
345 - "name": "oauth_redirect_uri",
346 - "displayName": "Redirect URI",
347 - "type": "string",
348 - "description": "Add this Redirect URL to your app's OAuth allow list.",
349 - "required": false,
350 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
351 - },
352 - {
353 - "name": "scopes",
354 - "displayName": "Scopes",
355 - "type": "string",
356 - "description": "Scopes to request from the user, comma separated",
357 - "required": false,
358 - "default": "https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/spreadsheets,https://www.googleapis.com/auth/userinfo.email"
359 - }
360 - ]
361 - },
362 - "connected_account_initiation": {
363 - "required": [],
364 - "optional": []
365 - }
366 - }
367 - }
368 - ]
47 + "toolCount": 44,
48 + "triggerCount": 2
49 },
50 {
51 "slug": "slack",
52 "name": "Slack",
53 "logo": "https://logos.composio.dev/api/slack",
374 - "description": "Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.",
375 - "category": "productivity",
376 - "authSchemes": [
377 - "OAUTH2"
378 - ],
379 - "toolCount": 133,
380 - "triggerCount": 9,
381 - "version": "20260209_00",
382 - "authConfigDetails": [
383 - {
384 - "mode": "OAUTH2",
385 - "name": "slack_oauth",
386 - "fields": {
387 - "auth_config_creation": {
388 - "required": [
389 - {
390 - "name": "client_id",
391 - "displayName": "Client id",
392 - "type": "string",
393 - "description": "Client id of the app",
394 - "required": true,
395 - "default": null
396 - },
397 - {
398 - "name": "client_secret",
399 - "displayName": "Client secret",
400 - "type": "string",
401 - "description": "Client secret of the app",
402 - "required": true,
403 - "default": null
404 - }
405 - ],
406 - "optional": [
407 - {
408 - "name": "oauth_redirect_uri",
409 - "displayName": "Redirect URI",
410 - "type": "string",
411 - "description": "Add this Redirect URL to your app's OAuth allow list.",
412 - "required": false,
413 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
414 - },
415 - {
416 - "name": "scopes",
417 - "displayName": "User Scopes",
418 - "type": "string",
419 - "description": "Scopes to request from the user, comma separated",
420 - "required": false,
421 - "default": "calls:read,calls:write,channels:history,channels:read,channels:write,chat:write,dnd:read,dnd:write,emoji:read,files:read,files:write,groups:history,groups:read,groups:write,im:history,im:read,im:write,links:read,links:write,mpim:history,mpim:read,mpim:write,pins:read,pins:write,reactions:read,reactions:write,reminders:read,reminders:write,remote_files:read,remote_files:share,search:read,stars:read,stars:write,team:read,usergroups:read,usergroups:write,users.profile:read,users.profile:write,users:read,users:read.email,users:write"
422 - },
423 - {
424 - "name": "verification_token",
425 - "displayName": "Verification Token",
426 - "type": "string",
427 - "description": "Verification token required to verify the request is coming from slack. You can find it in the slack app settings just below the client id and secret. It is required to enable Slack triggers.",
428 - "required": false,
429 - "default": null
430 - }
431 - ]
432 - },
433 - "connected_account_initiation": {
434 - "required": [],
435 - "optional": []
436 - }
437 - }
438 - }
439 - ]
54 + "category": "team chat",
55 + "toolCount": 155,
56 + "triggerCount": 9
57 },
58 {
59 "slug": "supabase",
60 "name": "Supabase",
61 "logo": "https://logos.composio.dev/api/supabase",
445 - "description": "Supabase is an open-source backend-as-a-service providing a Postgres database, authentication, storage, and real-time subscription APIs for building modern applications",
446 - "category": "developer tools & devops",
447 - "authSchemes": [
448 - "OAUTH2",
449 - "API_KEY"
450 - ],
451 - "toolCount": 79,
452 - "triggerCount": 0,
453 - "version": "20260209_00",
454 - "authConfigDetails": [
455 - {
456 - "mode": "OAUTH2",
457 - "name": "supabase_oauth",
458 - "fields": {
459 - "auth_config_creation": {
460 - "required": [
461 - {
462 - "name": "client_id",
463 - "displayName": "Client id",
464 - "type": "string",
465 - "description": "Client id of the app",
466 - "required": true,
467 - "default": null
468 - },
469 - {
470 - "name": "client_secret",
471 - "displayName": "Client secret",
472 - "type": "string",
473 - "description": "Client secret of the app",
474 - "required": true,
475 - "default": null
476 - }
477 - ],
478 - "optional": [
479 - {
480 - "name": "oauth_redirect_uri",
481 - "displayName": "Redirect URI",
482 - "type": "string",
483 - "description": "Add this Redirect URL to your app's OAuth allow list.",
484 - "required": false,
485 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
486 - },
487 - {
488 - "name": "scopes",
489 - "displayName": "Scopes",
490 - "type": "string",
491 - "description": "Scopes to request from the user, comma separated",
492 - "required": false,
493 - "default": "all"
494 - }
495 - ]
496 - },
497 - "connected_account_initiation": {
498 - "required": [
499 - {
500 - "name": "full",
501 - "displayName": "Base URL",
502 - "type": "string",
503 - "description": "The base URL for the Supabase API.",
504 - "required": true,
505 - "default": "https://api.supabase.com"
506 - }
507 - ],
508 - "optional": []
509 - }
510 - }
511 - },
512 - {
513 - "mode": "API_KEY",
514 - "name": "supabase_api_key",
515 - "fields": {
516 - "auth_config_creation": {
517 - "required": [],
518 - "optional": []
519 - },
520 - "connected_account_initiation": {
521 - "required": [
522 - {
523 - "name": "full",
524 - "displayName": "Base URL",
525 - "type": "string",
526 - "description": "The base URL for the Supabase API.",
527 - "required": true,
528 - "default": "https://api.supabase.com"
529 - },
530 - {
531 - "name": "bearer_token",
532 - "displayName": "Supabase Personal Token",
533 - "type": "string",
534 - "description": "Enter the personal token from your Supabase account which you can find from https://supabase.com/dashboard/account/tokens",
535 - "required": true,
536 - "default": null
537 - }
538 - ],
539 - "optional": []
540 - }
541 - }
542 - }
543 - ]
62 + "category": "developer tools",
63 + "toolCount": 84,
64 + "triggerCount": 0
65 },
66 {
67 "slug": "outlook",
68 "name": "Outlook",
69 "logo": "https://logos.composio.dev/api/outlook",
549 - "description": "Outlook is Microsoft's email and calendaring platform integrating contacts and scheduling, enabling users to manage communications and events in a unified workspace",
70 "category": "email",
551 - "authSchemes": [
552 - "OAUTH2"
553 - ],
554 - "toolCount": 43,
555 - "triggerCount": 5,
556 - "version": "20260211_00",
557 - "authConfigDetails": [
558 - {
559 - "mode": "OAUTH2",
560 - "name": "outlook_oauth",
561 - "fields": {
562 - "auth_config_creation": {
563 - "required": [
564 - {
565 - "name": "client_id",
566 - "displayName": "Client id",
567 - "type": "string",
568 - "description": "Client id of the app",
569 - "required": true,
570 - "default": null
571 - },
572 - {
573 - "name": "client_secret",
574 - "displayName": "Client secret",
575 - "type": "string",
576 - "description": "Client secret of the app",
577 - "required": true,
578 - "default": null
579 - }
580 - ],
581 - "optional": [
582 - {
583 - "name": "oauth_redirect_uri",
584 - "displayName": "Redirect URI",
585 - "type": "string",
586 - "description": "Add this Redirect URL to your app's OAuth allow list.",
587 - "required": false,
588 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
589 - },
590 - {
591 - "name": "scopes",
592 - "displayName": "Scopes",
593 - "type": "string",
594 - "description": "Scopes to request from the user, comma separated",
595 - "required": false,
596 - "default": "Calendars.Read,Calendars.ReadWrite,Calendars.ReadWrite.Shared,Contacts.ReadWrite,Chat.ReadWrite,Mail.Read,Mail.ReadWrite,Mail.Send,MailboxSettings.Read,MailboxSettings.ReadWrite,offline_access,User.Read"
597 - }
598 - ]
599 - },
600 - "connected_account_initiation": {
601 - "required": [],
602 - "optional": []
603 - }
604 - }
605 - }
606 - ]
71 + "toolCount": 64,
72 + "triggerCount": 5
73 },
74 {
75 "slug": "perplexityai",
76 "name": "Perplexity AI",
77 "logo": "https://logos.composio.dev/api/perplexityai",
612 - "description": "Perplexity AI provides conversational AI models for generating human-like text responses",
78 "category": "artificial intelligence",
614 - "authSchemes": [
615 - "API_KEY"
616 - ],
79 "toolCount": 1,
618 - "triggerCount": 0,
619 - "version": "20260211_00",
620 - "authConfigDetails": [
621 - {
622 - "mode": "API_KEY",
623 - "name": "pplx_scheme",
624 - "fields": {
625 - "auth_config_creation": {
626 - "required": [],
627 - "optional": []
628 - },
629 - "connected_account_initiation": {
630 - "required": [
631 - {
632 - "name": "generic_api_key",
633 - "displayName": "API Key",
634 - "type": "string",
635 - "description": "API key for Perplexity AI",
636 - "required": true,
637 - "default": null
638 - }
639 - ],
640 - "optional": []
641 - }
642 - }
643 - }
644 - ]
80 + "triggerCount": 0
81 },
82 {
83 "slug": "twitter",
84 "name": "Twitter",
85 "logo": "https://logos.composio.dev/api/twitter",
650 - "description": "Twitter, Inc. was an American social media company based in San Francisco, California, which operated and was named for named for its flagship social media network prior to its rebrand as X.",
651 - "category": "social",
652 - "authSchemes": [
653 - "OAUTH2"
654 - ],
655 - "toolCount": 72,
656 - "triggerCount": 0,
657 - "version": "20260209_00",
658 - "authConfigDetails": [
659 - {
660 - "mode": "OAUTH2",
661 - "name": "twitter_oauth",
662 - "fields": {
663 - "auth_config_creation": {
664 - "required": [
665 - {
666 - "name": "client_id",
667 - "displayName": "Client id",
668 - "type": "string",
669 - "description": "Client id of the app",
670 - "required": true,
671 - "default": null
672 - },
673 - {
674 - "name": "client_secret",
675 - "displayName": "Client secret",
676 - "type": "string",
677 - "description": "Client secret of the app",
678 - "required": true,
679 - "default": null
680 - },
681 - {
682 - "name": "generic_id",
683 - "displayName": "Application Bearer Token",
684 - "type": "string",
685 - "description": "Your Twitter application bearer token for authentication. Needed for TWITTER_FULL_ARCHIVE_SEARCH, TWITTER_CREATE_COMPLIANCE_JOB_REQUEST, TWITTER_RETRIEVE_COMPLIANCE_JOBS, TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_ID actions.",
686 - "required": true,
687 - "default": null
688 - }
689 - ],
690 - "optional": [
691 - {
692 - "name": "oauth_redirect_uri",
693 - "displayName": "Redirect URI",
694 - "type": "string",
695 - "description": "Add this Redirect URL to your app's OAuth allow list.",
696 - "required": false,
697 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
698 - },
699 - {
700 - "name": "scopes",
701 - "displayName": "Scopes",
702 - "type": "string",
703 - "description": "Scopes to request from the user, comma separated",
704 - "required": false,
705 - "default": "dm.write,dm.read,mute.read,mute.write,space.read,tweet.write,tweet.read,tweet.moderate.write,users.read,follows.read,follows.write,like.read,like.write,list.read,list.write,block.read,block.write,bookmark.read,bookmark.write,media.write,offline.access"
706 - }
707 - ]
708 - },
709 - "connected_account_initiation": {
710 - "required": [],
711 - "optional": []
712 - }
713 - }
714 - }
715 - ]
86 + "category": "social media accounts",
87 + "toolCount": 75,
88 + "triggerCount": 0
89 },
90 {
91 "slug": "googledrive",
92 "name": "Google Drive",
93 "logo": "https://logos.composio.dev/api/googledrive",
721 - "description": "Google Drive is a cloud storage solution for uploading, sharing, and collaborating on files across devices, with robust search and offline access",
94 "category": "file management & storage",
723 - "authSchemes": [
724 - "OAUTH2"
725 - ],
726 - "toolCount": 51,
727 - "triggerCount": 7,
728 - "version": "20260211_00",
729 - "authConfigDetails": [
730 - {
731 - "mode": "OAUTH2",
732 - "name": "google_drive_oauth",
733 - "fields": {
734 - "auth_config_creation": {
735 - "required": [
736 - {
737 - "name": "client_id",
738 - "displayName": "Client id",
739 - "type": "string",
740 - "description": "Client id of the app",
741 - "required": true,
742 - "default": null
743 - },
744 - {
745 - "name": "client_secret",
746 - "displayName": "Client secret",
747 - "type": "string",
748 - "description": "Client secret of the app",
749 - "required": true,
750 - "default": null
751 - }
752 - ],
753 - "optional": [
754 - {
755 - "name": "oauth_redirect_uri",
756 - "displayName": "Redirect URI",
757 - "type": "string",
758 - "description": "Add this Redirect URL to your app's OAuth allow list.",
759 - "required": false,
760 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
761 - },
762 - {
763 - "name": "scopes",
764 - "displayName": "Scopes",
765 - "type": "string",
766 - "description": "Scopes to request from the user, comma separated",
767 - "required": false,
768 - "default": "https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/userinfo.email"
769 - }
770 - ]
771 - },
772 - "connected_account_initiation": {
773 - "required": [],
774 - "optional": []
775 - }
776 - }
777 - }
778 - ]
95 + "toolCount": 59,
96 + "triggerCount": 7
97 },
98 {
99 "slug": "googledocs",
100 "name": "Google Docs",
101 "logo": "https://logos.composio.dev/api/googledocs",
784 - "description": "Google Docs is a cloud-based word processor with real-time collaboration, version history, and integration with other Google Workspace apps",
102 "category": "documents",
786 - "authSchemes": [
787 - "OAUTH2"
788 - ],
789 - "toolCount": 32,
790 - "triggerCount": 4,
791 - "version": "20260211_00",
792 - "authConfigDetails": [
793 - {
794 - "mode": "OAUTH2",
795 - "name": "google_docs_oauth",
796 - "fields": {
797 - "auth_config_creation": {
798 - "required": [
799 - {
800 - "name": "client_id",
801 - "displayName": "Client id",
802 - "type": "string",
803 - "description": "Client id of the app",
804 - "required": true,
805 - "default": null
806 - },
807 - {
808 - "name": "client_secret",
809 - "displayName": "Client secret",
810 - "type": "string",
811 - "description": "Client secret of the app",
812 - "required": true,
813 - "default": null
814 - }
815 - ],
816 - "optional": [
817 - {
818 - "name": "oauth_redirect_uri",
819 - "displayName": "Redirect URI",
820 - "type": "string",
821 - "description": "Add this Redirect URL to your app's OAuth allow list.",
822 - "required": false,
823 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
824 - },
825 - {
826 - "name": "scopes",
827 - "displayName": "Scopes",
828 - "type": "string",
829 - "description": "Scopes to request from the user, comma separated",
830 - "required": false,
831 - "default": "https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/documents,https://www.googleapis.com/auth/userinfo.email"
832 - }
833 - ]
834 - },
835 - "connected_account_initiation": {
836 - "required": [],
837 - "optional": []
838 - }
839 - }
840 - }
841 - ]
103 + "toolCount": 35,
104 + "triggerCount": 4
105 },
106 {
107 "slug": "hubspot",
108 "name": "HubSpot",
109 "logo": "https://logos.composio.dev/api/hubspot",
847 - "description": "HubSpot is an inbound marketing, sales, and customer service platform integrating CRM, email automation, and analytics to facilitate lead nurturing and seamless customer experiences",
110 "category": "crm",
849 - "authSchemes": [
850 - "OAUTH2",
851 - "API_KEY"
852 - ],
853 - "toolCount": 304,
854 - "triggerCount": 2,
855 - "version": "20260211_00",
856 - "authConfigDetails": [
857 - {
858 - "mode": "OAUTH2",
859 - "name": "hubspot_oauth",
860 - "fields": {
861 - "auth_config_creation": {
862 - "required": [
863 - {
864 - "name": "client_id",
865 - "displayName": "Client id",
866 - "type": "string",
867 - "description": "Client id of the app",
868 - "required": true,
869 - "default": null
870 - },
871 - {
872 - "name": "client_secret",
873 - "displayName": "Client secret",
874 - "type": "string",
875 - "description": "Client secret of the app",
876 - "required": true,
877 - "default": null
878 - }
879 - ],
880 - "optional": [
881 - {
882 - "name": "oauth_redirect_uri",
883 - "displayName": "Redirect URI",
884 - "type": "string",
885 - "description": "Add this Redirect URL to your app's OAuth allow list.",
886 - "required": false,
887 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
888 - },
889 - {
890 - "name": "scopes",
891 - "displayName": "Scopes",
892 - "type": "string",
893 - "description": "Scopes to request from the user, comma separated",
894 - "required": false,
895 - "default": "account-info.security.read,accounting,cms.domains.read,cms.domains.write,crm.export,crm.import,crm.lists.read,crm.lists.write,crm.objects.companies.read,crm.objects.companies.write,crm.objects.contacts.read,crm.objects.contacts.write,crm.objects.deals.read,crm.objects.deals.write,crm.objects.marketing_events.read,crm.objects.marketing_events.write,crm.objects.owners.read,crm.objects.quotes.read,crm.objects.quotes.write,crm.schemas.companies.read,crm.schemas.companies.write,crm.schemas.contacts.read,crm.schemas.contacts.write,oauth,settings.users.read,settings.users.write,tickets,timeline,e-commerce,crm.objects.custom.read,crm.schemas.custom.read,content,sales-email-read"
896 - },
897 - {
898 - "name": "optional_scopes",
899 - "displayName": "Optional Scopes",
900 - "type": "string",
901 - "description": "The optional scopes for the Hubspot API requests. Make sure the scopes are space separated.For more information, visit https://developers.hubspot.com/",
902 - "required": false,
903 - "default": "transactional-email automation marketing.campaigns.read marketing.campaigns.write"
904 - }
905 - ]
906 - },
907 - "connected_account_initiation": {
908 - "required": [],
909 - "optional": []
910 - }
911 - }
912 - },
913 - {
914 - "mode": "API_KEY",
915 - "name": "hubspot_api_key",
916 - "fields": {
917 - "auth_config_creation": {
918 - "required": [],
919 - "optional": []
920 - },
921 - "connected_account_initiation": {
922 - "required": [
923 - {
924 - "name": "generic_api_key",
925 - "displayName": "API Key",
926 - "type": "string",
927 - "description": "The API key for Hubspot API requests. For more information, visit https://developers.hubspot.com/",
928 - "required": true,
929 - "default": null
930 - }
931 - ],
932 - "optional": []
933 - }
934 - }
935 - }
936 - ]
111 + "toolCount": 233,
112 + "triggerCount": 2
113 },
114 {
115 "slug": "linear",
116 "name": "Linear",
117 "logo": "https://logos.composio.dev/api/linear",
942 - "description": "Linear is a streamlined issue tracking and project planning tool for modern teams, featuring fast workflows, keyboard shortcuts, and GitHub integrations",
118 "category": "project management",
944 - "authSchemes": [
945 - "OAUTH2",
946 - "API_KEY"
947 - ],
948 - "toolCount": 21,
949 - "triggerCount": 3,
950 - "version": "20260211_00",
951 - "authConfigDetails": [
952 - {
953 - "mode": "OAUTH2",
954 - "name": "linear_oauth",
955 - "fields": {
956 - "auth_config_creation": {
957 - "required": [
958 - {
959 - "name": "client_id",
960 - "displayName": "Client id",
961 - "type": "string",
962 - "description": "Client id of the app",
963 - "required": true,
964 - "default": null
965 - },
966 - {
967 - "name": "client_secret",
968 - "displayName": "Client secret",
969 - "type": "string",
970 - "description": "Client secret of the app",
971 - "required": true,
972 - "default": null
973 - }
974 - ],
975 - "optional": [
976 - {
977 - "name": "oauth_redirect_uri",
978 - "displayName": "Redirect URI",
979 - "type": "string",
980 - "description": "Add this Redirect URL to your app's OAuth allow list.",
981 - "required": false,
982 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
983 - },
984 - {
985 - "name": "scopes",
986 - "displayName": "Scopes",
987 - "type": "string",
988 - "description": "Scopes to request from the user, comma separated",
989 - "required": false,
990 - "default": "admin,read,write,issues:create,comments:create"
991 - }
992 - ]
993 - },
994 - "connected_account_initiation": {
995 - "required": [],
996 - "optional": []
997 - }
998 - }
999 - },
1000 - {
1001 - "mode": "API_KEY",
1002 - "name": "linear_api_key",
1003 - "fields": {
1004 - "auth_config_creation": {
1005 - "required": [],
1006 - "optional": []
1007 - },
1008 - "connected_account_initiation": {
1009 - "required": [
1010 - {
1011 - "name": "generic_api_key",
1012 - "displayName": "API Key",
1013 - "type": "string",
1014 - "description": "Your Linear API key for authentication. Obtain it from your Linear settings.",
1015 - "required": true,
1016 - "default": null
1017 - }
1018 - ],
1019 - "optional": []
1020 - }
1021 - }
1022 - }
1023 - ]
119 + "toolCount": 32,
120 + "triggerCount": 3
121 },
122 {
123 "slug": "airtable",
124 "name": "Airtable",
125 "logo": "https://logos.composio.dev/api/airtable",
1029 - "description": "Airtable merges spreadsheet functionality with database power, enabling teams to organize projects, track tasks, and collaborate through customizable views, automation, and integrations for data management",
126 "category": "productivity",
1031 - "authSchemes": [
1032 - "OAUTH2",
1033 - "API_KEY"
1034 - ],
1035 - "toolCount": 17,
1036 - "triggerCount": 0,
1037 - "version": "20260211_00",
1038 - "authConfigDetails": [
1039 - {
1040 - "mode": "OAUTH2",
1041 - "name": "airtable_oauth2",
1042 - "fields": {
1043 - "auth_config_creation": {
1044 - "required": [
1045 - {
1046 - "name": "client_id",
1047 - "displayName": "Client id",
1048 - "type": "string",
1049 - "description": "Client id of the app",
1050 - "required": true,
1051 - "default": null
1052 - },
1053 - {
1054 - "name": "client_secret",
1055 - "displayName": "Client secret",
1056 - "type": "string",
1057 - "description": "Client secret of the app",
1058 - "required": true,
1059 - "default": null
1060 - }
1061 - ],
1062 - "optional": [
1063 - {
1064 - "name": "oauth_redirect_uri",
1065 - "displayName": "Redirect URI",
1066 - "type": "string",
1067 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1068 - "required": false,
1069 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1070 - },
1071 - {
1072 - "name": "scopes",
1073 - "displayName": "Scopes",
1074 - "type": "string",
1075 - "description": "Scopes to request from the user, comma separated",
1076 - "required": false,
1077 - "default": "data.records:read,data.records:write,data.recordComments:read,data.recordComments:write,schema.bases:read,schema.bases:write,user.email:read"
1078 - }
1079 - ]
1080 - },
1081 - "connected_account_initiation": {
1082 - "required": [],
1083 - "optional": []
1084 - }
1085 - }
1086 - },
1087 - {
1088 - "mode": "API_KEY",
1089 - "name": "API_KEY",
1090 - "fields": {
1091 - "auth_config_creation": {
1092 - "required": [],
1093 - "optional": []
1094 - },
1095 - "connected_account_initiation": {
1096 - "required": [
1097 - {
1098 - "name": "generic_api_key",
1099 - "displayName": "Personal Access Token",
1100 - "type": "string",
1101 - "description": "Your Personal access token for authentication. Obtain it from your Airtable settings here https://airtable.com/create/tokens",
1102 - "required": true,
1103 - "default": null
1104 - }
1105 - ],
1106 - "optional": []
1107 - }
1108 - }
1109 - }
1110 - ]
127 + "toolCount": 25,
128 + "triggerCount": 0
129 },
130 {
131 "slug": "codeinterpreter",
132 "name": "Code Interpreter",
133 "logo": "https://logos.composio.dev/api/codeinterpreter",
1116 - "description": "CodeInterpreter extends Python-based coding environments with integrated data analysis, enabling developers to run scripts, visualize results, and prototype solutions inside supported platforms",
134 "category": "developer tools",
1118 - "authSchemes": [
1119 - "NO_AUTH"
1120 - ],
135 "toolCount": 5,
1122 - "triggerCount": 0,
1123 - "version": "20260211_00",
1124 - "authConfigDetails": [
1125 - {
1126 - "mode": "NO_AUTH",
1127 - "name": "CodeInterpreter",
1128 - "fields": {
1129 - "auth_config_creation": {
1130 - "required": [],
1131 - "optional": []
1132 - },
1133 - "connected_account_initiation": {
1134 - "required": [],
1135 - "optional": []
1136 - }
1137 - }
1138 - }
1139 - ]
136 + "triggerCount": 0
137 },
138 {
139 "slug": "serpapi",
140 "name": "SerpApi",
141 "logo": "https://logos.composio.dev/api/serpapi",
1145 - "description": "SerpApi provides a real-time API for structured search engine results, allowing developers to scrape, parse, and analyze SERP data for SEO and research",
1146 - "category": "analytics & data",
1147 - "authSchemes": [
1148 - "API_KEY"
1149 - ],
1150 - "toolCount": 23,
1151 - "triggerCount": 0,
1152 - "version": "20260203_00",
1153 - "authConfigDetails": [
1154 - {
1155 - "mode": "API_KEY",
1156 - "name": "serpapi_auth",
1157 - "fields": {
1158 - "auth_config_creation": {
1159 - "required": [],
1160 - "optional": []
1161 - },
1162 - "connected_account_initiation": {
1163 - "required": [
1164 - {
1165 - "name": "generic_api_key",
1166 - "displayName": "API Key",
1167 - "type": "string",
1168 - "description": "Your SERP API key.",
1169 - "required": true,
1170 - "default": null
1171 - }
1172 - ],
1173 - "optional": []
1174 - }
1175 - }
1176 - }
1177 - ]
142 + "category": "analytics",
143 + "toolCount": 39,
144 + "triggerCount": 0
145 },
146 {
147 "slug": "jira",
148 "name": "Jira",
149 "logo": "https://logos.composio.dev/api/jira",
1183 - "description": "A tool for bug tracking, issue tracking, and agile project management.",
150 "category": "project management",
1185 - "authSchemes": [
1186 - "OAUTH2",
1187 - "API_KEY"
1188 - ],
1189 - "toolCount": 46,
1190 - "triggerCount": 3,
1191 - "version": "20260211_00",
1192 - "authConfigDetails": [
1193 - {
1194 - "mode": "OAUTH2",
1195 - "name": "jira_oauth",
1196 - "fields": {
1197 - "auth_config_creation": {
1198 - "required": [
1199 - {
1200 - "name": "client_id",
1201 - "displayName": "Client id",
1202 - "type": "string",
1203 - "description": "Client id of the app",
1204 - "required": true,
1205 - "default": null
1206 - },
1207 - {
1208 - "name": "client_secret",
1209 - "displayName": "Client secret",
1210 - "type": "string",
1211 - "description": "Client secret of the app",
1212 - "required": true,
1213 - "default": null
1214 - }
1215 - ],
1216 - "optional": [
1217 - {
1218 - "name": "oauth_redirect_uri",
1219 - "displayName": "Redirect URI",
1220 - "type": "string",
1221 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1222 - "required": false,
1223 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1224 - },
1225 - {
1226 - "name": "scopes",
1227 - "displayName": "Scopes",
1228 - "type": "string",
1229 - "description": "Scopes to request from the user, comma separated",
1230 - "required": false,
1231 - "default": "read:jira-work,write:jira-work,manage:jira-project,manage:jira-configuration,read:jira-user,manage:jira-webhook,manage:jira-data-provider,read:servicedesk-request,manage:servicedesk-customer,write:servicedesk-request,read:servicemanagement-insight-objects,offline_access,read:sprint:jira-software,write:sprint:jira-software,read:board-scope:jira-software,write:board-scope:jira-software,read:project:jira,read:issue-type-scheme:jira"
1232 - }
1233 - ]
1234 - },
1235 - "connected_account_initiation": {
1236 - "required": [
1237 - {
1238 - "name": "subdomain",
1239 - "displayName": "Your Subdomain",
1240 - "type": "string",
1241 - "description": "example: 'your-subdomain' for 'your-subdomain.atlassian.net'",
1242 - "required": true,
1243 - "default": null
1244 - }
1245 - ],
1246 - "optional": []
1247 - }
1248 - }
1249 - },
1250 - {
1251 - "mode": "API_KEY",
1252 - "name": "API_KEY",
1253 - "fields": {
1254 - "auth_config_creation": {
1255 - "required": [],
1256 - "optional": []
1257 - },
1258 - "connected_account_initiation": {
1259 - "required": [
1260 - {
1261 - "name": "subdomain",
1262 - "displayName": "Your Subdomain",
1263 - "type": "string",
1264 - "description": "example: 'your-subdomain' for 'your-subdomain.atlassian.net'",
1265 - "required": true,
1266 - "default": null
1267 - }
1268 - ],
1269 - "optional": [
1270 - {
1271 - "name": "basic_encoded",
1272 - "displayName": "Base Encode (Deprecated)",
1273 - "type": "string",
1274 - "description": "Your encoded email:api_token (Get API Token here: https://id.atlassian.com/manage-profile/security/api-tokens and encode it here: https://www.base64encode.org/)",
1275 - "required": false,
1276 - "default": null
1277 - },
1278 - {
1279 - "name": "generic_api_key",
1280 - "displayName": "API Key (Required)",
1281 - "type": "string",
1282 - "description": "Your Jira API key (Get API Key here: https://id.atlassian.com/manage-profile/security/api-tokens)",
1283 - "required": false,
1284 - "default": null
1285 - },
1286 - {
1287 - "name": "generic_id",
1288 - "displayName": "Jira Email (Required)",
1289 - "type": "string",
1290 - "description": "Your email address for Jira authentication",
1291 - "required": false,
1292 - "default": null
1293 - }
1294 - ]
1295 - }
1296 - }
1297 - }
1298 - ]
151 + "toolCount": 62,
152 + "triggerCount": 3
153 },
154 {
155 "slug": "firecrawl",
156 "name": "Firecrawl",
157 "logo": "https://logos.composio.dev/api/firecrawl",
1304 - "description": "Firecrawl automates web crawling and data extraction, enabling organizations to gather content, index sites, and gain insights from online sources at scale",
158 "category": "ai web scraping",
1306 - "authSchemes": [
1307 - "API_KEY"
1308 - ],
1309 - "toolCount": 7,
1310 - "triggerCount": 0,
1311 - "version": "20260211_00",
1312 - "authConfigDetails": [
1313 - {
1314 - "mode": "API_KEY",
1315 - "name": "firecrawl_api_key",
1316 - "fields": {
1317 - "auth_config_creation": {
1318 - "required": [],
1319 - "optional": []
1320 - },
1321 - "connected_account_initiation": {
1322 - "required": [
1323 - {
1324 - "name": "full",
1325 - "displayName": "Base URL",
1326 - "type": "string",
1327 - "description": "The base url for your firecrawl api",
1328 - "required": true,
1329 - "default": "https://api.firecrawl.dev/v1"
1330 - },
1331 - {
1332 - "name": "generic_api_key",
1333 - "displayName": "API Key",
1334 - "type": "string",
1335 - "description": "Your FireCrawl API key for authentication. Obtain it from your FireCrawl settings.",
1336 - "required": true,
1337 - "default": null
1338 - }
1339 - ],
1340 - "optional": []
1341 - }
1342 - }
1343 - }
1344 - ]
159 + "toolCount": 27,
160 + "triggerCount": 0
161 },
162 {
163 "slug": "tavily",
164 "name": "Tavily",
165 "logo": "https://logos.composio.dev/api/tavily",
1350 - "description": "Tavily offers search and data retrieval solutions, helping teams quickly locate and filter relevant information from documents, databases, or web sources",
1351 - "category": "analytics & data",
1352 - "authSchemes": [
1353 - "API_KEY"
1354 - ],
1355 - "toolCount": 1,
1356 - "triggerCount": 0,
1357 - "version": "20260203_00",
1358 - "authConfigDetails": [
1359 - {
1360 - "mode": "API_KEY",
1361 - "name": "tavily_scheme",
1362 - "fields": {
1363 - "auth_config_creation": {
1364 - "required": [],
1365 - "optional": []
1366 - },
1367 - "connected_account_initiation": {
1368 - "required": [
1369 - {
1370 - "name": "generic_api_key",
1371 - "displayName": "API Key",
1372 - "type": "string",
1373 - "description": "API key for accessing Tavily's services",
1374 - "required": true,
1375 - "default": null
1376 - }
1377 - ],
1378 - "optional": []
1379 - }
1380 - }
1381 - }
1382 - ]
166 + "category": "ai web scraping",
167 + "toolCount": 4,
168 + "triggerCount": 0
169 },
170 {
171 "slug": "youtube",
172 "name": "YouTube",
173 "logo": "https://logos.composio.dev/api/youtube",
1388 - "description": "YouTube is a video-sharing platform with user-generated content, live streaming, and monetization opportunities, widely used for marketing, education, and entertainment",
1389 - "category": "entertainment & media",
1390 - "authSchemes": [
1391 - "OAUTH2"
1392 - ],
1393 - "toolCount": 14,
1394 - "triggerCount": 4,
1395 - "version": "20260203_00",
1396 - "authConfigDetails": [
1397 - {
1398 - "mode": "OAUTH2",
1399 - "name": "OAUTH2",
1400 - "fields": {
1401 - "auth_config_creation": {
1402 - "required": [
1403 - {
1404 - "name": "client_id",
1405 - "displayName": "Client id",
1406 - "type": "string",
1407 - "description": "Client id of the app",
1408 - "required": true,
1409 - "default": null
1410 - },
1411 - {
1412 - "name": "client_secret",
1413 - "displayName": "Client secret",
1414 - "type": "string",
1415 - "description": "Client secret of the app",
1416 - "required": true,
1417 - "default": null
1418 - }
1419 - ],
1420 - "optional": [
1421 - {
1422 - "name": "oauth_redirect_uri",
1423 - "displayName": "Redirect URI",
1424 - "type": "string",
1425 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1426 - "required": false,
1427 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1428 - },
1429 - {
1430 - "name": "scopes",
1431 - "displayName": "Scopes",
1432 - "type": "string",
1433 - "description": "Scopes to request from the user, comma separated",
1434 - "required": false,
1435 - "default": "https://www.googleapis.com/auth/youtube https://www.googleapis.com/auth/youtube.channel-memberships.creator https://www.googleapis.com/auth/youtube.force-ssl https://www.googleapis.com/auth/youtube.readonly https://www.googleapis.com/auth/youtube.upload https://www.googleapis.com/auth/youtubepartner https://www.googleapis.com/auth/youtubepartner-channel-audit"
1436 - }
1437 - ]
1438 - },
1439 - "connected_account_initiation": {
1440 - "required": [],
1441 - "optional": []
1442 - }
1443 - }
1444 - }
1445 - ]
174 + "category": "video & audio",
175 + "toolCount": 24,
176 + "triggerCount": 4
177 },
178 {
179 "slug": "slackbot",
180 "name": "Slackbot",
181 "logo": "https://logos.composio.dev/api/slackbot",
1451 - "description": "Slackbot automates responses and reminders within Slack, assisting with tasks like onboarding, FAQs, and notifications to streamline team productivity",
1452 - "category": "collaboration & communication",
1453 - "authSchemes": [
1454 - "OAUTH2"
1455 - ],
1456 - "toolCount": 133,
1457 - "triggerCount": 9,
1458 - "version": "20260209_00",
1459 - "authConfigDetails": [
1460 - {
1461 - "mode": "OAUTH2",
1462 - "name": "slack_oauth",
1463 - "fields": {
1464 - "auth_config_creation": {
1465 - "required": [
1466 - {
1467 - "name": "client_id",
1468 - "displayName": "Client id",
1469 - "type": "string",
1470 - "description": "Client id of the app",
1471 - "required": true,
1472 - "default": null
1473 - },
1474 - {
1475 - "name": "client_secret",
1476 - "displayName": "Client secret",
1477 - "type": "string",
1478 - "description": "Client secret of the app",
1479 - "required": true,
1480 - "default": null
1481 - }
1482 - ],
1483 - "optional": [
1484 - {
1485 - "name": "oauth_redirect_uri",
1486 - "displayName": "Redirect URI",
1487 - "type": "string",
1488 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1489 - "required": false,
1490 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1491 - },
1492 - {
1493 - "name": "scopes",
1494 - "displayName": "Bot Scopes",
1495 - "type": "string",
1496 - "description": "Scopes to request from the bot",
1497 - "required": false,
1498 - "default": "channels:history,chat:write,chat:write,team:read,channels:read,users:read,reactions:read"
1499 - },
1500 - {
1501 - "name": "verification_token",
1502 - "displayName": "Verification Token",
1503 - "type": "string",
1504 - "description": "Verification token required to verify the request is coming from slack. You can find it in the slack app settings just below the client id and secret. It is required to enable Slack triggers.",
1505 - "required": false,
1506 - "default": null
1507 - }
1508 - ]
1509 - },
1510 - "connected_account_initiation": {
1511 - "required": [],
1512 - "optional": []
1513 - }
1514 - }
1515 - }
1516 - ]
182 + "category": "team chat",
183 + "toolCount": 155,
184 + "triggerCount": 9
185 },
186 {
187 "slug": "canvas",
188 "name": "Canvas",
189 "logo": "https://logos.composio.dev/api/canvas",
1522 - "description": "Canvas is a learning management system supporting online courses, assignments, grading, and collaboration, widely used by schools and universities for virtual classrooms",
190 "category": "online courses",
1524 - "authSchemes": [
1525 - "OAUTH2",
1526 - "API_KEY"
1527 - ],
1528 - "toolCount": 87,
1529 - "triggerCount": 6,
1530 - "version": "20260211_00",
1531 - "authConfigDetails": [
1532 - {
1533 - "mode": "OAUTH2",
1534 - "name": "OAuth2 Authorization Code",
1535 - "fields": {
1536 - "auth_config_creation": {
1537 - "required": [
1538 - {
1539 - "name": "client_id",
1540 - "displayName": "Client id",
1541 - "type": "string",
1542 - "description": "Client id of the app",
1543 - "required": true,
1544 - "default": null
1545 - },
1546 - {
1547 - "name": "client_secret",
1548 - "displayName": "Client secret",
1549 - "type": "string",
1550 - "description": "Client secret of the app",
1551 - "required": true,
1552 - "default": null
1553 - },
1554 - {
1555 - "name": "full",
1556 - "displayName": "Canvas Base URL",
1557 - "type": "string",
1558 - "description": "The base URL of your Canvas instance (e.g., https://canvas.instructure.com).",
1559 - "required": true,
1560 - "default": "https://canvas.instructure.com"
1561 - }
1562 - ],
1563 - "optional": [
1564 - {
1565 - "name": "oauth_redirect_uri",
1566 - "displayName": "Redirect URI",
1567 - "type": "string",
1568 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1569 - "required": false,
1570 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1571 - },
1572 - {
1573 - "name": "scopes",
1574 - "displayName": "Scopes",
1575 - "type": "string",
1576 - "description": "Scopes to request from the user, comma separated",
1577 - "required": false,
1578 - "default": ""
1579 - }
1580 - ]
1581 - },
1582 - "connected_account_initiation": {
1583 - "required": [],
1584 - "optional": []
1585 - }
1586 - }
1587 - },
1588 - {
1589 - "mode": "API_KEY",
1590 - "name": "canavs_apikey",
1591 - "fields": {
1592 - "auth_config_creation": {
1593 - "required": [],
1594 - "optional": []
1595 - },
1596 - "connected_account_initiation": {
1597 - "required": [
1598 - {
1599 - "name": "full",
1600 - "displayName": "Canvas Base URL",
1601 - "type": "string",
1602 - "description": "The base URL of your Canvas instance (e.g., https://canvas.instructure.com).",
1603 - "required": true,
1604 - "default": null
1605 - },
1606 - {
1607 - "name": "generic_api_key",
1608 - "displayName": "Acess token",
1609 - "type": "string",
1610 - "description": "You can find your API key in your project settings.",
1611 - "required": true,
1612 - "default": null
1613 - }
1614 - ],
1615 - "optional": []
1616 - }
1617 - }
1618 - }
1619 - ]
191 + "toolCount": 92,
192 + "triggerCount": 6
193 },
194 {
195 "slug": "bitbucket",
196 "name": "Bitbucket",
197 "logo": "https://logos.composio.dev/api/bitbucket",
1625 - "description": "Bitbucket is a Git-based code hosting and collaboration platform supporting private and public repositories, enabling teams to manage and review code through pull requests and integrations",
198 "category": "developer tools",
1627 - "authSchemes": [
1628 - "OAUTH2"
1629 - ],
1630 - "toolCount": 17,
1631 - "triggerCount": 0,
1632 - "version": "20260211_00",
1633 - "authConfigDetails": [
1634 - {
1635 - "mode": "OAUTH2",
1636 - "name": "OAuth2",
1637 - "fields": {
1638 - "auth_config_creation": {
1639 - "required": [
1640 - {
1641 - "name": "client_id",
1642 - "displayName": "Client id",
1643 - "type": "string",
1644 - "description": "Client id of the app",
1645 - "required": true,
1646 - "default": null
1647 - },
1648 - {
1649 - "name": "client_secret",
1650 - "displayName": "Client secret",
1651 - "type": "string",
1652 - "description": "Client secret of the app",
1653 - "required": true,
1654 - "default": null
1655 - }
1656 - ],
1657 - "optional": [
1658 - {
1659 - "name": "oauth_redirect_uri",
1660 - "displayName": "Redirect URI",
1661 - "type": "string",
1662 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1663 - "required": false,
1664 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1665 - },
1666 - {
1667 - "name": "scopes",
1668 - "displayName": "Scopes",
1669 - "type": "string",
1670 - "description": "Scopes to request from the user, comma separated",
1671 - "required": false,
1672 - "default": "webhook,pullrequest:write,project:admin,runner:write,project:write,snippet:write,team:write,pipeline:variable,repository:delete,repository:admin,account:write,wiki,issue:write"
1673 - }
1674 - ]
1675 - },
1676 - "connected_account_initiation": {
1677 - "required": [],
1678 - "optional": []
1679 - }
1680 - }
1681 - }
1682 - ]
199 + "toolCount": 24,
200 + "triggerCount": 0
201 },
202 {
203 "slug": "googletasks",
204 "name": "Google Tasks",
205 "logo": "https://logos.composio.dev/api/googletasks",
1688 - "description": "Google Tasks provides a simple to-do list and task management system integrated into Gmail and Google Calendar for quick and easy tracking",
206 "category": "task management",
1690 - "authSchemes": [
1691 - "OAUTH2"
1692 - ],
1693 - "toolCount": 14,
1694 - "triggerCount": 0,
1695 - "version": "20260211_00",
1696 - "authConfigDetails": [
1697 - {
1698 - "mode": "OAUTH2",
1699 - "name": "oauth2",
1700 - "fields": {
1701 - "auth_config_creation": {
1702 - "required": [
1703 - {
1704 - "name": "client_id",
1705 - "displayName": "Client id",
1706 - "type": "string",
1707 - "description": "Client id of the app",
1708 - "required": true,
1709 - "default": null
1710 - },
1711 - {
1712 - "name": "client_secret",
1713 - "displayName": "Client secret",
1714 - "type": "string",
1715 - "description": "Client secret of the app",
1716 - "required": true,
1717 - "default": null
1718 - }
1719 - ],
1720 - "optional": [
1721 - {
1722 - "name": "oauth_redirect_uri",
1723 - "displayName": "Redirect URI",
1724 - "type": "string",
1725 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1726 - "required": false,
1727 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1728 - },
1729 - {
1730 - "name": "scopes",
1731 - "displayName": "Scopes",
1732 - "type": "string",
1733 - "description": "Scopes to request from the user, comma separated",
1734 - "required": false,
1735 - "default": "https://www.googleapis.com/auth/tasks"
1736 - }
1737 - ]
1738 - },
1739 - "connected_account_initiation": {
1740 - "required": [],
1741 - "optional": []
1742 - }
1743 - }
1744 - }
1745 - ]
207 + "toolCount": 17,
208 + "triggerCount": 0
209 },
210 {
211 "slug": "discord",
212 "name": "Discord",
213 "logo": "https://logos.composio.dev/api/discord",
1751 - "description": "An instant messaging and VoIP social platform.",
214 "category": "team chat",
1753 - "authSchemes": [
1754 - "OAUTH2"
1755 - ],
1756 - "toolCount": 6,
1757 - "triggerCount": 1,
1758 - "version": "20260211_00",
1759 - "authConfigDetails": [
1760 - {
1761 - "mode": "OAUTH2",
1762 - "name": "discord_oauth",
1763 - "fields": {
1764 - "auth_config_creation": {
1765 - "required": [
1766 - {
1767 - "name": "client_id",
1768 - "displayName": "Client id",
1769 - "type": "string",
1770 - "description": "Client id of the app",
1771 - "required": true,
1772 - "default": null
1773 - },
1774 - {
1775 - "name": "client_secret",
1776 - "displayName": "Client secret",
1777 - "type": "string",
1778 - "description": "Client secret of the app",
1779 - "required": true,
1780 - "default": null
1781 - }
1782 - ],
1783 - "optional": [
1784 - {
1785 - "name": "oauth_redirect_uri",
1786 - "displayName": "Redirect URI",
1787 - "type": "string",
1788 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1789 - "required": false,
1790 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1791 - },
1792 - {
1793 - "name": "scopes",
1794 - "displayName": "Scopes",
1795 - "type": "string",
1796 - "description": "Scopes to request from the user, comma separated",
1797 - "required": false,
1798 - "default": "identify,email,connections,guilds,guilds.join,guilds.members.read,messages.read,openid"
1799 - }
1800 - ]
1801 - },
1802 - "connected_account_initiation": {
1803 - "required": [],
1804 - "optional": []
1805 - }
1806 - }
1807 - }
1808 - ]
215 + "toolCount": 15,
216 + "triggerCount": 1
217 },
218 {
219 "slug": "figma",
220 "name": "Figma",
221 "logo": "https://logos.composio.dev/api/figma",
1814 - "description": "A collaborative interface design tool.",
222 "category": "images & design",
1816 - "authSchemes": [
1817 - "OAUTH2",
1818 - "API_KEY"
1819 - ],
1820 - "toolCount": 49,
1821 - "triggerCount": 0,
1822 - "version": "20260211_00",
1823 - "authConfigDetails": [
1824 - {
1825 - "mode": "OAUTH2",
1826 - "name": "figma_oauth2",
1827 - "fields": {
1828 - "auth_config_creation": {
1829 - "required": [
1830 - {
1831 - "name": "client_id",
1832 - "displayName": "Client id",
1833 - "type": "string",
1834 - "description": "Client id of the app",
1835 - "required": true,
1836 - "default": null
1837 - },
1838 - {
1839 - "name": "client_secret",
1840 - "displayName": "Client secret",
1841 - "type": "string",
1842 - "description": "Client secret of the app",
1843 - "required": true,
1844 - "default": null
1845 - },
1846 - {
1847 - "name": "full",
1848 - "displayName": "Base URL",
1849 - "type": "string",
1850 - "description": "Figma is a collaborative design tool supporting real-time editing, prototyping, and feedback, helping product teams iterate on UI/UX in a single environment",
1851 - "required": true,
1852 - "default": "https://api.figma.com"
1853 - }
1854 - ],
1855 - "optional": [
1856 - {
1857 - "name": "oauth_redirect_uri",
1858 - "displayName": "Redirect URI",
1859 - "type": "string",
1860 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1861 - "required": false,
1862 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1863 - },
1864 - {
1865 - "name": "scopes",
1866 - "displayName": "Scopes",
1867 - "type": "string",
1868 - "description": "Scopes to request from the user, comma separated",
1869 - "required": false,
1870 - "default": "file_comments:write,webhooks:write,current_user:read,file_content:read,file_comments:read,projects:read,library_assets:read,library_content:read,team_library_content:read,file_metadata:read,file_versions:read,webhooks:read"
1871 - }
1872 - ]
1873 - },
1874 - "connected_account_initiation": {
1875 - "required": [],
1876 - "optional": []
1877 - }
1878 - }
1879 - },
1880 - {
1881 - "mode": "API_KEY",
1882 - "name": "figma_api_key",
1883 - "fields": {
1884 - "auth_config_creation": {
1885 - "required": [],
1886 - "optional": []
1887 - },
1888 - "connected_account_initiation": {
1889 - "required": [
1890 - {
1891 - "name": "full",
1892 - "displayName": "Base URL",
1893 - "type": "string",
1894 - "description": "Figma API base URL",
1895 - "required": true,
1896 - "default": "https://api.figma.com"
1897 - },
1898 - {
1899 - "name": "generic_api_key",
1900 - "displayName": "Personal Access Token",
1901 - "type": "string",
1902 - "description": "Personal access token generated from Figma account settings (Security tab)",
1903 - "required": true,
1904 - "default": null
1905 - }
1906 - ],
1907 - "optional": []
1908 - }
1909 - }
1910 - }
1911 - ]
223 + "toolCount": 50,
224 + "triggerCount": 0
225 },
226 {
227 "slug": "composio_search",
228 "name": "Composio Search",
229 "logo": "https://logos.composio.dev/api/composio_search",
1917 - "description": "Composio Search provides comprehensive web search across travel (flights, hotels, events), e-commerce (Amazon, Walmart, shopping), financial markets, news, academic research, images, and location services.",
230 "category": "ai agents",
1919 - "authSchemes": [
1920 - "NO_AUTH"
1921 - ],
1922 - "toolCount": 13,
1923 - "triggerCount": 0,
1924 - "version": "20260211_00",
1925 - "authConfigDetails": [
1926 - {
1927 - "mode": "NO_AUTH",
1928 - "name": "Composio Search",
1929 - "fields": {
1930 - "auth_config_creation": {
1931 - "required": [],
1932 - "optional": []
1933 - },
1934 - "connected_account_initiation": {
1935 - "required": [],
1936 - "optional": []
1937 - }
1938 - }
1939 - }
1940 - ]
231 + "toolCount": 23,
232 + "triggerCount": 0
233 },
234 {
235 "slug": "reddit",
236 "name": "Reddit",
237 "logo": "https://logos.composio.dev/api/reddit",
1946 - "description": "Reddit is a social news platform with user-driven communities (subreddits), offering content sharing, discussions, and viral marketing opportunities for brands",
238 "category": "social media accounts",
1948 - "authSchemes": [
1949 - "OAUTH2"
1950 - ],
1951 - "toolCount": 10,
1952 - "triggerCount": 0,
1953 - "version": "20260211_00",
1954 - "authConfigDetails": [
1955 - {
1956 - "mode": "OAUTH2",
1957 - "name": "reddit_oauth2",
1958 - "fields": {
1959 - "auth_config_creation": {
1960 - "required": [
1961 - {
1962 - "name": "client_id",
1963 - "displayName": "Client id",
1964 - "type": "string",
1965 - "description": "Client id of the app",
1966 - "required": true,
1967 - "default": null
1968 - },
1969 - {
1970 - "name": "client_secret",
1971 - "displayName": "Client secret",
1972 - "type": "string",
1973 - "description": "Client secret of the app",
1974 - "required": true,
1975 - "default": null
1976 - }
1977 - ],
1978 - "optional": [
1979 - {
1980 - "name": "oauth_redirect_uri",
1981 - "displayName": "Redirect URI",
1982 - "type": "string",
1983 - "description": "Add this Redirect URL to your app's OAuth allow list.",
1984 - "required": false,
1985 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
1986 - },
1987 - {
1988 - "name": "scopes",
1989 - "displayName": "Scopes",
1990 - "type": "string",
1991 - "description": "Scopes to request from the user, comma separated",
1992 - "required": false,
1993 - "default": "identity,read,vote,submit,flair,edit"
1994 - }
1995 - ]
1996 - },
1997 - "connected_account_initiation": {
1998 - "required": [],
1999 - "optional": []
2000 - }
2001 - }
2002 - }
2003 - ]
239 + "toolCount": 20,
240 + "triggerCount": 0
241 },
242 {
243 "slug": "cal",
244 "name": "Cal",
245 "logo": "https://logos.composio.dev/api/cal",
2009 - "description": "Cal simplifies meeting coordination by providing shareable booking pages, calendar syncing, and availability management to streamline the scheduling process",
246 "category": "scheduling & booking",
2011 - "authSchemes": [
2012 - "API_KEY",
2013 - "OAUTH2"
2014 - ],
247 "toolCount": 141,
2016 - "triggerCount": 0,
2017 - "version": "20260211_00",
2018 - "authConfigDetails": [
2019 - {
2020 - "mode": "OAUTH2",
2021 - "name": "cal_com_oauth2",
2022 - "fields": {
2023 - "auth_config_creation": {
2024 - "required": [
2025 - {
2026 - "name": "client_id",
2027 - "displayName": "Client id",
2028 - "type": "string",
2029 - "description": "Client id of the app",
2030 - "required": true,
2031 - "default": null
2032 - },
2033 - {
2034 - "name": "client_secret",
2035 - "displayName": "Client secret",
2036 - "type": "string",
2037 - "description": "Client secret of the app",
2038 - "required": true,
2039 - "default": null
2040 - },
2041 - {
2042 - "name": "full",
2043 - "displayName": "Base URL",
2044 - "type": "string",
2045 - "description": "The base URL for the Cal.com API.",
2046 - "required": true,
2047 - "default": "https://api.cal.com/"
2048 - }
2049 - ],
2050 - "optional": [
2051 - {
2052 - "name": "oauth_redirect_uri",
2053 - "displayName": "Redirect URI",
2054 - "type": "string",
2055 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2056 - "required": false,
2057 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2058 - },
2059 - {
2060 - "name": "scopes",
2061 - "displayName": "Scopes",
2062 - "type": "string",
2063 - "description": "Scopes to request from the user, comma separated",
2064 - "required": false,
2065 - "default": ""
2066 - }
2067 - ]
2068 - },
2069 - "connected_account_initiation": {
2070 - "required": [],
2071 - "optional": []
2072 - }
2073 - }
2074 - },
2075 - {
2076 - "mode": "API_KEY",
2077 - "name": "cal_com_api_key",
2078 - "fields": {
2079 - "auth_config_creation": {
2080 - "required": [
2081 - {
2082 - "name": "full",
2083 - "displayName": "Base URL",
2084 - "type": "string",
2085 - "description": "The base URL for the Cal.com API.",
2086 - "required": true,
2087 - "default": "https://api.cal.com/"
2088 - }
2089 - ],
2090 - "optional": []
2091 - },
2092 - "connected_account_initiation": {
2093 - "required": [
2094 - {
2095 - "name": "generic_api_key",
2096 - "displayName": "API Key",
2097 - "type": "string",
2098 - "description": "API key used for authenticating requests to Cal.com. Use 'cal_' prefix for test mode and 'cal_live_' for live mode.",
2099 - "required": true,
2100 - "default": null
2101 - }
2102 - ],
2103 - "optional": []
2104 - }
2105 - }
2106 - }
2107 - ]
248 + "triggerCount": 0
249 },
250 {
251 "slug": "wrike",
252 "name": "Wrike",
253 "logo": "https://logos.composio.dev/api/wrike",
2113 - "description": "Wrike is a project management and collaboration tool offering customizable workflows, Gantt charts, reporting, and resource management to boost team productivity",
2114 - "category": "productivity & project management",
2115 - "authSchemes": [
2116 - "OAUTH2"
2117 - ],
2118 - "toolCount": 38,
2119 - "triggerCount": 0,
2120 - "version": "20260209_00",
2121 - "authConfigDetails": [
2122 - {
2123 - "mode": "OAUTH2",
2124 - "name": "canva_oauth",
2125 - "fields": {
2126 - "auth_config_creation": {
2127 - "required": [
2128 - {
2129 - "name": "client_id",
2130 - "displayName": "Client id",
2131 - "type": "string",
2132 - "description": "Client id of the app",
2133 - "required": true,
2134 - "default": null
2135 - },
2136 - {
2137 - "name": "client_secret",
2138 - "displayName": "Client secret",
2139 - "type": "string",
2140 - "description": "Client secret of the app",
2141 - "required": true,
2142 - "default": null
2143 - },
2144 - {
2145 - "name": "full",
2146 - "displayName": "Wrike Base URL",
2147 - "type": "string",
2148 - "description": "The base URL of your Wrike instance (e.g., https://www.wrike.com).",
2149 - "required": true,
2150 - "default": "https://www.wrike.com/api/v4"
2151 - }
2152 - ],
2153 - "optional": [
2154 - {
2155 - "name": "oauth_redirect_uri",
2156 - "displayName": "Redirect URI",
2157 - "type": "string",
2158 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2159 - "required": false,
2160 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2161 - },
2162 - {
2163 - "name": "scopes",
2164 - "displayName": "Scopes",
2165 - "type": "string",
2166 - "description": "Scopes to request from the user, comma separated",
2167 - "required": false,
2168 - "default": "Default,wsReadOnly,wsReadWrite,amReadOnlyWorkflow,amReadWriteWorkflow,amReadOnlyInvitation,amReadWriteInvitation,amReadOnlyGroup,amReadWriteGroup,amReadOnlyUser,amReadWriteUser"
2169 - }
2170 - ]
2171 - },
2172 - "connected_account_initiation": {
2173 - "required": [],
2174 - "optional": []
2175 - }
2176 - }
2177 - }
2178 - ]
254 + "category": "project management",
255 + "toolCount": 41,
256 + "triggerCount": 0
257 },
258 {
259 "slug": "exa",
260 "name": "Exa",
261 "logo": "https://logos.composio.dev/api/exa",
2184 - "description": "Exa focuses on data extraction and search, helping teams gather, analyze, and visualize information from websites, APIs, or internal databases",
262 "category": "ai web scraping",
2186 - "authSchemes": [
2187 - "API_KEY"
2188 - ],
263 "toolCount": 14,
2190 - "triggerCount": 0,
2191 - "version": "20260211_00",
2192 - "authConfigDetails": [
2193 - {
2194 - "mode": "API_KEY",
2195 - "name": "exa_scheme",
2196 - "fields": {
2197 - "auth_config_creation": {
2198 - "required": [],
2199 - "optional": []
2200 - },
2201 - "connected_account_initiation": {
2202 - "required": [
2203 - {
2204 - "name": "generic_api_key",
2205 - "displayName": "API Key",
2206 - "type": "string",
2207 - "description": "Exa API key.",
2208 - "required": true,
2209 - "default": null
2210 - }
2211 - ],
2212 - "optional": []
2213 - }
2214 - }
2215 - }
2216 - ]
264 + "triggerCount": 0
265 },
266 {
267 "slug": "sentry",
268 "name": "Sentry",
269 "logo": "https://logos.composio.dev/api/sentry",
2222 - "description": "Integrate Sentry to manage your error tracking and monitoring.",
270 "category": "developer tools",
2224 - "authSchemes": [
2225 - "OAUTH2",
2226 - "BEARER_TOKEN"
2227 - ],
2228 - "toolCount": 176,
2229 - "triggerCount": 0,
2230 - "version": "20260211_00",
2231 - "authConfigDetails": [
2232 - {
2233 - "mode": "OAUTH2",
2234 - "name": "sentry_oauth2",
2235 - "fields": {
2236 - "auth_config_creation": {
2237 - "required": [
2238 - {
2239 - "name": "client_id",
2240 - "displayName": "Client id",
2241 - "type": "string",
2242 - "description": "Client id of the app",
2243 - "required": true,
2244 - "default": null
2245 - },
2246 - {
2247 - "name": "client_secret",
2248 - "displayName": "Client secret",
2249 - "type": "string",
2250 - "description": "Client secret of the app",
2251 - "required": true,
2252 - "default": null
2253 - }
2254 - ],
2255 - "optional": [
2256 - {
2257 - "name": "oauth_redirect_uri",
2258 - "displayName": "Redirect URI",
2259 - "type": "string",
2260 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2261 - "required": false,
2262 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2263 - },
2264 - {
2265 - "name": "scopes",
2266 - "displayName": "Scopes",
2267 - "type": "string",
2268 - "description": "Scopes to request from the user, comma separated",
2269 - "required": false,
2270 - "default": "org:read,org:write,project:read,project:write,project:releases,team:read,team:write,member:read,member:write,event:read,event:write"
2271 - }
2272 - ]
2273 - },
2274 - "connected_account_initiation": {
2275 - "required": [],
2276 - "optional": []
2277 - }
2278 - }
2279 - },
2280 - {
2281 - "mode": "BEARER_TOKEN",
2282 - "name": "sentry_bearer_token",
2283 - "fields": {
2284 - "auth_config_creation": {
2285 - "required": [],
2286 - "optional": []
2287 - },
2288 - "connected_account_initiation": {
2289 - "required": [
2290 - {
2291 - "name": "token",
2292 - "displayName": "Bearer Token",
2293 - "type": "string",
2294 - "description": "Token for bearer authentication",
2295 - "required": true,
2296 - "default": null
2297 - }
2298 - ],
2299 - "optional": []
2300 - }
2301 - }
2302 - }
2303 - ]
271 + "toolCount": 206,
272 + "triggerCount": 0
273 },
274 {
275 "slug": "snowflake",
276 "name": "Snowflake",
277 "logo": "https://logos.composio.dev/api/snowflake",
2309 - "description": "Snowflake is a cloud-based data warehouse offering elastic scaling, secure data sharing, and SQL analytics across multiple cloud environments",
2310 - "category": "analytics & data",
2311 - "authSchemes": [
2312 - "OAUTH2"
2313 - ],
278 + "category": "databases",
279 "toolCount": 15,
2315 - "triggerCount": 0,
2316 - "version": "20260203_00",
2317 - "authConfigDetails": [
2318 - {
2319 - "mode": "OAUTH2",
2320 - "name": "snowflake_oauth",
2321 - "fields": {
2322 - "auth_config_creation": {
2323 - "required": [
2324 - {
2325 - "name": "client_id",
2326 - "displayName": "Client id",
2327 - "type": "string",
2328 - "description": "Client id of the app",
2329 - "required": true,
2330 - "default": null
2331 - },
2332 - {
2333 - "name": "client_secret",
2334 - "displayName": "Client secret",
2335 - "type": "string",
2336 - "description": "Client secret of the app",
2337 - "required": true,
2338 - "default": null
2339 - }
2340 - ],
2341 - "optional": [
2342 - {
2343 - "name": "oauth_redirect_uri",
2344 - "displayName": "Redirect URI",
2345 - "type": "string",
2346 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2347 - "required": false,
2348 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2349 - },
2350 - {
2351 - "name": "scopes",
2352 - "displayName": "Scopes",
2353 - "type": "string",
2354 - "description": "Scopes to request from the user, comma separated",
2355 - "required": false,
2356 - "default": "refresh_token"
2357 - }
2358 - ]
2359 - },
2360 - "connected_account_initiation": {
2361 - "required": [
2362 - {
2363 - "name": "subdomain",
2364 - "displayName": "Account ID",
2365 - "type": "string",
2366 - "description": "Your Snowflake account ID for authentication. This is typically your account name (e.g., 'xy12345' or 'myorganization-myaccount').",
2367 - "required": true,
2368 - "default": null
2369 - }
2370 - ],
2371 - "optional": []
2372 - }
2373 - }
2374 - }
2375 - ]
280 + "triggerCount": 0
281 },
282 {
283 "slug": "hackernews",
284 "name": "Hacker News",
285 "logo": "https://logos.composio.dev/api/hackernews",
2381 - "description": "Hacker News is a tech-focused news aggregator by Y Combinator, featuring user-submitted stories and discussions on startups, programming, and emerging trends",
286 "category": "news & lifestyle",
2383 - "authSchemes": [
2384 - "NO_AUTH"
2385 - ],
287 "toolCount": 6,
2387 - "triggerCount": 0,
2388 - "version": "20260211_00",
2389 - "authConfigDetails": [
2390 - {
2391 - "mode": "NO_AUTH",
2392 - "name": "HackerNews",
2393 - "fields": {
2394 - "auth_config_creation": {
2395 - "required": [],
2396 - "optional": []
2397 - },
2398 - "connected_account_initiation": {
2399 - "required": [],
2400 - "optional": []
2401 - }
2402 - }
2403 - }
2404 - ]
288 + "triggerCount": 0
289 },
290 {
291 "slug": "elevenlabs",
292 "name": "ElevenLabs",
293 "logo": "https://logos.composio.dev/api/elevenlabs",
2410 - "description": "Create natural AI voices instantly in any language - perfect for video creators, developers, and businesses.",
294 "category": "artificial intelligence",
2412 - "authSchemes": [
2413 - "API_KEY"
2414 - ],
2415 - "toolCount": 61,
2416 - "triggerCount": 0,
2417 - "version": "20260211_00",
2418 - "authConfigDetails": [
2419 - {
2420 - "mode": "API_KEY",
2421 - "name": "elevenlabs_api_key",
2422 - "fields": {
2423 - "auth_config_creation": {
2424 - "required": [],
2425 - "optional": []
2426 - },
2427 - "connected_account_initiation": {
2428 - "required": [
2429 - {
2430 - "name": "generic_api_key",
2431 - "displayName": "API Key",
2432 - "type": "string",
2433 - "description": "Your Eleven Labs API key.",
2434 - "required": true,
2435 - "default": null
2436 - }
2437 - ],
2438 - "optional": []
2439 - }
2440 - }
2441 - }
2442 - ]
295 + "toolCount": 66,
296 + "triggerCount": 0
297 },
298 {
299 "slug": "microsoft_teams",
300 "name": "Microsoft Teams",
301 "logo": "https://logos.composio.dev/api/microsoft_teams",
2448 - "description": "Microsoft Teams integrates chat, video meetings, and file storage within Microsoft 365, providing virtual collaboration and communication for distributed teams",
302 "category": "team chat",
2450 - "authSchemes": [
2451 - "OAUTH2"
2452 - ],
2453 - "toolCount": 28,
2454 - "triggerCount": 0,
2455 - "version": "20260211_00",
2456 - "authConfigDetails": [
2457 - {
2458 - "mode": "OAUTH2",
2459 - "name": "microsoft-teams_oauth",
2460 - "fields": {
2461 - "auth_config_creation": {
2462 - "required": [
2463 - {
2464 - "name": "client_id",
2465 - "displayName": "Client id",
2466 - "type": "string",
2467 - "description": "Client id of the app",
2468 - "required": true,
2469 - "default": null
2470 - },
2471 - {
2472 - "name": "client_secret",
2473 - "displayName": "Client secret",
2474 - "type": "string",
2475 - "description": "Client secret of the app",
2476 - "required": true,
2477 - "default": null
2478 - }
2479 - ],
2480 - "optional": [
2481 - {
2482 - "name": "oauth_redirect_uri",
2483 - "displayName": "Redirect URI",
2484 - "type": "string",
2485 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2486 - "required": false,
2487 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2488 - },
2489 - {
2490 - "name": "scopes",
2491 - "displayName": "Scopes",
2492 - "type": "string",
2493 - "description": "Scopes to request from the user, comma separated",
2494 - "required": false,
2495 - "default": "Channel.Create,Channel.ReadBasic.All,ChannelMessage.Read.All,ChannelMessage.ReadWrite,ChannelMessage.Send,ChannelSettings.ReadWrite.All,Chat.Create,Chat.Read,Chat.ReadBasic,Chat.ReadWrite,Chat.ReadWrite.All,ChatMessage.Read,ChatMessage.Send,Directory.ReadWrite.All,Group.ReadWrite.All,offline_access,People.Read.All,Presence.ReadWrite,Team.Create,Team.ReadBasic.All,TeamMember.ReadWrite.All,TeamsActivity.Read,TeamsActivity.Send,User.Read,OnlineMeetings.ReadWrite"
2496 - }
2497 - ]
2498 - },
2499 - "connected_account_initiation": {
2500 - "required": [],
2501 - "optional": []
2502 - }
2503 - }
2504 - }
2505 - ]
303 + "toolCount": 34,
304 + "triggerCount": 0
305 },
306 {
307 "slug": "asana",
308 "name": "Asana",
309 "logo": "https://logos.composio.dev/api/asana",
2511 - "description": "Tool to help teams organize, track, and manage their work.",
310 "category": "project management",
2513 - "authSchemes": [
2514 - "OAUTH2"
2515 - ],
2516 - "toolCount": 84,
2517 - "triggerCount": 1,
2518 - "version": "20260211_00",
2519 - "authConfigDetails": [
2520 - {
2521 - "mode": "OAUTH2",
2522 - "name": "asana_oauth",
2523 - "fields": {
2524 - "auth_config_creation": {
2525 - "required": [
2526 - {
2527 - "name": "client_id",
2528 - "displayName": "Client id",
2529 - "type": "string",
2530 - "description": "Client id of the app",
2531 - "required": true,
2532 - "default": null
2533 - },
2534 - {
2535 - "name": "client_secret",
2536 - "displayName": "Client secret",
2537 - "type": "string",
2538 - "description": "Client secret of the app",
2539 - "required": true,
2540 - "default": null
2541 - }
2542 - ],
2543 - "optional": [
2544 - {
2545 - "name": "oauth_redirect_uri",
2546 - "displayName": "Redirect URI",
2547 - "type": "string",
2548 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2549 - "required": false,
2550 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2551 - },
2552 - {
2553 - "name": "scopes",
2554 - "displayName": "Scopes",
2555 - "type": "string",
2556 - "description": "Scopes to request from the user, comma separated",
2557 - "required": false,
2558 - "default": ""
2559 - }
2560 - ]
2561 - },
2562 - "connected_account_initiation": {
2563 - "required": [],
2564 - "optional": []
2565 - }
2566 - }
2567 - }
2568 - ]
311 + "toolCount": 92,
312 + "triggerCount": 1
313 },
314 {
315 "slug": "peopledatalabs",
316 "name": "People Data Labs",
317 "logo": "https://logos.composio.dev/api/peopledatalabs",
2574 - "description": "PeopleDataLabs provides B2B data enrichment and identity resolution, empowering organizations to build enriched user profiles and validate customer information",
318 "category": "analytics",
2576 - "authSchemes": [
2577 - "API_KEY"
2578 - ],
319 "toolCount": 15,
2580 - "triggerCount": 0,
2581 - "version": "20260211_00",
2582 - "authConfigDetails": [
2583 - {
2584 - "mode": "API_KEY",
2585 - "name": "people_data_labs_api_key",
2586 - "fields": {
2587 - "auth_config_creation": {
2588 - "required": [],
2589 - "optional": []
2590 - },
2591 - "connected_account_initiation": {
2592 - "required": [
2593 - {
2594 - "name": "generic_api_key",
2595 - "displayName": "API Key",
2596 - "type": "string",
2597 - "description": "Your People Data Labs API Key.",
2598 - "required": true,
2599 - "default": null
2600 - }
2601 - ],
2602 - "optional": []
2603 - }
2604 - }
2605 - }
2606 - ]
320 + "triggerCount": 0
321 },
322 {
323 "slug": "shopify",
324 "name": "Shopify",
325 "logo": "https://logos.composio.dev/api/shopify",
2612 - "description": "Shopify is an e-commerce platform enabling merchants to create online stores, manage products, and process payments with themes, apps, and integrated marketing tools",
2613 - "category": "e-commerce",
2614 - "authSchemes": [
2615 - "API_KEY",
2616 - "OAUTH2"
2617 - ],
2618 - "toolCount": 28,
2619 - "triggerCount": 0,
2620 - "version": "20260209_00",
2621 - "authConfigDetails": [
2622 - {
2623 - "mode": "OAUTH2",
2624 - "name": "OAuth2",
2625 - "fields": {
2626 - "auth_config_creation": {
2627 - "required": [
2628 - {
2629 - "name": "client_id",
2630 - "displayName": "Client id",
2631 - "type": "string",
2632 - "description": "Client id of the app",
2633 - "required": true,
2634 - "default": null
2635 - },
2636 - {
2637 - "name": "client_secret",
2638 - "displayName": "Client secret",
2639 - "type": "string",
2640 - "description": "Client secret of the app",
2641 - "required": true,
2642 - "default": null
2643 - }
2644 - ],
2645 - "optional": [
2646 - {
2647 - "name": "oauth_redirect_uri",
2648 - "displayName": "Redirect URI",
2649 - "type": "string",
2650 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2651 - "required": false,
2652 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2653 - },
2654 - {
2655 - "name": "scopes",
2656 - "displayName": "Scopes",
2657 - "type": "string",
2658 - "description": "Scopes to request from the user, comma separated",
2659 - "required": false,
2660 - "default": "read_products,write_products,read_orders,write_orders"
2661 - }
2662 - ]
2663 - },
2664 - "connected_account_initiation": {
2665 - "required": [
2666 - {
2667 - "name": "subdomain",
2668 - "displayName": "Store Subdomain",
2669 - "type": "string",
2670 - "description": "Your Shopify store's subdomain (e.g., your-store-name in your-store-name.myshopify.com)",
2671 - "required": true,
2672 - "default": null
2673 - }
2674 - ],
2675 - "optional": []
2676 - }
2677 - }
2678 - },
2679 - {
2680 - "mode": "API_KEY",
2681 - "name": "API_KEY",
2682 - "fields": {
2683 - "auth_config_creation": {
2684 - "required": [],
2685 - "optional": []
2686 - },
2687 - "connected_account_initiation": {
2688 - "required": [
2689 - {
2690 - "name": "subdomain",
2691 - "displayName": "Store Subdomain",
2692 - "type": "string",
2693 - "description": "Your Shopify store's subdomain (e.g., your-store-name in your-store-name.myshopify.com)",
2694 - "required": true,
2695 - "default": null
2696 - },
2697 - {
2698 - "name": "generic_api_key",
2699 - "displayName": "Admin Api Access Token",
2700 - "type": "string",
2701 - "description": "Your Admin api acess token for authentication which can be generated from your Shopify app settings. Create a Shopify app and configure the required scopes. You can access your app settings and generate the token by visiting https://admin.shopify.com/store/<store-name>/settings/apps/development",
2702 - "required": true,
2703 - "default": null
2704 - }
2705 - ],
2706 - "optional": []
2707 - }
2708 - }
2709 - }
2710 - ]
326 + "category": "ecommerce",
327 + "toolCount": 404,
328 + "triggerCount": 0
329 },
330 {
331 "slug": "linkedin",
332 "name": "LinkedIn",
333 "logo": "https://logos.composio.dev/api/linkedin",
2716 - "description": "LinkedIn is a professional networking platform enabling job seekers, companies, and thought leaders to connect, share content, and discover business opportunities",
334 "category": "social media accounts",
2718 - "authSchemes": [
2719 - "OAUTH2"
2720 - ],
2721 - "toolCount": 4,
2722 - "triggerCount": 0,
2723 - "version": "20260211_00",
2724 - "authConfigDetails": [
2725 - {
2726 - "mode": "OAUTH2",
2727 - "name": "linkedin_oauth",
2728 - "fields": {
2729 - "auth_config_creation": {
2730 - "required": [
2731 - {
2732 - "name": "client_id",
2733 - "displayName": "Client id",
2734 - "type": "string",
2735 - "description": "Client id of the app",
2736 - "required": true,
2737 - "default": null
2738 - },
2739 - {
2740 - "name": "client_secret",
2741 - "displayName": "Client secret",
2742 - "type": "string",
2743 - "description": "Client secret of the app",
2744 - "required": true,
2745 - "default": null
2746 - }
2747 - ],
2748 - "optional": [
2749 - {
2750 - "name": "oauth_redirect_uri",
2751 - "displayName": "Redirect URI",
2752 - "type": "string",
2753 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2754 - "required": false,
2755 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2756 - },
2757 - {
2758 - "name": "scopes",
2759 - "displayName": "Scopes",
2760 - "type": "string",
2761 - "description": "Scopes to request from the user, comma separated",
2762 - "required": false,
2763 - "default": "openid,profile,w_member_social,email"
2764 - }
2765 - ]
2766 - },
2767 - "connected_account_initiation": {
2768 - "required": [],
2769 - "optional": []
2770 - }
2771 - }
2772 - }
2773 - ]
335 + "toolCount": 11,
336 + "triggerCount": 0
337 },
338 {
339 "slug": "google_maps",
340 "name": "Google Maps",
341 "logo": "https://logos.composio.dev/api/google_maps",
2779 - "description": "Integrate Google Maps to access location data, geocoding, directions, and mapping services in your application.",
342 "category": "developer tools",
2781 - "authSchemes": [
2782 - "OAUTH2",
2783 - "API_KEY"
2784 - ],
2785 - "toolCount": 7,
2786 - "triggerCount": 0,
2787 - "version": "20260211_00",
2788 - "authConfigDetails": [
2789 - {
2790 - "mode": "OAUTH2",
2791 - "name": "google_photos_oauth2",
2792 - "fields": {
2793 - "auth_config_creation": {
2794 - "required": [
2795 - {
2796 - "name": "client_id",
2797 - "displayName": "Client id",
2798 - "type": "string",
2799 - "description": "Client id of the app",
2800 - "required": true,
2801 - "default": null
2802 - },
2803 - {
2804 - "name": "client_secret",
2805 - "displayName": "Client secret",
2806 - "type": "string",
2807 - "description": "Client secret of the app",
2808 - "required": true,
2809 - "default": null
2810 - }
2811 - ],
2812 - "optional": [
2813 - {
2814 - "name": "oauth_redirect_uri",
2815 - "displayName": "Redirect URI",
2816 - "type": "string",
2817 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2818 - "required": false,
2819 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2820 - },
2821 - {
2822 - "name": "scopes",
2823 - "displayName": "Scopes",
2824 - "type": "string",
2825 - "description": "Scopes to request from the user, comma separated",
2826 - "required": false,
2827 - "default": "https://www.googleapis.com/auth/cloud-platform"
2828 - }
2829 - ]
2830 - },
2831 - "connected_account_initiation": {
2832 - "required": [],
2833 - "optional": []
2834 - }
2835 - }
2836 - },
2837 - {
2838 - "mode": "API_KEY",
2839 - "name": "API_KEY",
2840 - "fields": {
2841 - "auth_config_creation": {
2842 - "required": [],
2843 - "optional": []
2844 - },
2845 - "connected_account_initiation": {
2846 - "required": [
2847 - {
2848 - "name": "generic_api_key",
2849 - "displayName": "API Key",
2850 - "type": "string",
2851 - "description": "Your API key for authentication. Obtain it from your Google Maps API Console.",
2852 - "required": true,
2853 - "default": null
2854 - }
2855 - ],
2856 - "optional": []
2857 - }
2858 - }
2859 - }
2860 - ]
343 + "toolCount": 21,
344 + "triggerCount": 0
345 },
346 {
347 "slug": "one_drive",
348 "name": "OneDrive",
349 "logo": "https://logos.composio.dev/api/one_drive",
2866 - "description": "OneDrive is Microsoft’s cloud storage solution enabling users to store, sync, and share files across devices, offering offline access, real-time collaboration, and enterprise-grade security",
350 "category": "file management & storage",
2868 - "authSchemes": [
2869 - "OAUTH2"
2870 - ],
2871 - "toolCount": 35,
2872 - "triggerCount": 9,
2873 - "version": "20260211_00",
2874 - "authConfigDetails": [
2875 - {
2876 - "mode": "OAUTH2",
2877 - "name": "one-drive_oauth",
2878 - "fields": {
2879 - "auth_config_creation": {
2880 - "required": [
2881 - {
2882 - "name": "client_id",
2883 - "displayName": "Client id",
2884 - "type": "string",
2885 - "description": "Client id of the app",
2886 - "required": true,
2887 - "default": null
2888 - },
2889 - {
2890 - "name": "client_secret",
2891 - "displayName": "Client secret",
2892 - "type": "string",
2893 - "description": "Client secret of the app",
2894 - "required": true,
2895 - "default": null
2896 - }
2897 - ],
2898 - "optional": [
2899 - {
2900 - "name": "oauth_redirect_uri",
2901 - "displayName": "Redirect URI",
2902 - "type": "string",
2903 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2904 - "required": false,
2905 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2906 - },
2907 - {
2908 - "name": "scopes",
2909 - "displayName": "Scopes",
2910 - "type": "string",
2911 - "description": "Scopes to request from the user, comma separated",
2912 - "required": false,
2913 - "default": "Files.ReadWrite.All,Sites.Read.All,offline_access"
2914 - }
2915 - ]
2916 - },
2917 - "connected_account_initiation": {
2918 - "required": [],
2919 - "optional": []
2920 - }
2921 - }
2922 - }
2923 - ]
351 + "toolCount": 39,
352 + "triggerCount": 9
353 },
354 {
355 "slug": "docusign",
356 "name": "DocuSign",
357 "logo": "https://logos.composio.dev/api/docusign",
2929 - "description": "DocuSign provides eSignature and digital agreement solutions, enabling businesses to send, sign, track, and manage documents electronically",
358 "category": "signatures",
2931 - "authSchemes": [
2932 - "OAUTH2"
2933 - ],
359 "toolCount": 342,
2935 - "triggerCount": 0,
2936 - "version": "20260211_00",
2937 - "authConfigDetails": [
2938 - {
2939 - "mode": "OAUTH2",
2940 - "name": "DOCUSIGN_OAUTH2",
2941 - "fields": {
2942 - "auth_config_creation": {
2943 - "required": [
2944 - {
2945 - "name": "client_id",
2946 - "displayName": "Client id",
2947 - "type": "string",
2948 - "description": "Client id of the app",
2949 - "required": true,
2950 - "default": null
2951 - },
2952 - {
2953 - "name": "client_secret",
2954 - "displayName": "Client secret",
2955 - "type": "string",
2956 - "description": "Client secret of the app",
2957 - "required": true,
2958 - "default": null
2959 - },
2960 - {
2961 - "name": "full",
2962 - "displayName": "Authorization URL",
2963 - "type": "string",
2964 - "description": "The auth URL for the DocuSign API, e.g., 'https://account.docusign.com'",
2965 - "required": true,
2966 - "default": "https://account.docusign.com"
2967 - }
2968 - ],
2969 - "optional": [
2970 - {
2971 - "name": "oauth_redirect_uri",
2972 - "displayName": "Redirect URI",
2973 - "type": "string",
2974 - "description": "Add this Redirect URL to your app's OAuth allow list.",
2975 - "required": false,
2976 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
2977 - },
2978 - {
2979 - "name": "scopes",
2980 - "displayName": "Scopes",
2981 - "type": "string",
2982 - "description": "Scopes to request from the user, comma separated",
2983 - "required": false,
2984 - "default": "signature,impersonation"
2985 - }
2986 - ]
2987 - },
2988 - "connected_account_initiation": {
2989 - "required": [],
2990 - "optional": []
2991 - }
2992 - }
2993 - }
2994 - ]
360 + "triggerCount": 0
361 },
362 {
363 "slug": "discordbot",
364 "name": "Discord Bot",
365 "logo": "https://logos.composio.dev/api/discordbot",
3000 - "description": "Discordbot refers to automated programs on Discord servers, performing tasks like moderation, music playback, and user engagement to enhance community interactions",
366 "category": "team chat",
3002 - "authSchemes": [
3003 - "OAUTH2"
3004 - ],
3005 - "toolCount": 164,
3006 - "triggerCount": 0,
3007 - "version": "20260211_00",
3008 - "authConfigDetails": [
3009 - {
3010 - "mode": "OAUTH2",
3011 - "name": "discord_oauth",
3012 - "fields": {
3013 - "auth_config_creation": {
3014 - "required": [
3015 - {
3016 - "name": "client_id",
3017 - "displayName": "Client id",
3018 - "type": "string",
3019 - "description": "Client id of the app",
3020 - "required": true,
3021 - "default": null
3022 - },
3023 - {
3024 - "name": "client_secret",
3025 - "displayName": "Client secret",
3026 - "type": "string",
3027 - "description": "Client secret of the app",
3028 - "required": true,
3029 - "default": null
3030 - },
3031 - {
3032 - "name": "bearer_token",
3033 - "displayName": "Bot Token",
3034 - "type": "string",
3035 - "description": "Token for the discord bot.",
3036 - "required": true,
3037 - "default": null
3038 - },
3039 - {
3040 - "name": "generic_id",
3041 - "displayName": "Permission Integer",
3042 - "type": "string",
3043 - "description": "Permission Integer for the discord bot. Use https://discordapi.com/permissions.html#128 to find out the value.",
3044 - "required": true,
3045 - "default": "8"
3046 - }
3047 - ],
3048 - "optional": [
3049 - {
3050 - "name": "oauth_redirect_uri",
3051 - "displayName": "Redirect URI",
3052 - "type": "string",
3053 - "description": "Add this Redirect URL to your app's OAuth allow list.",
3054 - "required": false,
3055 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
3056 - },
3057 - {
3058 - "name": "scopes",
3059 - "displayName": "Scopes",
3060 - "type": "string",
3061 - "description": "Scopes to request from the user, comma separated",
3062 - "required": false,
3063 - "default": "identify,email,bot,messages.read"
3064 - }
3065 - ]
3066 - },
3067 - "connected_account_initiation": {
3068 - "required": [],
3069 - "optional": []
3070 - }
3071 - }
3072 - }
3073 - ]
367 + "toolCount": 165,
368 + "triggerCount": 0
369 },
370 {
371 "slug": "salesforce",
372 "name": "Salesforce",
373 "logo": "https://logos.composio.dev/api/salesforce",
3079 - "description": "Salesforce is a leading CRM platform integrating sales, service, marketing, and analytics to build customer relationships and drive business growth",
374 "category": "crm",
3081 - "authSchemes": [
3082 - "OAUTH2"
3083 - ],
3084 - "toolCount": 97,
3085 - "triggerCount": 7,
3086 - "version": "20260211_00",
3087 - "authConfigDetails": [
3088 - {
3089 - "mode": "OAUTH2",
3090 - "name": "salesforce_oauth2",
3091 - "fields": {
3092 - "auth_config_creation": {
3093 - "required": [
3094 - {
3095 - "name": "client_id",
3096 - "displayName": "Client id",
3097 - "type": "string",
3098 - "description": "Client id of the app",
3099 - "required": true,
3100 - "default": null
3101 - },
3102 - {
3103 - "name": "client_secret",
3104 - "displayName": "Client secret",
3105 - "type": "string",
3106 - "description": "Client secret of the app",
3107 - "required": true,
3108 - "default": null
3109 - }
3110 - ],
3111 - "optional": [
3112 - {
3113 - "name": "oauth_redirect_uri",
3114 - "displayName": "Redirect URI",
3115 - "type": "string",
3116 - "description": "Add this Redirect URL to your app's OAuth allow list.",
3117 - "required": false,
3118 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
3119 - },
3120 - {
3121 - "name": "scopes",
3122 - "displayName": "Scopes",
3123 - "type": "string",
3124 - "description": "Scopes to request from the user, comma separated",
3125 - "required": false,
3126 - "default": "full,refresh_token"
3127 - }
3128 - ]
3129 - },
3130 - "connected_account_initiation": {
3131 - "required": [
3132 - {
3133 - "name": "subdomain",
3134 - "displayName": "Salesforce Subdomain",
3135 - "type": "string",
3136 - "description": "Your Salesforce My Domain subdomain (e.g., 'your-company.my' in https://your-company.my.salesforce.com/...)",
3137 - "required": true,
3138 - "default": "login"
3139 - },
3140 - {
3141 - "name": "suffix.one",
3142 - "displayName": "Instance endpoint",
3143 - "type": "string",
3144 - "description": "The service endpoint for your Salesforce instance eg /services/data/v61.0, used for API requests.",
3145 - "required": true,
3146 - "default": "/services/data/v61.0"
3147 - }
3148 - ],
3149 - "optional": []
3150 - }
3151 - }
3152 - }
3153 - ]
375 + "toolCount": 241,
376 + "triggerCount": 7
377 },
378 {
379 "slug": "calendly",
380 "name": "Calendly",
381 "logo": "https://logos.composio.dev/api/calendly",
3159 - "description": "Calendly is an appointment scheduling tool that automates meeting invitations, availability checks, and reminders, helping individuals and teams avoid email back-and-forth",
382 "category": "scheduling & booking",
3161 - "authSchemes": [
3162 - "OAUTH2"
3163 - ],
3164 - "toolCount": 42,
3165 - "triggerCount": 0,
3166 - "version": "20260211_00",
3167 - "authConfigDetails": [
3168 - {
3169 - "mode": "OAUTH2",
3170 - "name": "calendly_oauth",
3171 - "fields": {
3172 - "auth_config_creation": {
3173 - "required": [
3174 - {
3175 - "name": "client_id",
3176 - "displayName": "Client id",
3177 - "type": "string",
3178 - "description": "Client id of the app",
3179 - "required": true,
3180 - "default": null
3181 - },
3182 - {
3183 - "name": "client_secret",
3184 - "displayName": "Client secret",
3185 - "type": "string",
3186 - "description": "Client secret of the app",
3187 - "required": true,
3188 - "default": null
3189 - }
3190 - ],
3191 - "optional": [
3192 - {
3193 - "name": "oauth_redirect_uri",
3194 - "displayName": "Redirect URI",
3195 - "type": "string",
3196 - "description": "Add this Redirect URL to your app's OAuth allow list.",
3197 - "required": false,
3198 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
3199 - },
3200 - {
3201 - "name": "scopes",
3202 - "displayName": "Scopes",
3203 - "type": "string",
3204 - "description": "Scopes to request from the user, comma separated",
3205 - "required": false,
3206 - "default": ""
3207 - }
3208 - ]
3209 - },
3210 - "connected_account_initiation": {
3211 - "required": [],
3212 - "optional": []
3213 - }
3214 - }
3215 - }
3216 - ]
383 + "toolCount": 63,
384 + "triggerCount": 0
385 },
386 {
387 "slug": "trello",
388 "name": "Trello",
389 "logo": "https://logos.composio.dev/api/trello",
3222 - "description": "A web-based, kanban-style, list-making application.",
3223 - "category": "productivity",
3224 - "authSchemes": [
3225 - "OAUTH1"
3226 - ],
3227 - "toolCount": 345,
3228 - "triggerCount": 5,
3229 - "version": "20260209_00",
3230 - "authConfigDetails": [
3231 - {
3232 - "mode": "OAUTH1",
3233 - "name": "trello_oauth",
3234 - "fields": {
3235 - "auth_config_creation": {
3236 - "required": [
3237 - {
3238 - "name": "consumer_key",
3239 - "displayName": "Consumer key",
3240 - "type": "string",
3241 - "description": "Consumer key of the app",
3242 - "required": true,
3243 - "default": null
3244 - },
3245 - {
3246 - "name": "consumer_secret",
3247 - "displayName": "Consumer secret",
3248 - "type": "string",
3249 - "description": "Consumer secret of the app",
3250 - "required": true,
3251 - "default": null
3252 - }
3253 - ],
3254 - "optional": [
3255 - {
3256 - "name": "scopes",
3257 - "displayName": "Scopes",
3258 - "type": "string",
3259 - "description": "Scopes to request from the user, comma separated",
3260 - "required": false,
3261 - "default": "read,write,account"
3262 - },
3263 - {
3264 - "name": "bearer_token",
3265 - "displayName": "Access Token",
3266 - "type": "string",
3267 - "description": "Access token injected automatically after OAuth2 authentication flow.",
3268 - "required": false,
3269 - "default": null
3270 - }
3271 - ]
3272 - },
3273 - "connected_account_initiation": {
3274 - "required": [],
3275 - "optional": []
3276 - }
3277 - }
3278 - }
3279 - ]
390 + "category": "project management",
391 + "toolCount": 323,
392 + "triggerCount": 5
393 },
394 {
395 "slug": "apollo",
396 "name": "Apollo",
397 "logo": "https://logos.composio.dev/api/apollo",
3285 - "description": "Apollo provides CRM and lead generation capabilities, helping businesses discover contacts, manage outreach, and track sales pipelines for consistent customer relationship development",
398 "category": "crm",
3287 - "authSchemes": [
3288 - "API_KEY"
3289 - ],
3290 - "toolCount": 31,
3291 - "triggerCount": 0,
3292 - "version": "20260211_00",
3293 - "authConfigDetails": [
3294 - {
3295 - "mode": "API_KEY",
3296 - "name": "apollo_api_key",
3297 - "fields": {
3298 - "auth_config_creation": {
3299 - "required": [],
3300 - "optional": []
3301 - },
3302 - "connected_account_initiation": {
3303 - "required": [
3304 - {
3305 - "name": "generic_api_key",
3306 - "displayName": "API Key",
3307 - "type": "string",
3308 - "description": "Your Apollo API key for authentication. Obtain it from your Apollo settings.",
3309 - "required": true,
3310 - "default": null
3311 - }
3312 - ],
3313 - "optional": []
3314 - }
3315 - }
3316 - }
3317 - ]
399 + "toolCount": 34,
400 + "triggerCount": 0
401 },
402 {
403 "slug": "semrush",
404 "name": "Semrush",
405 "logo": "https://logos.composio.dev/api/semrush",
3323 - "description": "Semrush is a popular SEO tool suite that specializes in keyword research, competitor analysis, and Google Ad campaign optimization.",
406 "category": "marketing",
3325 - "authSchemes": [
3326 - "API_KEY"
3327 - ],
3328 - "toolCount": 36,
3329 - "triggerCount": 0,
3330 - "version": "20260211_00",
3331 - "authConfigDetails": [
3332 - {
3333 - "mode": "API_KEY",
3334 - "name": "API_KEY",
3335 - "fields": {
3336 - "auth_config_creation": {
3337 - "required": [],
3338 - "optional": []
3339 - },
3340 - "connected_account_initiation": {
3341 - "required": [
3342 - {
3343 - "name": "generic_api_key",
3344 - "displayName": "API Key",
3345 - "type": "string",
3346 - "description": "API key for the Semrush API",
3347 - "required": true,
3348 - "default": null
3349 - }
3350 - ],
3351 - "optional": []
3352 - }
3353 - }
3354 - }
3355 - ]
407 + "toolCount": 37,
408 + "triggerCount": 0
409 },
410 {
411 "slug": "mem0",
412 "name": "Mem0",
413 "logo": "https://logos.composio.dev/api/mem0",
3361 - "description": "Mem0 is an universal, self-improving memory layer for LLM applications.",
414 "category": "artificial intelligence",
3363 - "authSchemes": [
3364 - "API_KEY"
3365 - ],
3366 - "toolCount": 43,
3367 - "triggerCount": 0,
3368 - "version": "20260211_00",
3369 - "authConfigDetails": [
3370 - {
3371 - "mode": "API_KEY",
3372 - "name": "mem0_api_key",
3373 - "fields": {
3374 - "auth_config_creation": {
3375 - "required": [],
3376 - "optional": []
3377 - },
3378 - "connected_account_initiation": {
3379 - "required": [
3380 - {
3381 - "name": "generic_api_key",
3382 - "displayName": "API Key",
3383 - "type": "string",
3384 - "description": "Your Mem0 API key for authentication. Obtain it from your Mem0 settings.",
3385 - "required": true,
3386 - "default": null
3387 - }
3388 - ],
3389 - "optional": []
3390 - }
3391 - }
3392 - }
3393 - ]
415 + "toolCount": 44,
416 + "triggerCount": 0
417 },
418 {
419 "slug": "neon",
420 "name": "Neon",
421 "logo": "https://logos.composio.dev/api/neon",
3399 - "description": "Postgres, on a serverless platform designed to help you build reliable and scalable applications faster",
422 "category": "databases",
3401 - "authSchemes": [
3402 - "API_KEY"
3403 - ],
423 "toolCount": 69,
3405 - "triggerCount": 0,
3406 - "version": "20260211_00",
3407 - "authConfigDetails": [
3408 - {
3409 - "mode": "API_KEY",
3410 - "name": "neon_api_key",
3411 - "fields": {
3412 - "auth_config_creation": {
3413 - "required": [],
3414 - "optional": []
3415 - },
3416 - "connected_account_initiation": {
3417 - "required": [
3418 - {
3419 - "name": "generic_api_key",
3420 - "displayName": "API Key",
3421 - "type": "string",
3422 - "description": "Your API key for authentication. Obtain it from your account settings.",
3423 - "required": true,
3424 - "default": null
3425 - }
3426 - ],
3427 - "optional": []
3428 - }
3429 - }
3430 - }
3431 - ]
424 + "triggerCount": 0
425 },
426 {
427 "slug": "weathermap",
428 "name": "OpenWeatherMap",
429 "logo": "https://logos.composio.dev/api/weathermap",
3437 - "description": "WeatherMap provides visual weather data, forecasts, and mappings, helping users understand climate patterns or track severe weather conditions",
3438 - "category": "other / miscellaneous",
3439 - "authSchemes": [
3440 - "NO_AUTH"
3441 - ],
3442 - "toolCount": 1,
3443 - "triggerCount": 0,
3444 - "version": "20260203_00",
3445 - "authConfigDetails": [
3446 - {
3447 - "mode": "NO_AUTH",
3448 - "name": "WeatherMap",
3449 - "fields": {
3450 - "auth_config_creation": {
3451 - "required": [],
3452 - "optional": []
3453 - },
3454 - "connected_account_initiation": {
3455 - "required": [],
3456 - "optional": []
3457 - }
3458 - }
3459 - }
3460 - ]
430 + "category": "developer tools",
431 + "toolCount": 2,
432 + "triggerCount": 0
433 },
434 {
435 "slug": "posthog",
436 "name": "PostHog",
437 "logo": "https://logos.composio.dev/api/posthog",
3466 - "description": "PostHog is an open-source product analytics platform tracking user interactions and behaviors to help teams refine features, improve funnels, and reduce churn",
438 "category": "analytics",
3468 - "authSchemes": [
3469 - "API_KEY"
3470 - ],
3471 - "toolCount": 358,
3472 - "triggerCount": 0,
3473 - "version": "20260211_00",
3474 - "authConfigDetails": [
3475 - {
3476 - "mode": "API_KEY",
3477 - "name": "posthog_apikey",
3478 - "fields": {
3479 - "auth_config_creation": {
3480 - "required": [
3481 - {
3482 - "name": "subdomain",
3483 - "displayName": "Sub Domain",
3484 - "type": "string",
3485 - "description": "The subdomain for your PostHog instance. US Cloud: \"us.i\" (public) or \"us\" (private). EU Cloud: \"eu.i\" (public) or \"eu\" (private). For self-hosted, use your custom subdomain. Confirm yours by checking your PostHog instance URL.",
3486 - "required": true,
3487 - "default": "us"
3488 - }
3489 - ],
3490 - "optional": []
3491 - },
3492 - "connected_account_initiation": {
3493 - "required": [
3494 - {
3495 - "name": "generic_api_key",
3496 - "displayName": "API Key",
3497 - "type": "string",
3498 - "description": "You can find your API key in your project settings.",
3499 - "required": true,
3500 - "default": null
3501 - }
3502 - ],
3503 - "optional": []
3504 - }
3505 - }
3506 - }
3507 - ]
439 + "toolCount": 303,
440 + "triggerCount": 0
441 },
442 {
443 "slug": "clickup",
444 "name": "ClickUp",
445 "logo": "https://logos.composio.dev/api/clickup",
3513 - "description": "ClickUp unifies tasks, docs, goals, and chat in a single platform, allowing teams to plan, organize, and collaborate across projects with customizable workflows",
446 "category": "productivity",
3515 - "authSchemes": [
3516 - "OAUTH2",
3517 - "API_KEY"
3518 - ],
3519 - "toolCount": 144,
3520 - "triggerCount": 0,
3521 - "version": "20260211_00",
3522 - "authConfigDetails": [
3523 - {
3524 - "mode": "OAUTH2",
3525 - "name": "clickup_oauth",
3526 - "fields": {
3527 - "auth_config_creation": {
3528 - "required": [
3529 - {
3530 - "name": "client_id",
3531 - "displayName": "Client id",
3532 - "type": "string",
3533 - "description": "Client id of the app",
3534 - "required": true,
3535 - "default": null
3536 - },
3537 - {
3538 - "name": "client_secret",
3539 - "displayName": "Client secret",
3540 - "type": "string",
3541 - "description": "Client secret of the app",
3542 - "required": true,
3543 - "default": null
3544 - }
3545 - ],
3546 - "optional": [
3547 - {
3548 - "name": "oauth_redirect_uri",
3549 - "displayName": "Redirect URI",
3550 - "type": "string",
3551 - "description": "Add this Redirect URL to your app's OAuth allow list.",
3552 - "required": false,
3553 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
3554 - },
3555 - {
3556 - "name": "scopes",
3557 - "displayName": "Scopes",
3558 - "type": "string",
3559 - "description": "Scopes to request from the user, comma separated",
3560 - "required": false,
3561 - "default": ""
3562 - }
3563 - ]
3564 - },
3565 - "connected_account_initiation": {
3566 - "required": [],
3567 - "optional": []
3568 - }
3569 - }
3570 - },
3571 - {
3572 - "mode": "API_KEY",
3573 - "name": "API_KEY",
3574 - "fields": {
3575 - "auth_config_creation": {
3576 - "required": [],
3577 - "optional": []
3578 - },
3579 - "connected_account_initiation": {
3580 - "required": [
3581 - {
3582 - "name": "generic_api_key",
3583 - "displayName": "API Key",
3584 - "type": "string",
3585 - "description": "Your api key is obtained from Clickup Settings",
3586 - "required": true,
3587 - "default": null
3588 - }
3589 - ],
3590 - "optional": []
3591 - }
3592 - }
3593 - }
3594 - ]
447 + "toolCount": 132,
448 + "triggerCount": 0
449 },
450 {
451 "slug": "brevo",
452 "name": "Brevo",
453 "logo": "https://logos.composio.dev/api/brevo",
3600 - "description": "Brevo (formerly Sendinblue) is an all-in-one email and SMS marketing platform that provides transactional messaging, marketing automation, contact management, and CRM tools to help businesses communicate and engage with their customers.",
454 "category": "email newsletters",
3602 - "authSchemes": [
3603 - "API_KEY",
3604 - "OAUTH2"
3605 - ],
3606 - "toolCount": 19,
3607 - "triggerCount": 0,
3608 - "version": "20260211_00",
3609 - "authConfigDetails": [
3610 - {
3611 - "mode": "OAUTH2",
3612 - "name": "brevo_oauth2",
3613 - "fields": {
3614 - "auth_config_creation": {
3615 - "required": [
3616 - {
3617 - "name": "client_id",
3618 - "displayName": "Client id",
3619 - "type": "string",
3620 - "description": "Client id of the app",
3621 - "required": true,
3622 - "default": null
3623 - },
3624 - {
3625 - "name": "client_secret",
3626 - "displayName": "Client secret",
3627 - "type": "string",
3628 - "description": "Client secret of the app",
3629 - "required": true,
3630 - "default": null
3631 - }
3632 - ],
3633 - "optional": [
3634 - {
3635 - "name": "oauth_redirect_uri",
3636 - "displayName": "Redirect URI",
3637 - "type": "string",
3638 - "description": "Add this Redirect URL to your app's OAuth allow list.",
3639 - "required": false,
3640 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
3641 - },
3642 - {
3643 - "name": "scopes",
3644 - "displayName": "Scopes",
3645 - "type": "string",
3646 - "description": "Scopes to request from the user, comma separated",
3647 - "required": false,
3648 - "default": ""
3649 - }
3650 - ]
3651 - },
3652 - "connected_account_initiation": {
3653 - "required": [],
3654 - "optional": []
3655 - }
3656 - }
3657 - },
3658 - {
3659 - "mode": "API_KEY",
3660 - "name": "brevo_api_key",
3661 - "fields": {
3662 - "auth_config_creation": {
3663 - "required": [],
3664 - "optional": []
3665 - },
3666 - "connected_account_initiation": {
3667 - "required": [
3668 - {
3669 - "name": "generic_api_key",
3670 - "displayName": "Brevo API Key",
3671 - "type": "string",
3672 - "description": "Your Brevo API Key, available in your Brevo (formerly Sendinblue) account settings.",
3673 - "required": true,
3674 - "default": null
3675 - }
3676 - ],
3677 - "optional": []
3678 - }
3679 - }
3680 - }
3681 - ]
455 + "toolCount": 22,
456 + "triggerCount": 0
457 },
458 {
459 "slug": "stripe",
460 "name": "Stripe",
461 "logo": "https://logos.composio.dev/api/stripe",
3687 - "description": "Stripe offers online payment infrastructure, fraud prevention, and APIs enabling businesses to accept and manage payments globally",
3688 - "category": "finance & accounting",
3689 - "authSchemes": [
3690 - "API_KEY",
3691 - "OAUTH2"
3692 - ],
3693 - "toolCount": 33,
3694 - "triggerCount": 7,
3695 - "version": "20260203_00",
3696 - "authConfigDetails": [
3697 - {
3698 - "mode": "OAUTH2",
3699 - "name": "stripe_oauth2",
3700 - "fields": {
3701 - "auth_config_creation": {
3702 - "required": [
3703 - {
3704 - "name": "client_id",
3705 - "displayName": "Client id",
3706 - "type": "string",
3707 - "description": "Client id of the app",
3708 - "required": true,
3709 - "default": null
3710 - },
3711 - {
3712 - "name": "client_secret",
3713 - "displayName": "Client secret",
3714 - "type": "string",
3715 - "description": "Client secret of the app",
3716 - "required": true,
3717 - "default": null
3718 - }
3719 - ],
3720 - "optional": [
3721 - {
3722 - "name": "oauth_redirect_uri",
3723 - "displayName": "Redirect URI",
3724 - "type": "string",
3725 - "description": "Add this Redirect URL to your app's OAuth allow list.",
3726 - "required": false,
3727 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
3728 - },
3729 - {
3730 - "name": "scopes",
3731 - "displayName": "Scopes",
3732 - "type": "string",
3733 - "description": "Scopes to request from the user, comma separated",
3734 - "required": false,
3735 - "default": "read_write"
3736 - }
3737 - ]
3738 - },
3739 - "connected_account_initiation": {
3740 - "required": [],
3741 - "optional": []
3742 - }
3743 - }
3744 - },
3745 - {
3746 - "mode": "API_KEY",
3747 - "name": "stripe_api_key",
3748 - "fields": {
3749 - "auth_config_creation": {
3750 - "required": [],
3751 - "optional": []
3752 - },
3753 - "connected_account_initiation": {
3754 - "required": [
3755 - {
3756 - "name": "generic_api_key",
3757 - "displayName": "API Key",
3758 - "type": "string",
3759 - "description": "Your Stripe API key for authentication. Obtain it from your Stripe Dashboard under Developers > API Keys.",
3760 - "required": true,
3761 - "default": null
3762 - }
3763 - ],
3764 - "optional": []
3765 - }
3766 - }
3767 - }
3768 - ]
462 + "category": "payment processing",
463 + "toolCount": 624,
464 + "triggerCount": 7
465 },
466 {
467 "slug": "klaviyo",
468 "name": "Klaviyo",
469 "logo": "https://logos.composio.dev/api/klaviyo",
3774 - "description": "Klaviyo is a data-driven email and SMS marketing platform that allows e-commerce brands to deliver targeted messages, track conversions, and scale customer relationships",
470 "category": "marketing automation",
3776 - "authSchemes": [
3777 - "API_KEY",
3778 - "OAUTH2"
3779 - ],
471 "toolCount": 231,
3781 - "triggerCount": 0,
3782 - "version": "20260211_00",
3783 - "authConfigDetails": [
3784 - {
3785 - "mode": "OAUTH2",
3786 - "name": "klaviyo_oauth",
3787 - "fields": {
3788 - "auth_config_creation": {
3789 - "required": [
3790 - {
3791 - "name": "client_id",
3792 - "displayName": "Client id",
3793 - "type": "string",
3794 - "description": "Client id of the app",
3795 - "required": true,
3796 - "default": null
3797 - },
3798 - {
3799 - "name": "client_secret",
3800 - "displayName": "Client secret",
3801 - "type": "string",
3802 - "description": "Client secret of the app",
3803 - "required": true,
3804 - "default": null
3805 - }
3806 - ],
3807 - "optional": [
3808 - {
3809 - "name": "oauth_redirect_uri",
3810 - "displayName": "Redirect URI",
3811 - "type": "string",
3812 - "description": "Add this Redirect URL to your app's OAuth allow list.",
3813 - "required": false,
3814 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
3815 - },
3816 - {
3817 - "name": "scopes",
3818 - "displayName": "Scopes",
3819 - "type": "string",
3820 - "description": "Scopes to request from the user, comma separated",
3821 - "required": false,
3822 - "default": "accounts:read,campaigns:read,campaigns:write,conversations:read,conversations:write,catalogs:read,catalogs:write,coupons:read,coupons:write,coupon-codes:read,coupon-codes:write,data-privacy:read,data-privacy:write,events:read,events:write,flows:read,flows:write,images:read,images:write,lists:read,lists:write,metrics:read,metrics:write,profiles:read,profiles:write,push-tokens:read,push-tokens:write,segments:read,segments:write,subscriptions:read,subscriptions:write,tags:read,tags:write,templates:read,templates:write"
3823 - }
3824 - ]
3825 - },
3826 - "connected_account_initiation": {
3827 - "required": [],
3828 - "optional": []
3829 - }
3830 - }
3831 - },
3832 - {
3833 - "mode": "API_KEY",
3834 - "name": "API_KEY",
3835 - "fields": {
3836 - "auth_config_creation": {
3837 - "required": [],
3838 - "optional": []
3839 - },
3840 - "connected_account_initiation": {
3841 - "required": [
3842 - {
3843 - "name": "generic_api_key",
3844 - "displayName": "API Key",
3845 - "type": "string",
3846 - "description": "Your API key for authentication. Obtain it from your Klaviyo settings.",
3847 - "required": true,
3848 - "default": null
3849 - }
3850 - ],
3851 - "optional": []
3852 - }
3853 - }
3854 - }
3855 - ]
472 + "triggerCount": 0
473 },
474 {
475 "slug": "browserbase_tool",
476 "name": "Browserbase",
477 "logo": "https://logos.composio.dev/api/browserbase_tool",
3861 - "description": "Browserbase is a serverless platform that enables developers to run, manage, and monitor headless browsers at scale, offering seamless integration with tools like Playwright, Puppeteer, and Selenium.",
478 "category": "developer tools",
3863 - "authSchemes": [
3864 - "API_KEY"
3865 - ],
479 "toolCount": 10,
3867 - "triggerCount": 0,
3868 - "version": "20260211_00",
3869 - "authConfigDetails": [
3870 - {
3871 - "mode": "API_KEY",
3872 - "name": "browserbase_api_key",
3873 - "fields": {
3874 - "auth_config_creation": {
3875 - "required": [],
3876 - "optional": []
3877 - },
3878 - "connected_account_initiation": {
3879 - "required": [
3880 - {
3881 - "name": "generic_api_key",
3882 - "displayName": "Browserbase API Key",
3883 - "type": "string",
3884 - "description": "Your Browserbase API key",
3885 - "required": true,
3886 - "default": null
3887 - }
3888 - ],
3889 - "optional": []
3890 - }
3891 - }
3892 - }
3893 - ]
480 + "triggerCount": 0
481 },
482 {
483 "slug": "mailchimp",
484 "name": "Mailchimp",
485 "logo": "https://logos.composio.dev/api/mailchimp",
3899 - "description": "Mailchimp is an email marketing and automation platform providing campaign templates, audience segmentation, and performance analytics to drive engagement and conversions",
486 "category": "email newsletters",
3901 - "authSchemes": [
3902 - "OAUTH2"
3903 - ],
487 "toolCount": 271,
3905 - "triggerCount": 4,
3906 - "version": "20260211_00",
3907 - "authConfigDetails": [
3908 - {
3909 - "mode": "OAUTH2",
3910 - "name": "mailchimp_oauth",
3911 - "fields": {
3912 - "auth_config_creation": {
3913 - "required": [
3914 - {
3915 - "name": "client_id",
3916 - "displayName": "Client id",
3917 - "type": "string",
3918 - "description": "Client id of the app",
3919 - "required": true,
3920 - "default": null
3921 - },
3922 - {
3923 - "name": "client_secret",
3924 - "displayName": "Client secret",
3925 - "type": "string",
3926 - "description": "Client secret of the app",
3927 - "required": true,
3928 - "default": null
3929 - }
3930 - ],
3931 - "optional": [
3932 - {
3933 - "name": "oauth_redirect_uri",
3934 - "displayName": "Redirect URI",
3935 - "type": "string",
3936 - "description": "Add this Redirect URL to your app's OAuth allow list.",
3937 - "required": false,
3938 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
3939 - },
3940 - {
3941 - "name": "scopes",
3942 - "displayName": "Scopes",
3943 - "type": "string",
3944 - "description": "Scopes to request from the user, comma separated",
3945 - "required": false,
3946 - "default": ""
3947 - }
3948 - ]
3949 - },
3950 - "connected_account_initiation": {
3951 - "required": [
3952 - {
3953 - "name": "subdomain",
3954 - "displayName": "Server Prefix",
3955 - "type": "string",
3956 - "description": "Your Mailchimp server prefix (e.g., us19, us21). This is the part of your Mailchimp URL before '.admin.mailchimp.com'. For instance, if your Mailchimp URL is https://us19.admin.mailchimp.com/, then your server prefix is 'us19'.",
3957 - "required": true,
3958 - "default": "us21"
3959 - }
3960 - ],
3961 - "optional": []
3962 - }
3963 - }
3964 - }
3965 - ]
488 + "triggerCount": 4
489 },
490 {
491 "slug": "attio",
492 "name": "Attio",
493 "logo": "https://logos.composio.dev/api/attio",
3971 - "description": "Attio is a fully customizable workspace for your team's relationships and workflows.",
494 "category": "crm",
3973 - "authSchemes": [
3974 - "OAUTH2"
3975 - ],
3976 - "toolCount": 11,
3977 - "triggerCount": 0,
3978 - "version": "20260211_00",
3979 - "authConfigDetails": [
3980 - {
3981 - "mode": "OAUTH2",
3982 - "name": "attio_oauth",
3983 - "fields": {
3984 - "auth_config_creation": {
3985 - "required": [
3986 - {
3987 - "name": "client_id",
3988 - "displayName": "Client id",
3989 - "type": "string",
3990 - "description": "Client id of the app",
3991 - "required": true,
3992 - "default": null
3993 - },
3994 - {
3995 - "name": "client_secret",
3996 - "displayName": "Client secret",
3997 - "type": "string",
3998 - "description": "Client secret of the app",
3999 - "required": true,
4000 - "default": null
4001 - }
4002 - ],
4003 - "optional": [
4004 - {
4005 - "name": "oauth_redirect_uri",
4006 - "displayName": "Redirect URI",
4007 - "type": "string",
4008 - "description": "Add this Redirect URL to your app's OAuth allow list.",
4009 - "required": false,
4010 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
4011 - },
4012 - {
4013 - "name": "scopes",
4014 - "displayName": "Scopes",
4015 - "type": "string",
4016 - "description": "Scopes to request from the user, comma separated",
4017 - "required": false,
4018 - "default": "task:read-write,object_configuration:read,record_permission:read,user_management:read,list_configuration:read,list_entry:read,comment:read-write"
4019 - }
4020 - ]
4021 - },
4022 - "connected_account_initiation": {
4023 - "required": [],
4024 - "optional": []
4025 - }
4026 - }
4027 - }
4028 - ]
495 + "toolCount": 95,
496 + "triggerCount": 0
497 },
498 {
499 "slug": "googlemeet",
500 "name": "Google Meet",
501 "logo": "https://logos.composio.dev/api/googlemeet",
4034 - "description": "Google Meet is a secure video conferencing platform that integrates with Google Workspace, facilitating remote meetings, screen sharing, and chat",
502 "category": "video conferencing",
4036 - "authSchemes": [
4037 - "OAUTH2"
4038 - ],
4039 - "toolCount": 9,
4040 - "triggerCount": 0,
4041 - "version": "20260211_00",
4042 - "authConfigDetails": [
4043 - {
4044 - "mode": "OAUTH2",
4045 - "name": "googler-meet",
4046 - "fields": {
4047 - "auth_config_creation": {
4048 - "required": [
4049 - {
4050 - "name": "client_id",
4051 - "displayName": "Client id",
4052 - "type": "string",
4053 - "description": "Client id of the app",
4054 - "required": true,
4055 - "default": null
4056 - },
4057 - {
4058 - "name": "client_secret",
4059 - "displayName": "Client secret",
4060 - "type": "string",
4061 - "description": "Client secret of the app",
4062 - "required": true,
4063 - "default": null
4064 - }
4065 - ],
4066 - "optional": [
4067 - {
4068 - "name": "oauth_redirect_uri",
4069 - "displayName": "Redirect URI",
4070 - "type": "string",
4071 - "description": "Add this Redirect URL to your app's OAuth allow list.",
4072 - "required": false,
4073 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
4074 - },
4075 - {
4076 - "name": "scopes",
4077 - "displayName": "Scopes",
4078 - "type": "string",
4079 - "description": "Scopes to request from the user, comma separated",
4080 - "required": false,
4081 - "default": "https://www.googleapis.com/auth/meetings.space.created,https://www.googleapis.com/auth/meetings.space.settings"
4082 - }
4083 - ]
4084 - },
4085 - "connected_account_initiation": {
4086 - "required": [],
4087 - "optional": []
4088 - }
4089 - }
4090 - }
4091 - ]
503 + "toolCount": 12,
504 + "triggerCount": 0
505 },
506 {
507 "slug": "text_to_pdf",
508 "name": "Text to PDF",
509 "logo": "https://logos.composio.dev/api/text_to_pdf",
4097 - "description": "Convert text to PDF",
4098 - "category": "ai & machine learning",
4099 - "authSchemes": [
4100 - "NO_AUTH"
4101 - ],
510 + "category": "documents",
511 "toolCount": 1,
4103 - "triggerCount": 0,
4104 - "version": "20260204_00",
4105 - "authConfigDetails": [
4106 - {
4107 - "mode": "NO_AUTH",
4108 - "name": "texttopdf",
4109 - "fields": {
4110 - "auth_config_creation": {
4111 - "required": [],
4112 - "optional": []
4113 - },
4114 - "connected_account_initiation": {
4115 - "required": [],
4116 - "optional": []
4117 - }
4118 - }
4119 - }
4120 - ]
512 + "triggerCount": 0
513 },
514 {
515 "slug": "zoho",
516 "name": "Zoho",
517 "logo": "https://logos.composio.dev/api/zoho",
4126 - "description": "Zoho is a suite of cloud applications including CRM, email marketing, and collaboration tools, enabling businesses to automate and scale operations",
518 "category": "crm",
4128 - "authSchemes": [
4129 - "OAUTH2"
4130 - ],
4131 - "toolCount": 6,
4132 - "triggerCount": 0,
4133 - "version": "20260209_00",
4134 - "authConfigDetails": [
4135 - {
4136 - "mode": "OAUTH2",
4137 - "name": "zoho_oauth2",
4138 - "fields": {
4139 - "auth_config_creation": {
4140 - "required": [
4141 - {
4142 - "name": "client_id",
4143 - "displayName": "Client id",
4144 - "type": "string",
4145 - "description": "Client id of the app",
4146 - "required": true,
4147 - "default": null
4148 - },
4149 - {
4150 - "name": "client_secret",
4151 - "displayName": "Client secret",
4152 - "type": "string",
4153 - "description": "Client secret of the app",
4154 - "required": true,
4155 - "default": null
4156 - }
4157 - ],
4158 - "optional": [
4159 - {
4160 - "name": "oauth_redirect_uri",
4161 - "displayName": "Redirect URI",
4162 - "type": "string",
4163 - "description": "Add this Redirect URL to your app's OAuth allow list.",
4164 - "required": false,
4165 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
4166 - },
4167 - {
4168 - "name": "scopes",
4169 - "displayName": "Scopes",
4170 - "type": "string",
4171 - "description": "Scopes to request from the user, comma separated",
4172 - "required": false,
4173 - "default": "ZohoCRM.modules.ALL,ZohoCRM.settings.ALL,ZohoCRM.notifications.ALL,ZohoCRM.users.ALL"
4174 - }
4175 - ]
4176 - },
4177 - "connected_account_initiation": {
4178 - "required": [
4179 - {
4180 - "name": "region",
4181 - "displayName": "Region",
4182 - "type": "string",
4183 - "description": "The Zoho domain region (e.g., com, eu, in, au, jp, ca, cn, sa).",
4184 - "required": true,
4185 - "default": "com"
4186 - }
4187 - ],
4188 - "optional": []
4189 - }
4190 - }
4191 - }
4192 - ]
519 + "toolCount": 12,
520 + "triggerCount": 0
521 },
522 {
523 "slug": "fireflies",
524 "name": "Fireflies",
525 "logo": "https://logos.composio.dev/api/fireflies",
4198 - "description": "Fireflies.ai helps your team transcribe, summarize, search, and analyze voice conversations.",
526 "category": "ai meeting assistants",
4200 - "authSchemes": [
4201 - "API_KEY"
4202 - ],
4203 - "toolCount": 10,
4204 - "triggerCount": 1,
4205 - "version": "20260211_00",
4206 - "authConfigDetails": [
4207 - {
4208 - "mode": "API_KEY",
4209 - "name": "fireflies_api_key",
4210 - "fields": {
4211 - "auth_config_creation": {
4212 - "required": [],
4213 - "optional": []
4214 - },
4215 - "connected_account_initiation": {
4216 - "required": [
4217 - {
4218 - "name": "generic_api_key",
4219 - "displayName": "API Key",
4220 - "type": "string",
4221 - "description": "Your Fireflies API key for authentication. Obtain it from your Fireflies settings.",
4222 - "required": true,
4223 - "default": null
4224 - }
4225 - ],
4226 - "optional": []
4227 - }
4228 - }
4229 - }
4230 - ]
527 + "toolCount": 21,
528 + "triggerCount": 1
529 },
530 {
531 "slug": "dropbox",
532 "name": "Dropbox",
533 "logo": "https://logos.composio.dev/api/dropbox",
4236 - "description": "Dropbox is a cloud storage service offering file syncing, sharing, and collaboration across devices with version control and robust integrations",
534 "category": "file management & storage",
4238 - "authSchemes": [
4239 - "OAUTH2"
4240 - ],
4241 - "toolCount": 11,
4242 - "triggerCount": 0,
4243 - "version": "20260211_00",
4244 - "authConfigDetails": [
4245 - {
4246 - "mode": "OAUTH2",
4247 - "name": "dropbox_oauth",
4248 - "fields": {
4249 - "auth_config_creation": {
4250 - "required": [
4251 - {
4252 - "name": "client_id",
4253 - "displayName": "Client id",
4254 - "type": "string",
4255 - "description": "Client id of the app",
4256 - "required": true,
4257 - "default": null
4258 - },
4259 - {
4260 - "name": "client_secret",
4261 - "displayName": "Client secret",
4262 - "type": "string",
4263 - "description": "Client secret of the app",
4264 - "required": true,
4265 - "default": null
4266 - }
4267 - ],
4268 - "optional": [
4269 - {
4270 - "name": "oauth_redirect_uri",
4271 - "displayName": "Redirect URI",
4272 - "type": "string",
4273 - "description": "Add this Redirect URL to your app's OAuth allow list.",
4274 - "required": false,
4275 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
4276 - },
4277 - {
4278 - "name": "scopes",
4279 - "displayName": "Scopes",
4280 - "type": "string",
4281 - "description": "Scopes to request from the user, comma separated",
4282 - "required": false,
4283 - "default": "email,profile,account_info.write,account_info.read,files.metadata.write,files.metadata.read,files.content.write,files.content.read,openid,file_requests.write,file_requests.read,sharing.write,sharing.read,contacts.write,contacts.read"
4284 - }
4285 - ]
4286 - },
4287 - "connected_account_initiation": {
4288 - "required": [],
4289 - "optional": []
4290 - }
4291 - }
4292 - }
4293 - ]
535 + "toolCount": 107,
536 + "triggerCount": 0
537 },
538 {
539 "slug": "shortcut",
540 "name": "Shortcut",
541 "logo": "https://logos.composio.dev/api/shortcut",
4299 - "description": "Shortcut aligns product development work with company objectives so teams can execute with a shared purpose.",
4300 - "category": "productivity & project management",
4301 - "authSchemes": [
4302 - "API_KEY"
4303 - ],
542 + "category": "project management",
543 "toolCount": 122,
4305 - "triggerCount": 0,
4306 - "version": "20260209_00",
4307 - "authConfigDetails": [
4308 - {
4309 - "mode": "API_KEY",
4310 - "name": "shortcut_api_key",
4311 - "fields": {
4312 - "auth_config_creation": {
4313 - "required": [],
4314 - "optional": []
4315 - },
4316 - "connected_account_initiation": {
4317 - "required": [
4318 - {
4319 - "name": "generic_api_key",
4320 - "displayName": "API Token",
4321 - "type": "string",
4322 - "description": "Your Shortcut API token for authentication.",
4323 - "required": true,
4324 - "default": null
4325 - }
4326 - ],
4327 - "optional": []
4328 - }
4329 - }
4330 - }
4331 - ]
544 + "triggerCount": 0
545 },
546 {
547 "slug": "confluence",
548 "name": "Confluence",
549 "logo": "https://logos.composio.dev/api/confluence",
4337 - "description": "A tool for team collaboration and knowledge management.",
550 "category": "team collaboration",
4339 - "authSchemes": [
4340 - "OAUTH2"
4341 - ],
4342 - "toolCount": 57,
4343 - "triggerCount": 0,
4344 - "version": "20260211_00",
4345 - "authConfigDetails": [
4346 - {
4347 - "mode": "OAUTH2",
4348 - "name": "confluence_oauth",
4349 - "fields": {
4350 - "auth_config_creation": {
4351 - "required": [
4352 - {
4353 - "name": "client_id",
4354 - "displayName": "Client id",
4355 - "type": "string",
4356 - "description": "Client id of the app",
4357 - "required": true,
4358 - "default": null
4359 - },
4360 - {
4361 - "name": "client_secret",
4362 - "displayName": "Client secret",
4363 - "type": "string",
4364 - "description": "Client secret of the app",
4365 - "required": true,
4366 - "default": null
4367 - }
4368 - ],
4369 - "optional": [
4370 - {
4371 - "name": "oauth_redirect_uri",
4372 - "displayName": "Redirect URI",
4373 - "type": "string",
4374 - "description": "Add this Redirect URL to your app's OAuth allow list.",
4375 - "required": false,
4376 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
4377 - },
4378 - {
4379 - "name": "scopes",
4380 - "displayName": "Scopes",
4381 - "type": "string",
4382 - "description": "Scopes to request from the user, comma separated",
4383 - "required": false,
4384 - "default": "read:content:confluence,read:content-details:confluence,write:content:confluence,delete:content:confluence,read:space-details:confluence,read:analytics.content:confluence,read:audit-log:confluence,write:audit-log:confluence,read:configuration:confluence,write:configuration:confluence,read:page:confluence,write:page:confluence,delete:page:confluence,read:blogpost:confluence,write:blogpost:confluence,delete:blogpost:confluence,read:whiteboard:confluence,write:whiteboard:confluence,delete:whiteboard:confluence,read:database:confluence,write:database:confluence,delete:database:confluence,read:embed:confluence,write:embed:confluence,delete:embed:confluence,read:folder:confluence,write:folder:confluence,delete:folder:confluence,read:custom-content:confluence,write:custom-content:confluence,delete:custom-content:confluence,read:attachment:confluence,write:attachment:confluence,delete:attachment:confluence,read:comment:confluence,write:comment:confluence,delete:comment:confluence,read:template:confluence,write:template:confluence,read:label:confluence,write:label:confluence,read:content.permission:confluence,read:content.property:confluence,write:content.property:confluence,read:content.restriction:confluence,write:content.restriction:confluence,read:content.metadata:confluence,read:watcher:confluence,write:watcher:confluence,read:group:confluence,write:group:confluence,read:inlinetask:confluence,write:inlinetask:confluence,read:relation:confluence,write:relation:confluence,read:space:confluence,write:space:confluence,delete:space:confluence,read:space.permission:confluence,write:space.permission:confluence,read:space.property:confluence,write:space.property:confluence,read:user.property:confluence,write:user.property:confluence,read:space.setting:confluence,write:space.setting:confluence,read:user:confluence,read:task:confluence,write:task:confluence,offline_access"
4385 - }
4386 - ]
4387 - },
4388 - "connected_account_initiation": {
4389 - "required": [
4390 - {
4391 - "name": "subdomain",
4392 - "displayName": "Your Subdomain",
4393 - "type": "string",
4394 - "description": "example: 'your-subdomain' for 'your-subdomain.atlassian.net'",
4395 - "required": true,
4396 - "default": null
4397 - }
4398 - ],
4399 - "optional": []
4400 - }
4401 - }
4402 - }
4403 - ]
551 + "toolCount": 62,
552 + "triggerCount": 0
553 },
554 {
555 "slug": "freshdesk",
556 "name": "Freshdesk",
557 "logo": "https://logos.composio.dev/api/freshdesk",
4409 - "description": "Freshdesk provides customer support software with ticketing, knowledge base, and automation features for efficient helpdesk operations and better customer experiences",
558 "category": "crm",
4411 - "authSchemes": [
4412 - "API_KEY"
4413 - ],
4414 - "toolCount": 7,
4415 - "triggerCount": 0,
4416 - "version": "20260211_00",
4417 - "authConfigDetails": [
4418 - {
4419 - "mode": "API_KEY",
4420 - "name": "freshdesk_api_key",
4421 - "fields": {
4422 - "auth_config_creation": {
4423 - "required": [],
4424 - "optional": []
4425 - },
4426 - "connected_account_initiation": {
4427 - "required": [
4428 - {
4429 - "name": "subdomain",
4430 - "displayName": "Freshdesk Account Subdomain",
4431 - "type": "string",
4432 - "description": "Your Freshdesk account subdomain, derived from your Freshdesk account URL. For example, if your Freshdesk account URL is 'https://your-company.freshdesk.com', then the subdomain is 'your-company'.",
4433 - "required": true,
4434 - "default": null
4435 - },
4436 - {
4437 - "name": "generic_api_key",
4438 - "displayName": "API Key",
4439 - "type": "string",
4440 - "description": "API Key for authentication",
4441 - "required": true,
4442 - "default": null
4443 - }
4444 - ],
4445 - "optional": []
4446 - }
4447 - }
4448 - }
4449 - ]
559 + "toolCount": 204,
560 + "triggerCount": 0
561 },
562 {
563 "slug": "borneo",
564 "name": "Borneo",
565 "logo": "https://logos.composio.dev/api/borneo",
4455 - "description": "Borneo is a data security and privacy platform designed for sensitive data discovery and remediation.",
566 "category": "security & identity tools",
4457 - "authSchemes": [
4458 - "API_KEY",
4459 - "OAUTH2"
4460 - ],
567 "toolCount": 153,
4462 - "triggerCount": 0,
4463 - "version": "20260211_00",
4464 - "authConfigDetails": [
4465 - {
4466 - "mode": "OAUTH2",
4467 - "name": "borneo_oauth",
4468 - "fields": {
4469 - "auth_config_creation": {
4470 - "required": [
4471 - {
4472 - "name": "client_id",
4473 - "displayName": "Client id",
4474 - "type": "string",
4475 - "description": "Client id of the app",
4476 - "required": true,
4477 - "default": null
4478 - },
4479 - {
4480 - "name": "client_secret",
4481 - "displayName": "Client secret",
4482 - "type": "string",
4483 - "description": "Client secret of the app",
4484 - "required": true,
4485 - "default": null
4486 - }
4487 - ],
4488 - "optional": [
4489 - {
4490 - "name": "oauth_redirect_uri",
4491 - "displayName": "Redirect URI",
4492 - "type": "string",
4493 - "description": "Add this Redirect URL to your app's OAuth allow list.",
4494 - "required": false,
4495 - "default": "https://backend.composio.dev/api/v1/auth-apps/add"
4496 - },
4497 - {
4498 - "name": "scopes",
4499 - "displayName": "Scopes",
4500 - "type": "string",
4501 - "description": "Scopes to request from the user, comma separated",
4502 - "required": false,
4503 - "default": "openid,email,profile,phone,aws.cognito.signin.user.admin"
4504 - }
4505 - ]
4506 - },
4507 - "connected_account_initiation": {
4508 - "required": [
4509 - {
4510 - "name": "region",
4511 - "displayName": "Region",
4512 - "type": "string",
4513 - "description": "Provide your region for authentication. Obtain it from your Borneo dashboard.",
4514 - "required": true,
4515 - "default": null
4516 - },
4517 - {
4518 - "name": "subdomain",
4519 - "displayName": "Cognito Domain",
4520 - "type": "string",
4521 - "description": "Provide your Cognito Domain for authentication. Obtain it from your Borneo dashboard.",
4522 - "required": true,
4523 - "default": null
4524 - },
4525 - {
4526 - "name": "hostUrl",
4527 - "displayName": "Borneo Dashboard URL",
4528 - "type": "string",
4529 - "description": "Provide your Borneo Dashboard URL for authentication. Obtain it from your Borneo dashboard.",
4530 - "required": true,
4531 - "default": null
4532 - }
4533 - ],
4534 - "optional": []
4535 - }
4536 - }
4537 - },
4538 - {
4539 - "mode": "API_KEY",
4540 - "name": "borneo_api_key",
4541 - "fields": {
4542 - "auth_config_creation": {
4543 - "required": [],
4544 - "optional": []
4545 - },
4546 - "connected_account_initiation": {
4547 - "required": [
4548 - {
4549 - "name": "generic_api_key",
4550 - "displayName": "Bearer Token",
4551 - "type": "string",
4552 - "description": "Provide your Borneo API bearer token for authentication. Obtain it from your Borneo dashboard.",
4553 - "required": true,
4554 - "default": null
4555 - }
4556 - ],
4557 - "optional": []
4558 - }
4559 - }
4560 - }
4561 - ]
568 + "triggerCount": 0
569 },
570 {
571 "slug": "mixpanel",
572 "name": "Mixpanel",
573 "logo": "https://logos.composio.dev/api/mixpanel",
4567 - "description": "Mixpanel is a product analytics platform tracking user interactions and engagement, providing cohort analysis, funnels, and A/B testing to improve user experiences",
574 "category": "analytics",
4569 - "authSchemes": [
4570 - "BASIC"
4571 - ],
4572 - "toolCount": 21,
4573 - "triggerCount": 0,
4574 - "version": "20260211_00",
4575 - "authConfigDetails": [
4576 - {
4577 - "mode": "BASIC",
4578 - "name": "mixpanel_basic",
4579 - "fields": {
4580 - "auth_config_creation": {
4581 - "required": [],
4582 - "optional": []
4583 - },
4584 - "connected_account_initiation": {
4585 - "required": [
4586 - {
4587 - "name": "username",
4588 - "displayName": "Service Account Username",
4589 - "type": "string",
4590 - "description": "The service account username for your Mixpanel account.",
4591 - "required": true,
4592 - "default": null
4593 - },
4594 - {
4595 - "name": "password",
4596 - "displayName": "Service Account Secret",
4597 - "type": "string",
4598 - "description": "The service account secret for your Mixpanel account.",
4599 - "required": true,
4600 - "default": null
4601 - }
4602 - ],
4603 - "optional": [
4604 - {
4605 - "name": "region",
4606 - "displayName": "Region",
4607 - "type": "string",
4608 - "description": "Your Mixpanel data residency region. Leave empty for Standard server, use \"eu\" for EU Residency, or \"in\" for India Residency.",
4609 - "required": false,
4610 - "default": null
4611 - }
4612 - ]
4613 - }
4614 - }
4615 - }
4616 - ]
575 + "toolCount": 43,
576 + "triggerCount": 0
577 },
578 {
579 "slug": "coda",
580 "name": "Coda",
581 "logo": "https://logos.composio.dev/api/coda",
4622 - "description": "Collaborative workspace platform that transforms documents into powerful tools for team productivity and project management",
582 "category": "productivity",
4624 - "authSchemes": [
4625 - "API_KEY"
4626 - ],
4627 - "toolCount": 101,
4628 - "triggerCount": 4,
4629 - "version": "20260211_00",
4630 - "authConfigDetails": [
4631 - {
4632 - "mode": "API_KEY",
4633 - "name": "API_KEY",
4634 - "fields": {
4635 - "auth_config_creation": {
4636 - "required": [],
4637 - "optional": []
4638 - },
4639 - "connected_account_initiation": {
4640 - "required": [
4641 - {
4642 - "name": "generic_api_key",
4643 - "displayName": "API Key",
4644 - "type": "string",
4645 - "description": "Your Koda API key for authentication",
4646 - "required": true,
4647 - "default": null
4648 - }
4649 - ],
4650 - "optional": []
4651 - }
4652 - }
4653 - }
4654 - ]
583 + "toolCount": 102,
584 + "triggerCount": 4
585 },
586 {
587 "slug": "acculynx",
588 "name": "Acculynx",
589 "logo": "https://logos.composio.dev/api/acculynx",
4660 - "description": "AccuLynx is the leading, all-in-one roofing software designed to streamline every aspect of a roofing business.",
590 "category": "crm",
4662 - "authSchemes": [
4663 - "API_KEY"
4664 - ],
591 "toolCount": 8,
4666 - "triggerCount": 0,
4667 - "version": "20260209_00",
4668 - "authConfigDetails": [
4669 - {
4670 - "mode": "API_KEY",
4671 - "name": "api_key_auth",
4672 - "fields": {
4673 - "auth_config_creation": {
4674 - "required": [],
4675 - "optional": []
4676 - },
4677 - "connected_account_initiation": {
4678 - "required": [
4679 - {
4680 - "name": "generic_api_key",
4681 - "displayName": "API Key",
4682 - "type": "string",
4683 - "description": "Your acculynx API key for authentication. Obtain it from your acculynx settings.",
4684 - "required": true,
4685 - "default": null
4686 - }
4687 - ],
4688 - "optional": []
4689 - }
4690 - }
4691 - }
4692 - ]
592 + "triggerCount": 0
593 },
594 {
595 "slug": "ahrefs",
596 "name": "Ahrefs",
597 "logo": "https://logos.composio.dev/api/ahrefs",
4698 - "description": "Ahrefs is an SEO and marketing platform offering site audits, keyword research, content analysis, and competitive insights to improve search rankings and drive organic traffic",
598 "category": "marketing automation",
4700 - "authSchemes": [
4701 - "API_KEY"
4702 - ],
599 "toolCount": 40,
4704 - "triggerCount": 0,
4705 - "version": "20260211_00",
4706 - "authConfigDetails": [
4707 - {
4708 - "mode": "API_KEY",
4709 - "name": "ahrefs_apikey",
4710 - "fields": {
4711 - "auth_config_creation": {
4712 - "required": [],
4713 - "optional": []
4714 - },
4715 - "connected_account_initiation": {
4716 - "required": [
4717 - {
4718 - "name": "generic_api_key",
4719 - "displayName": "API Key",
4720 - "type": "string",
4721 - "description": "You can crete your api key form account/api-keys in settings of your account. For more information check the docs https://docs.ahrefs.com/docs/api/reference/api-keys-creation-and-management",
4722 - "required": true,
4723 - "default": null
4724 - }
4725 - ],
4726 - "optional": []
4727 - }
4728 - }
4729 - }
4730 - ]
600 + "triggerCount": 0
601 },
602 {
603 "slug": "affinity",
604 "name": "Affinity",
605 "logo": "https://logos.composio.dev/api/affinity",
4736 - "description": "Affinity helps private capital investors to find, manage, and close more deals",
606 "category": "crm",
4738 - "authSchemes": [
4739 - "API_KEY"
4740 - ],
607 "toolCount": 20,
4742 - "triggerCount": 0,
4743 - "version": "20260203_01",
4744 - "authConfigDetails": [
4745 - {
4746 - "mode": "API_KEY",
4747 - "name": "affinity_apikey",
4748 - "fields": {
4749 - "auth_config_creation": {
4750 - "required": [],
4751 - "optional": []
4752 - },
4753 - "connected_account_initiation": {
4754 - "required": [
4755 - {
4756 - "name": "generic_api_key",
4757 - "displayName": "API Key",
4758 - "type": "string",
4759 - "description": "You can find your API key in your settings.",
4760 - "required": true,
4761 - "default": null
4762 - }
4763 - ],
4764 - "optional": []
4765 - }
4766 - }
4767 - }
4768 - ]
608 + "triggerCount": 0
609 },
610 {
611 "slug": "amplitude",
612 "name": "Amplitude",
613 "logo": "https://logos.composio.dev/api/amplitude",
4774 - "description": "Amplitude gives you the self-serve tools and real-time data to make products and experiences that win no matter what.",
614 "category": "analytics",
4776 - "authSchemes": [
4777 - "API_KEY"
4778 - ],
4779 - "toolCount": 16,
4780 - "triggerCount": 0,
4781 - "version": "20260211_00",
4782 - "authConfigDetails": [
4783 - {
4784 - "mode": "API_KEY",
4785 - "name": "api_key_auth",
4786 - "fields": {
4787 - "auth_config_creation": {
4788 - "required": [],
4789 - "optional": []
4790 - },
4791 - "connected_account_initiation": {
4792 - "required": [
4793 - {
4794 - "name": "full",
4795 - "displayName": "Base URL",
4796 - "type": "string",
4797 - "description": "The base URL for Amplitude API requests. For EU data residency, use https://analytics.eu.amplitude.com/api/2.",
4798 - "required": true,
4799 - "default": "https://amplitude.com/api/2"
4800 - },
4801 - {
4802 - "name": "generic_api_key",
4803 - "displayName": "API Key",
4804 - "type": "string",
4805 - "description": "Your Amplitude API Key for your project",
4806 - "required": true,
4807 - "default": null
4808 - },
4809 - {
4810 - "name": "generic_id",
4811 - "displayName": "API Secret",
4812 - "type": "string",
4813 - "description": "Your Amplitude API Secret for your project",
4814 - "required": true,
4815 - "default": null
4816 - }
4817 - ],
4818 - "optional": []
4819 - }
4820 - }
4821 - }
4822 - ]
615 + "toolCount": 18,
616 + "triggerCount": 0
617 },
618 {
619 "slug": "heygen",
620 "name": "HeyGen",
621 "logo": "https://logos.composio.dev/api/heygen",
4828 - "description": "HeyGen is an innovative video platform that harnesses the power of generative AI to streamline your video creation process",
622 "category": "artificial intelligence",
4830 - "authSchemes": [
4831 - "API_KEY"
4832 - ],
4833 - "toolCount": 35,
4834 - "triggerCount": 0,
4835 - "version": "20260211_00",
4836 - "authConfigDetails": [
4837 - {
4838 - "mode": "API_KEY",
4839 - "name": "heygen_apikey",
4840 - "fields": {
4841 - "auth_config_creation": {
4842 - "required": [],
4843 - "optional": []
4844 - },
4845 - "connected_account_initiation": {
4846 - "required": [
4847 - {
4848 - "name": "generic_api_key",
4849 - "displayName": "API Key",
4850 - "type": "string",

This file is too large to show in full.

docs/public/data/toolkits.json
+78172 -48357
@@ -8,89 +8,159 @@
8 "authSchemes": [
9 "OAUTH2"
10 ],
11 - "toolCount": 23,
11 + "toolCount": 40,
12 "triggerCount": 2,
13 "version": "20260211_00",
14 "tools": [
15 {
16 "slug": "GMAIL_ADD_LABEL_TO_EMAIL",
17 "name": "Modify email labels",
18 - "description": "Adds and/or removes specified gmail labels for a message; ensure `message id` and all `label ids` are valid (use 'listlabels' for custom label ids)."
18 + "description": "Adds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid (use 'listLabels' for custom label IDs)."
19 + },
20 + {
21 + "slug": "GMAIL_BATCH_DELETE_MESSAGES",
22 + "name": "Batch delete Gmail messages",
23 + "description": "Tool to permanently delete multiple Gmail messages in bulk. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene)."
24 + },
25 + {
26 + "slug": "GMAIL_BATCH_MODIFY_MESSAGES",
27 + "name": "Batch modify Gmail messages",
28 + "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."
29 },
30 {
31 "slug": "GMAIL_CREATE_EMAIL_DRAFT",
32 "name": "Create email draft",
23 - "description": "Creates a gmail email draft, supporting to/cc/bcc, subject, plain/html body (ensure `is html=true` for html), attachments, and threading."
33 + "description": "Creates a Gmail email draft. All fields are optional per the Gmail API - drafts can be created with minimal content and edited later before sending. Supports To/Cc/Bcc recipients, subject, plain/HTML body (ensure `is_html=True` for HTML), attachments, and threading. 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."
34 },
35 {
36 "slug": "GMAIL_CREATE_LABEL",
37 "name": "Create label",
28 - "description": "Creates a new label with a unique name in the specified user's gmail account."
38 + "description": "Creates a new label with a unique name in the specified user's Gmail account."
39 },
40 {
41 "slug": "GMAIL_DELETE_DRAFT",
42 "name": "Delete Draft",
33 - "description": "Permanently deletes a specific gmail draft using its id; ensure the draft exists and the user has necessary permissions for the given `user id`."
43 + "description": "Permanently deletes a specific Gmail draft using its ID; ensure the draft exists and the user has necessary permissions for the given `user_id`."
44 + },
45 + {
46 + "slug": "GMAIL_DELETE_LABEL",
47 + "name": "Delete label from account (permanent)",
48 + "description": "Permanently DELETES a user-created Gmail label from the account (not from a message). WARNING: This action DELETES the label definition itself, removing it from all messages. System labels (INBOX, SENT, UNREAD, etc.) cannot be deleted. To add/remove labels from specific messages, use GMAIL_ADD_LABEL_TO_EMAIL action instead."
49 },
50 {
51 "slug": "GMAIL_DELETE_MESSAGE",
52 "name": "Delete message",
38 - "description": "Permanently deletes a specific email message by its id from a gmail mailbox; for `user id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access."
53 + "description": "Permanently deletes a specific email message by its ID from a Gmail mailbox; for `user_id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access."
54 },
55 {
56 "slug": "GMAIL_FETCH_EMAILS",
57 "name": "Fetch emails",
43 - "description": "Fetches a list of email messages from a gmail account, supporting filtering, pagination, and optional full content retrieval."
58 + "description": "Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval."
59 },
60 {
61 "slug": "GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID",
62 "name": "Fetch message by message ID",
48 - "description": "Fetches a specific email message by its id, provided the `message id` exists and is accessible to the authenticated `user id`."
63 + "description": "Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`."
64 },
65 {
66 "slug": "GMAIL_FETCH_MESSAGE_BY_THREAD_ID",
67 "name": "Fetch Message by Thread ID",
53 - "description": "Retrieves messages from a gmail thread using its `thread id`, where the thread must be accessible by the specified `user id`."
68 + "description": "Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`."
69 + },
70 + {
71 + "slug": "GMAIL_FORWARD_MESSAGE",
72 + "name": "Forward email message",
73 + "description": "Forward an existing Gmail message to specified recipients, preserving original body and attachments."
74 },
75 {
76 "slug": "GMAIL_GET_ATTACHMENT",
77 "name": "Get Gmail attachment",
58 - "description": "Retrieves a specific attachment by id from a message in a user's gmail mailbox, requiring valid message and attachment ids."
78 + "description": "Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs."
79 + },
80 + {
81 + "slug": "GMAIL_GET_AUTO_FORWARDING",
82 + "name": "Get Auto-Forwarding Settings",
83 + "description": "Tool to get the auto-forwarding setting for the specified account. Use when you need to retrieve the current auto-forwarding configuration including enabled status, forwarding email address, and message disposition."
84 },
85 {
86 "slug": "GMAIL_GET_CONTACTS",
87 "name": "Get contacts",
63 - "description": "Fetches contacts (connections) for the authenticated google account, allowing selection of specific data fields and pagination."
88 + "description": "Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination."
89 + },
90 + {
91 + "slug": "GMAIL_GET_DRAFT",
92 + "name": "Get Draft",
93 + "description": "Retrieves a single Gmail draft by its ID. Use this to fetch and inspect draft content before sending via GMAIL_SEND_DRAFT. The format parameter controls the level of detail returned."
94 + },
95 + {
96 + "slug": "GMAIL_GET_LANGUAGE_SETTINGS",
97 + "name": "Get Language Settings",
98 + "description": "Tool to retrieve the language settings for a Gmail user. Use when you need to determine the display language preference for the authenticated user or a specific Gmail account."
99 },
100 {
101 "slug": "GMAIL_GET_PEOPLE",
102 "name": "Get People",
68 - "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."
103 + "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."
104 },
105 {
106 "slug": "GMAIL_GET_PROFILE",
107 "name": "Get Profile",
73 - "description": "Retrieves key gmail profile information (email address, message/thread totals, history id) for a user."
108 + "description": "Retrieves key Gmail profile information (email address, message/thread totals, history ID) for a user."
109 + },
110 + {
111 + "slug": "GMAIL_GET_VACATION_SETTINGS",
112 + "name": "Get Vacation Settings",
113 + "description": "Tool to retrieve vacation responder settings for a Gmail user. Use when you need to check if out-of-office auto-replies are configured and view their content."
114 + },
115 + {
116 + "slug": "GMAIL_LIST_CSE_IDENTITIES",
117 + "name": "List CSE identities",
118 + "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."
119 + },
120 + {
121 + "slug": "GMAIL_LIST_CSE_KEYPAIRS",
122 + "name": "List CSE key pairs",
123 + "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."
124 },
125 {
126 "slug": "GMAIL_LIST_DRAFTS",
77 - "name": "List drafts",
78 - "description": "Retrieves a paginated list of email drafts from a user's gmail account. use verbose=true to get full draft details including subject, body, sender, and timestamp."
127 + "name": "List Drafts",
128 + "description": "Retrieves a paginated list of email drafts from a user's Gmail account. Use verbose=true to get full draft details including subject, body, sender, and timestamp."
129 + },
130 + {
131 + "slug": "GMAIL_LIST_FILTERS",
132 + "name": "List Gmail filters",
133 + "description": "Tool to list all Gmail filters (rules) in the mailbox. Use for security audits to detect malicious filter rules or before creating new filters to avoid duplicates."
134 + },
135 + {
136 + "slug": "GMAIL_LIST_HISTORY",
137 + "name": "List Gmail history",
138 + "description": "Tool to list Gmail mailbox change history since a known startHistoryId. Use when performing incremental mailbox syncs to fetch only new changes."
139 },
140 {
141 "slug": "GMAIL_LIST_LABELS",
142 "name": "List Gmail labels",
83 - "description": "Retrieves a list of all system and user-created labels for the specified gmail account."
143 + "description": "Retrieves a list of all system and user-created labels for the specified Gmail account."
144 + },
145 + {
146 + "slug": "GMAIL_LIST_SEND_AS",
147 + "name": "List send-as aliases",
148 + "description": "Lists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases. Use when you need to retrieve available sending addresses for composing emails."
149 + },
150 + {
151 + "slug": "GMAIL_LIST_SMIME_INFO",
152 + "name": "List S/MIME configs",
153 + "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."
154 },
155 {
156 "slug": "GMAIL_LIST_THREADS",
157 "name": "List threads",
88 - "description": "Retrieves a list of email threads from a gmail account, identified by `user id` (email address or 'me'), supporting filtering and pagination."
158 + "description": "Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination."
159 },
160 {
161 "slug": "GMAIL_MODIFY_THREAD_LABELS",
162 "name": "Modify thread labels",
93 - "description": "Adds or removes specified existing label ids from a gmail thread, affecting all its messages; ensure the thread id is valid."
163 + "description": "Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid."
164 },
165 {
166 "slug": "GMAIL_MOVE_TO_TRASH",
@@ -102,30 +172,45 @@
172 "name": "Patch Label",
173 "description": "Patches the specified label."
174 },
105 - {
106 - "slug": "GMAIL_REMOVE_LABEL",
107 - "name": "Remove label",
108 - "description": "Permanently deletes a specific, existing user-created gmail label by its id for a user; cannot delete system labels."
109 - },
175 {
176 "slug": "GMAIL_REPLY_TO_THREAD",
177 "name": "Reply to email thread",
113 - "description": "Sends a reply within a specific gmail thread using the original thread's subject, requiring a valid `thread id` and correctly formatted email addresses. supports attachments via the `attachment` parameter with valid `s3key`, `mimetype`, and `name`."
178 + "description": "Sends a reply within a specific Gmail thread using the original thread's subject, requiring a valid `thread_id` and at least one of recipient_email, cc, or bcc must be provided. Supports attachments via the `attachment` parameter with valid `s3key`, `mimetype`, and `name`."
179 },
180 {
181 "slug": "GMAIL_SEARCH_PEOPLE",
182 "name": "Search People",
118 - "description": "Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'other contacts'."
183 + "description": "Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'."
184 },
185 {
186 "slug": "GMAIL_SEND_DRAFT",
187 "name": "Send Draft",
123 - "description": "Sends the specified, existing draft to the recipients in the to, cc, and bcc headers."
188 + "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 This action only requires the draft_id parameter."
189 },
190 {
191 "slug": "GMAIL_SEND_EMAIL",
192 "name": "Send Email",
128 - "description": "Sends an email via gmail api using the authenticated user's google profile display name, requiring `is html=true` if the body contains html and valid `s3key`, `mimetype`, `name` for any attachment."
193 + "description": "Sends an email via Gmail API using the authenticated user's Google profile display name. 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. For attachments, you must provide a FileUploadable object with valid `s3key` (obtained from a previous file download action like GMAIL_GET_ATTACHMENT), `mimetype` (e.g., 'image/png', 'application/pdf'), and `name` (filename). All common file types including PNG, JPG, PDF, MP4, etc. are supported. Gmail API limits total message size to ~25 MB after base64 encoding."
194 + },
195 + {
196 + "slug": "GMAIL_SETTINGS_GET_IMAP",
197 + "name": "Get IMAP Settings",
198 + "description": "Retrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size."
199 + },
200 + {
201 + "slug": "GMAIL_SETTINGS_GET_POP",
202 + "name": "Get POP settings",
203 + "description": "Tool to retrieve POP settings for a Gmail account. Use when you need to check the current POP configuration including access window and message disposition."
204 + },
205 + {
206 + "slug": "GMAIL_SETTINGS_SEND_AS_GET",
207 + "name": "Get send-as alias",
208 + "description": "Tool to retrieve a specific send-as alias configuration for a Gmail user. Use when you need to get details about a send-as email address including display name, signature, SMTP settings, and verification status. Fails with HTTP 404 if the specified address is not a member of the send-as collection."
209 + },
210 + {
211 + "slug": "GMAIL_UPDATE_DRAFT",
212 + "name": "Update draft",
213 + "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."
214 }
215 ],
216 "triggers": [
@@ -200,15 +285,10 @@
285 "authSchemes": [
286 "NO_AUTH"
287 ],
203 - "toolCount": 30,
288 + "toolCount": 25,
289 "triggerCount": 0,
290 "version": "20260211_00",
291 "tools": [
207 - {
208 - "slug": "COMPOSIO_ASK_ORACLE",
209 - "name": "Ask Oracle",
210 - "description": "Static helper that returns a comprehensive system prompt describing how to plan and execute tasks using the available composio tools and workflows. no inputs required; simply call to retrieve the prompt. always call this after the search tool is executed -- it will provide the best context on how to proceed, chain tools, and execute the task end-to-end. relevant tools referenced by the prompt: 1. composio search tools 2. composio multi execute tool 3. composio execute code 4. composio manage connections 5. composio bash tool"
211 - },
292 {
293 "slug": "COMPOSIO_CHECK_ACTIVE_CONNECTION",
294 "name": "Check active connection (deprecated)",
@@ -234,11 +314,6 @@
314 "name": "Enable trigger",
315 "description": "Enable a specific trigger for the authenticated user."
316 },
237 - {
238 - "slug": "COMPOSIO_EXECUTE_AGENT",
239 - "name": "Execute agent",
240 - "description": "Execute complex workflows using ai agent reasoning between multiple tool calls. use this for: complex multi-step workflows requiring reasoning, error handling and retry logic. use composio multi execute tool instead for: simple parallel operations, batch operations on similar data (e.g., fetch 5 emails, get 10 sent messages, retrieve multiple user profiles), independent tool calls that don't need each other's results, or bulk operations where all parameters are known upfront. performance: agent calls add ~2-3 seconds overhead. use for workflows >3 tools or requiring conditional logic. avoid for simple parameter passing."
241 - },
317 {
318 "slug": "COMPOSIO_EXECUTE_TOOL",
319 "name": "Execute Composio Tool",
@@ -274,11 +349,6 @@
349 "name": "List triggers",
350 "description": "List available triggers and their configuration schemas."
351 },
277 - {
278 - "slug": "COMPOSIO_MANAGE_CONNECTION",
279 - "name": "Manage connection",
280 - "description": "Manage a connection to a toolkit with comprehensive authentication support. supports all authentication scenarios: 1. composio default oauth (no parameters needed) 2. custom oauth (user's client id/client secret) 3. api key/bearer token authentication 4. basic auth (username/password) 5. hybrid scenarios (oauth + connection fields like site name) 6. connection-only fields (subdomain, api key at connection level) 7. no authentication required automatically detects and validates auth config vs connection fields, provides helpful error messages for missing parameters. notifies properly if a connection already exists or if authentication params are required from the user."
281 - },
352 {
353 "slug": "COMPOSIO_MANAGE_CONNECTIONS",
354 "name": "Manage connections",
@@ -299,16 +369,6 @@
369 "name": "Execute Code remotely in work bench",
370 "description": "\n Process **REMOTE FILES** or script BULK TOOL EXECUTIONS using Python code IN A REMOTE SANDBOX. If you can see the data in chat, DON'T USE THIS TOOL.\n**ONLY** use this when processing **data stored in a remote file** or when scripting bulk tool executions.\n\nDO NOT USE\n- When the complete response is already inline/in-memory, or you only need quick parsing, summarization, or basic math.\n\nUSE IF\n- To parse/analyze tool outputs saved to a remote file in the sandbox or to script multi-tool chains there.\n- For bulk or repeated executions of known Composio tools (e.g., add a label to 100 emails).\n- To call APIs via proxy_execute when no Composio tool exists for that API.\n\n\nOUTPUTS\n- Returns a compact result or, if too long, artifacts under `/home/user/.code_out`.\n\nIMPORTANT CODING RULES:\n 1. Stepwise Execution: Split work into small steps. Save intermediate outputs in variables or temporary file in `/tmp/`. Call COMPOSIO_REMOTE_WORKBENCH again for the next step. This improves composability and avoids timeouts.\n 2. Notebook Persistence: This is a persistent Jupyter notebook cell: variables, functions, imports, and in-memory state from previous and future code executions are preserved in the notebook's history and available for reuse. You also have a few helper functions available.\n 3. Parallelism & Timeout (CRITICAL): There is a hard timeout of 4 minutes so complete the code within that. Prioritize PARALLEL execution using ThreadPoolExecutor with suitable concurrency for bulk operations - e.g., call run_composio_tool or invoke_llm parallelly across rows to maximize efficiency.\n 3.1 If the data is large, split into smaller batches and call the workbench multiple times to avoid timeouts.\n 4. Checkpoints: Implement checkpoints (in memory or files) so that long runs can be resumed from the last completed step.\n 5. Schema Safety: Never assume the response schema for run_composio_tool if not known already from previous tools. To inspect schema, either run a simple request **outside** the workbench via COMPOSIO_MULTI_EXECUTE_TOOL or use invoke_llm helper.\n 6. LLM Helpers: Always use invoke_llm helper for summary, analysis, or field extraction on results. This is a smart LLM that will give much better results than any adhoc filtering.\n 7. Avoid Meta Loops: Do not use run_composio_tool to call COMPOSIO_MULTI_EXECUTE_TOOL or other COMPOSIO_* meta tools to avoid cycles. Only use it for app tools.\n 8. Pagination: Use when data spans multiple pages. Continue fetching pages with the returned next_page_token or cursor until none remains. Parallelize fetching pages if tool supports page_number.\n 9. No Hardcoding: Never hardcode data in code. Always load it from files or tool responses, iterating to construct intermediate or final inputs/outputs.\n 10. If the final output is in a workbench file, use upload_local_file to download it - never expose the raw workbench file path to the user. Prefer to download useful artifacts after task is complete.\n\n\nENV & HELPERS:\n- Home directory: `/home/user`.\n- NOTE: Helper functions already initialized in the workbench - DO NOT import or redeclare them:\n - \n`run_composio_tool(tool_slug: str, arguments: dict) -> tuple[Dict[str, Any], str]`: Execute a known Composio **app** tool (from COMPOSIO_SEARCH_TOOLS). Do not invent names; match the tool's input schema. Suited for loops/parallel/bulk over datasets.\n i) run_composio_tool returns JSON with top-level \"data\". Parse carefully—structure may be nested.\n \n - \n`invoke_llm(query: str) -> tuple[str, str]`: Invoke an LLM for semantic tasks. Pass MAX 200k characters in input.\n i) NOTE Prompting guidance: When building prompts for invoke_llm, prefer f-strings (or concatenation) so literal braces stay intact. If using str.format, escape braces by doubling them ({{ }}).\n ii) Define the exact JSON schema you want and batch items into smaller groups to stay within token limit.\n\n - `upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]`: Upload files in workbench to Composio S3/R2 storage. Use this to download any generated files/artifacts from the workbench.\n - `proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None) -> tuple[Any, str]`: Call a toolkit API directly when no Composio tool exists. Only one toolkit can be invoked with proxy_execute per workbench call\n - `web_search(query: str) -> tuple[str, str]`: Search the web for information.\n - `smart_file_extract(sandbox_file_path: str, show_preview: bool = True) -> tuple[str, str]`: Extracts text from files in the sandbox (e.g., PDF, image).\n - Workbench comes with comprehensive Image Processing (PIL/Pillow, OpenCV, scikit-image), PyTorch ML libraries, Document and Report handling tools (pandoc, python-docx, pdfplumber, reportlab), and standard Data Analysis tools (pandas, numpy, matplotlib) for advanced visual, analytical, and AI tasks.\n All helper functions return a tuple (result, error). Always check error before using result.\n\n## Python Helper Functions for LLM Scripting\n\n\n### run_composio_tool(tool_slug, arguments)\nExecutes a known Composio tool via backend API. Do NOT call COMPOSIO_* meta tools to avoid cyclic calls.\n\n def run_composio_tool(tool_slug: str, arguments: Dict[str, Any]) -> tuple[Dict[str, Any], str]\n # Returns: (tool_response_dict, error_message)\n # Success: ({\"data\": {actual_data}}, \"\") - Note the top-level data\n # Error: ({}, \"error_message\") or (response_data, \"error_message\")\n\n result, error = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 1, \"user_id\": \"me\"})\n if error:\n print(\"GMAIL_FETCH_EMAILS error:\", error); return\n email_data = result.get(\"data\", {})\n print(\"Fetched:\", email_data)\n \n\n\n### invoke_llm(query)\nCalls LLM for reasoning, analysis, and semantic tasks. Pass MAX 200k characters input.\n\n def invoke_llm(query: str) -> tuple[str, str]\n # Returns: (llm_response, error_message)\n\n resp, error = invoke_llm(\"Summarize the key points from this data\")\n if not error:\n print(\"LLM:\", resp)\n\n # Example: analyze tool response with LLM\n tool_resp, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5, \"user_id\": \"me\"})\n if not err:\n parsed = tool_resp.get(\"data\", {})\n resp, err2 = invoke_llm(f\"Analyze these emails and summarize: {parsed}\")\n if not err2:\n print(\"LLM Gmail Summary:\", resp)\n # TIP: batch prompts to reduce LLM calls.\n \n\n\n### upload_local_file(*file_paths)\nUploads sandbox files to Composio S3/R2 storage. Single files upload directly, multiple files are auto-zipped.\nUse this when you need to upload/download any generated artifacts from the sandbox.\n\n def upload_local_file(*file_paths) -> tuple[Dict[str, Any], str]\n # Returns: (result_dict, error_string)\n # Success: ({\"s3_url\": str, \"uploaded_file\": str, \"type\": str, \"id\": str, \"s3key\": str, \"message\": str}, \"\")\n # Error: ({}, \"error_message\")\n\n # Single file\n result, error = upload_local_file(\"/path/to/report.pdf\")\n\n # Multiple files (auto-zipped)\n result, error = upload_local_file(\"/home/user/doc1.txt\", \"/home/user/doc2.txt\")\n\n if not error:\n print(\"Uploaded:\", result[\"s3_url\"])\n\n\n### proxy_execute(method, endpoint, toolkit, query_params=None, body=None, headers=None)\nDirect API call to a connected toolkit service.\n\n def proxy_execute(\n method: Literal[\"GET\",\"POST\",\"PUT\",\"DELETE\",\"PATCH\"],\n endpoint: str,\n toolkit: str,\n query_params: Optional[Dict[str, str]] = None,\n body: Optional[object] = None,\n headers: Optional[Dict[str, str]] = None,\n ) -> tuple[Any, str]\n # Returns: (response_data, error_message)\n\n # Example: GET request with query parameters\n query_params = {\"q\": \"is:unread\", \"maxResults\": \"10\"}\n data, error = proxy_execute(\"GET\", \"/gmail/v1/users/me/messages\", \"gmail\", query_params=query_params)\n if not error:\n print(\"Success:\", data)\n\n\n### web_search(query)\nSearches the web via Exa AI.\n\n def web_search(query: str) -> tuple[str, str]\n # Returns: (search_results_text, error_message)\n\n results, error = web_search(\"latest developments in AI\")\n if not error:\n print(\"Results:\", results)\n\n## Best Practices\n\n\n### Error-first pattern and Defensive parsing (print keys while narrowing)\n res, err = run_composio_tool(\"GMAIL_FETCH_EMAILS\", {\"max_results\": 5})\n if err:\n print(\"error:\", err); return\n if isinstance(res, dict):\n print(\"res keys:\", list(res.keys()))\n data = res.get(\"data\") or {}\n print(\"data keys:\", list(data.keys()))\n msgs = data.get(\"messages\") or []\n print(\"messages count:\", len(msgs))\n for m in msgs:\n print(\"subject:\", m.get(\"subject\", \"<missing>\"))\n\n### Parallelize (4-min sandbox timeout)\nAdjust concurrency so all tasks finish within 4 minutes.\n\n import concurrent.futures\n\n MAX_CONCURRENCY = 10 # Adjust as needed\n\n def send_bulk_emails(email_list):\n def send_single(email):\n result, error = run_composio_tool(\"GMAIL_SEND_EMAIL\", {\n \"to\": email[\"recipient\"], \"subject\": email[\"subject\"], \"body\": email[\"body\"]\n })\n if error:\n print(f\"Failed {email['recipient']}: {error}\")\n return {\"status\": \"failed\", \"error\": error}\n return {\"status\": \"sent\", \"data\": result}\n\n results = []\n with concurrent.futures.ThreadPoolExecutor(max_workers=MAX_CONCURRENCY) as ex:\n futures = [ex.submit(send_single, e) for e in email_list]\n for f in concurrent.futures.as_completed(futures):\n results.append(f.result())\n return results\n\n email_list = [{\"recipient\": f\"user{i}@example.com\", \"subject\": \"Test\", \"body\": \"Hello\"} for i in range(1000)]\n results = send_bulk_emails(email_list)\n \n\n "
371 },
302 - {
303 - "slug": "COMPOSIO_RETRIEVE_TOOLKITS",
304 - "name": "Retrieve Toolkits",
305 - "description": "Toolkits are like github, linear, gmail, etc. tools are like send email, create issue, etc programmatic functions that can be used to perform the action. not all toolkits support all tools. some toolkits support only a subset of tools that might be possible to perform with that toolkit. use this action to retrieve the toolkits that can be used to perform the action. this list is only probabilistic. retrieve toolkits for a specified usecase. so for example, if use case is to \"send an email\" this action will return all the toolkits that can be used to send email. simiarly if use case is to \"create a github issue\" this action will return all the toolkits that can be used to create a github issue. after using this, to confirm whether the toolkit can indeed potentially support the use case, use the action retrieve actions."
306 - },
307 - {
308 - "slug": "COMPOSIO_SEARCH_AGENT",
309 - "name": "Search agent",
310 - "description": "Discover tools and analyze dependencies for complex workflows using ai agent. this action uses an ai agent to intelligently search for tools across toolkits and create optimized execution sequences with detailed instructions."
311 - },
372 {
373 "slug": "COMPOSIO_SEARCH_TOOLS",
374 "name": "Search Composio Tools",
@@ -382,59 +442,44 @@
442 "authSchemes": [
443 "OAUTH2"
444 ],
385 - "toolCount": 823,
445 + "toolCount": 792,
446 "triggerCount": 6,
447 "version": "20260211_00",
448 "tools": [
449 {
450 "slug": "GITHUB_ACCEPT_A_REPOSITORY_INVITATION",
451 "name": "Accept a repository invitation",
392 - "description": "Accepts a pending repository invitation that has been issued to the authenticated user."
393 - },
394 - {
395 - "slug": "GITHUB_ACTIVITY_LIST_REPO_S_STARRED_BY_AUTHENTICATED_USER",
396 - "name": "List repositories starred by the authenticated user",
397 - "description": "Deprecated: lists repositories starred by the authenticated user, including star creation timestamps; use 'list repositories starred by the authenticated user' instead."
398 - },
399 - {
400 - "slug": "GITHUB_ACTIVITY_LIST_STARGAZERS_FOR_REPO",
401 - "name": "List stargazers",
402 - "description": "Deprecated: lists users who have starred a repository; use `list stargazers` instead."
403 - },
404 - {
405 - "slug": "GITHUB_ACTIVITY_STAR_REPO_FOR_AUTHENTICATED_USER",
406 - "name": "Star a repository for the authenticated user",
407 - "description": "Deprecated: stars a repository for the authenticated user; use `star a repository for the authenticated user` instead."
452 + "description": "Accepts a PENDING repository invitation that has been issued to the authenticated user."
453 },
454 {
455 "slug": "GITHUB_ADD_AN_EMAIL_ADDRESS_FOR_THE_AUTHENTICATED_USER",
456 "name": "Add email for auth user",
412 - "description": "Adds one or more email addresses (which will be initially unverified) to the authenticated user's github account; use this to associate new emails, noting an email verified for another account will error, while an existing email for the current user is accepted."
457 + "description": "Adds one or more email addresses (which will be initially unverified) to the authenticated user's GitHub account; use this to associate new emails, noting an email verified for another account will error, while an existing email for the current user is accepted."
458 },
459 {
460 "slug": "GITHUB_ADD_APP_ACCESS_RESTRICTIONS",
461 "name": "Add app access restrictions",
417 - "description": "Replaces github app access restrictions for an existing protected branch; requires a json array of app slugs in the request body, where apps must be installed and have 'contents' write permissions."
462 + "description": "Adds GitHub Apps to the list of apps allowed to push to a protected branch. The branch must already have protection rules with restrictions enabled. This endpoint only works for organization repositories, not personal repositories. Apps must be installed on the repository with 'contents' write permissions."
463 },
464 {
465 "slug": "GITHUB_ADD_A_REPOSITORY_COLLABORATOR",
466 "name": "Add a repository collaborator",
422 - "description": "Adds a github user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned repositories (personal ones default to 'push' and ignore this field), and an invitation may be created or permissions updated directly."
467 + "description": "Adds a GitHub user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned repositories (personal ones default to 'push' and ignore this field), and an invitation may be created or permissions updated directly."
468 },
469 {
470 "slug": "GITHUB_ADD_A_REPOSITORY_TO_AN_APP_INSTALLATION",
471 "name": "Add a repository to an app installation",
427 - "description": "Adds a repository to a github app installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation."
472 + "description": "Adds a repository to a GitHub App installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation."
473 },
474 {
475 "slug": "GITHUB_ADD_A_SELECTED_REPOSITORY_TO_A_USER_SECRET",
476 "name": "Add a selected repository to a user secret",
432 - "description": "Grants a specified repository access to an authenticated user's existing codespaces secret, enabling codespaces created for that repository to use the secret."
477 + "description": "Grants a specified repository access to an authenticated user's existing Codespaces secret, enabling Codespaces created for that repository to use the secret."
478 },
479 {
480 "slug": "GITHUB_ADD_ASSIGNEES_TO_AN_ISSUE",
481 "name": "Add assignees to an issue",
437 - "description": "Adds or removes assignees for a github issue; changes are silently ignored if the authenticated user lacks push access to the repository."
482 + "description": "Adds assignees to a GitHub issue. This action only adds users - it does not remove existing assignees. Changes are silently ignored if the authenticated user lacks push access to the repository."
483 },
484 {
485 "slug": "GITHUB_ADD_LABELS_TO_AN_ISSUE",
@@ -449,12 +494,12 @@
494 {
495 "slug": "GITHUB_ADD_OR_UPDATE_TEAM_MEMBERSHIP_FOR_A_USER",
496 "name": "Add or update team membership for a user",
452 - "description": "Adds a github user to a team or updates their role (member or maintainer), inviting them to the organization if not already a member; idempotent, returning current details if no change is made."
497 + "description": "Adds a GitHub user to a team or updates their role (member or maintainer), inviting them to the organization if not already a member; idempotent, returning current details if no change is made."
498 },
499 {
500 "slug": "GITHUB_ADD_OR_UPDATE_TEAM_PROJECT_PERMISSIONS",
501 "name": "Add or update team project permissions",
457 - "description": "Grants or updates a team's permissions ('read', 'write', or 'admin') for a specific project, which must exist within the specified organization and be linked to it."
502 + "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."
503 },
504 {
505 "slug": "GITHUB_ADD_OR_UPDATE_TEAM_REPOSITORY_PERMISSIONS",
@@ -464,17 +509,17 @@
509 {
510 "slug": "GITHUB_ADD_PROJECT_COLLABORATOR",
511 "name": "Add project collaborator",
467 - "description": "Adds a specified github user as a collaborator to an existing organization project with a given permission level."
512 + "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."
513 },
514 {
515 "slug": "GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_ACCESS",
516 "name": "Add repo to org secret with selected access",
472 - "description": "Adds a repository to an existing organization-level github actions secret that is configured for 'selected' repository access."
517 + "description": "Adds a repository to an existing organization-level GitHub Actions secret that is configured for 'selected' repository access."
518 },
519 {
520 "slug": "GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_VISIBILITY",
521 "name": "Add selected repo to org secret",
477 - "description": "Grants an existing repository access to an existing organization-level dependabot secret; the repository must belong to the organization, and the call succeeds without change if access already exists."
522 + "description": "Grants an existing repository access to an existing organization-level Dependabot secret when the secret's visibility is set to 'selected'; the repository must belong to the organization, and the call succeeds without change if access already exists."
523 },
524 {
525 "slug": "GITHUB_ADD_RUNNER_LABELS",
@@ -489,32 +534,37 @@
534 {
535 "slug": "GITHUB_ADD_SELECTED_REPOSITORY_TO_AN_ORGANIZATION_VARIABLE",
536 "name": "Add selected repository to an organization variable",
492 - "description": "Grants a repository access to an organization-level github actions variable, if that variable's visibility is set to 'selected repositories'."
537 + "description": "Grants a repository access to an organization-level GitHub Actions variable, if that variable's visibility is set to 'selected_repositories'."
538 },
539 {
540 "slug": "GITHUB_ADD_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER",
541 "name": "Add social accounts for the authenticated user",
497 - "description": "Adds one or more social media links (which must be valid, full urls for platforms supported by github) to the authenticated user's public github profile."
542 + "description": "Adds one or more social media links (which must be valid, full URLs for platforms supported by GitHub) to the authenticated user's public GitHub profile."
543 },
544 {
545 "slug": "GITHUB_ADD_STATUS_CHECK_CONTEXTS",
546 "name": "Add status check contexts",
502 - "description": "Adds status check contexts (provided in the request body, e.g., `{\"contexts\": [\"new-context\"]}`) to a protected branch, requiring these contexts to have been previously reported."
547 + "description": "Adds status check contexts to a protected branch's required status checks. This action appends new status check contexts to the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead."
548 },
549 {
550 "slug": "GITHUB_ADD_TEAM_ACCESS_RESTRICTIONS",
551 "name": "Add team access restrictions",
507 - "description": "Overwrites the list of teams (and their child teams) granted push access to a protected branch; the list of team slugs must be provided in the http post request body."
552 + "description": "Adds teams to the list of teams with push access to a protected branch. This action grants additional teams push access to a protected branch. Unlike 'Set team access restrictions' (PUT), this action adds to the existing list rather than replacing it entirely. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access"
553 },
554 {
555 "slug": "GITHUB_ADD_USER_ACCESS_RESTRICTIONS",
556 "name": "Add user access restrictions",
512 - "description": "Sets/replaces list of users allowed to push to a protected branch; usernames (e.g., `[\"user1\"]`) must be a json array in request body (not schema parameters), an empty array `[]` removes all restrictions."
557 + "description": "Adds users to the list of people allowed to push to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items"
558 },
559 {
560 "slug": "GITHUB_ADD_USERS_TO_CODESPACES_ACCESS_FOR_AN_ORGANIZATION",
561 "name": "Add users to codespaces access for an organization",
517 - "description": "Sets or replaces the list of organization members granted codespaces access billed to the organization; ensure the organization's billing settings allow access for selected members."
562 + "description": "Adds organization members to the list of users granted Codespaces access billed to the organization. IMPORTANT: This endpoint requires the organization's Codespaces billing access to be set to 'selected_members' mode. If not already configured, use the GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES action first to set visibility to 'selected_members'."
563 + },
564 + {
565 + "slug": "GITHUB_API_ROOT",
566 + "name": "Get GitHub API root",
567 + "description": "Retrieves a map of all top-level GitHub REST API resource URLs and their templates."
568 },
569 {
570 "slug": "GITHUB_APPROVE_A_WORKFLOW_RUN_FOR_A_FORK_PULL_REQUEST",
@@ -524,92 +574,92 @@
574 {
575 "slug": "GITHUB_ASSIGN_AN_ORGANIZATION_ROLE_TO_A_TEAM",
576 "name": "Assign an organization role to a team",
527 - "description": "Assigns an existing organization-level role (identified by `role id`) to a team (identified by `team slug`) within a github organization (`org`), provided the organization, team, and role already exist."
577 + "description": "Assigns an existing organization-level role (identified by `role_id`) to a team (identified by `team_slug`) within a GitHub organization (`org`), provided the organization, team, and role already exist."
578 },
579 {
580 "slug": "GITHUB_ASSIGN_AN_ORGANIZATION_ROLE_TO_A_USER",
581 "name": "Assign an organization role to a user",
532 - "description": "Assigns a specific organization role to a user who is a member or an outside collaborator in a github organization, using a valid role id."
582 + "description": "Assigns a specific organization role to a user who is a member or an outside collaborator in a GitHub organization, using a valid role ID."
583 },
584 {
585 "slug": "GITHUB_AUTH_USER_DOCKER_CONFLICT_PACKAGES_LIST",
536 - "name": "Authuserdockerconflictpackageslist",
537 - "description": "Lists docker packages for the authenticated user that encountered conflicts during the docker migration process."
586 + "name": "List Docker Migration Conflicting Packages",
587 + "description": "List Docker packages with migration conflicts for the authenticated user. This endpoint lists all Docker packages owned by the authenticated user that encountered namespace conflicts during the Docker-to-GitHub Container Registry (GHCR) migration. Conflicts occur when a package with the same name exists in both the legacy Docker registry and GHCR. IMPORTANT: The Docker registry for GitHub Packages was deprecated on Feb 24, 2025. This endpoint may return a 400 error with message 'Package migration for docker is no longer supported' as the migration period has ended. In this case, the action returns an informative response instead of failing. Use case: Identifying packages that require manual migration to GHCR. Required scope: read:packages (for OAuth and personal access tokens)."
588 },
589 {
590 "slug": "GITHUB_BLOCK_A_USER",
591 "name": "Block a user",
542 - "description": "Blocks an existing individual github user (not an organization or your own account), preventing them from interacting with your account and repositories."
592 + "description": "Blocks an existing individual GitHub user (not an organization or your own account), preventing them from interacting with your account and repositories."
593 },
594 {
595 "slug": "GITHUB_BLOCK_A_USER_FROM_AN_ORGANIZATION",
596 "name": "Block a user from an organization",
547 - "description": "Blocks an existing github user from an existing organization, preventing their contributions, collaboration, and forking of the organization's repositories."
597 + "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)."
598 },
599 {
600 "slug": "GITHUB_CANCEL_A_GITHUB_PAGES_DEPLOYMENT",
601 "name": "Cancel a GitHub Pages deployment",
552 - "description": "Cancels an existing, ongoing or queued github pages deployment for a repository using its `pages deployment id`."
602 + "description": "Cancels an existing, ongoing or queued GitHub Pages deployment for a repository using its `pages_deployment_id`."
603 },
604 {
605 "slug": "GITHUB_CANCEL_A_WORKFLOW_RUN",
606 "name": "Cancel a workflow run",
557 - "description": "Cancels a workflow run in a github repository if it is in a cancellable state (e.g., 'in progress' or 'queued')."
607 + "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."
608 },
609 {
610 "slug": "GITHUB_CHECK_A_TOKEN",
611 "name": "Check a token",
562 - "description": "Checks if a github app or oauth access token is valid for the specified client id and retrieves its details, typically to verify its active status and grants."
612 + "description": "Checks if a GitHub App or OAuth access_token is valid for the specified client_id and retrieves its details, typically to verify its active status and grants. NOTE: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. The access_token parameter must be an OAuth token issued by the specified OAuth App."
613 },
614 {
615 "slug": "GITHUB_CHECK_IF_A_GIST_IS_STARRED",
616 "name": "Check if a gist is starred",
567 - "description": "Checks if a gist, identified by `gist id`, is starred by the authenticated user, returning an empty response (204) if starred, or a 404 error if not starred or not found."
617 + "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."
618 },
619 {
620 "slug": "GITHUB_CHECK_IF_A_PERSON_IS_FOLLOWED_BY_THE_AUTHENTICATED_USER",
621 "name": "Check if person is followed by authenticated user",
572 - "description": "Checks if the authenticated github user follows a target github user; an http 204 status indicates the user is followed, while an http 404 status indicates the user is not followed or the target user does not exist."
622 + "description": "Checks if the authenticated GitHub user follows a target GitHub user. Returns a structured response with is_following=True when following (HTTP 204), or is_following=False when not following (HTTP 404)."
623 },
624 {
625 "slug": "GITHUB_CHECK_IF_A_PULL_REQUEST_HAS_BEEN_MERGED",
626 "name": "Check if pull request merged",
577 - "description": "Checks if a specified github pull request has been merged, indicated by a 204 http status (merged) or 404 (not merged/found)."
627 + "description": "Checks if a specified GitHub pull request has been merged, indicated by a 204 HTTP status (merged) or 404 (not merged/found)."
628 },
629 {
630 "slug": "GITHUB_CHECK_IF_A_REPOSITORY_IS_STARRED_BY_THE_AUTHENTICATED_USER",
631 "name": "Check if repo starred by auth user",
582 - "description": "Use to determine if the authenticated user has starred a specific github repository, which is confirmed by an http 204 status (resulting in an empty dictionary in the response data); the action fails (e.g., http 404) if the repository is not starred or does not exist."
632 + "description": "DEPRECATED: Use `GITHUB_CHECK_IF_A_REPOSITORY_IS_STARRED_BY_THE_USER` instead."
633 },
634 {
635 "slug": "GITHUB_CHECK_IF_A_USER_CAN_BE_ASSIGNED",
636 "name": "Check if a user can be assigned",
587 - "description": "Verifies if a github user can be assigned to issues in a repository; assignability is confirmed by an http 204 (no content) response, resulting in an empty 'data' field in the response."
637 + "description": "Verifies if a GitHub user can be assigned to issues in a repository; assignability is confirmed by an HTTP 204 (No Content) response, resulting in an empty 'data' field in the response."
638 },
639 {
640 "slug": "GITHUB_CHECK_IF_A_USER_CAN_BE_ASSIGNED_TO_A_ISSUE",
641 "name": "Check if a user can be assigned to an issue",
592 - "description": "Checks if a specified github user can be assigned to a given issue within a repository."
642 + "description": "Checks if a specified GitHub user can be assigned to a given issue within a repository."
643 },
644 {
645 "slug": "GITHUB_CHECK_IF_A_USER_FOLLOWS_ANOTHER_USER",
646 "name": "Check if a user follows another user",
597 - "description": "Checks if a github user `username` follows `target user`; returns a 204 http status if true, 404 if not or if users are invalid."
647 + "description": "Checks if a GitHub user `username` follows `target_user`; returns a 204 HTTP status if true, 404 if not or if users are invalid."
648 },
649 {
650 "slug": "GITHUB_CHECK_IF_A_USER_IS_A_REPOSITORY_COLLABORATOR",
651 "name": "Check if a user is a repository collaborator",
602 - "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."
652 + "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."
653 },
654 {
655 "slug": "GITHUB_CHECK_IF_A_USER_IS_BLOCKED_BY_AN_ORGANIZATION",
656 "name": "Check if a user is blocked by an organization",
607 - "description": "Checks if a github user is blocked by an organization; a successful response (204 no content) indicates the user is blocked, while a 404 not found error indicates the user is not blocked."
657 + "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)."
658 },
659 {
660 "slug": "GITHUB_CHECK_IF_A_USER_IS_BLOCKED_BY_THE_AUTHENTICATED_USER",
661 "name": "Check if a user is blocked by the authenticated user",
612 - "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."
662 + "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."
663 },
664 {
665 "slug": "GITHUB_CHECK_PRIVATE_VULNERABILITY_REPORTING_STATUS",
@@ -629,27 +679,32 @@
679 {
680 "slug": "GITHUB_CLEAR_REPOSITORY_CACHE_BY_KEY",
681 "name": "Clear repository cache by key",
632 - "description": "Deletes github actions caches from a repository matching a specific `key` and an optional git `ref`, used to manage storage or clear outdated/corrupted caches; the action succeeds even if no matching caches are found to delete."
682 + "description": "Deletes GitHub Actions caches from a repository matching a specific `key` and an optional Git `ref`, used to manage storage or clear outdated/corrupted caches; the action succeeds even if no matching caches are found to delete."
683 },
684 {
685 "slug": "GITHUB_CLEAR_SELF_HOSTED_RUNNER_ORG_LABELS",
686 "name": "Clear self-hosted runner org labels",
687 "description": "Removes all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain."
688 },
689 + {
690 + "slug": "GITHUB_COMMIT_MULTIPLE_FILES",
691 + "name": "Commit Multiple Files",
692 + "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."
693 + },
694 {
695 "slug": "GITHUB_COMPARE_TWO_COMMITS",
696 "name": "Compare two commits",
642 - "description": "Compares two commit points (commits, branches, tags, or shas) within a repository or across forks, using `base...head` or `owner:ref...owner:ref` format for the `basehead` parameter."
697 + "description": "Compares two commit points (commits, branches, tags, or SHAs) within a repository or across forks, using `BASE...HEAD` or `OWNER:REF...OWNER:REF` format for the `basehead` parameter."
698 },
699 {
700 "slug": "GITHUB_CONFIGURE_JITRUNNER_FOR_ORG",
701 "name": "Configure JIT runner for an org",
647 - "description": "Generates a jit configuration for a github organization's new self-hosted runner to run a single job then unregister; the runner group id must exist."
702 + "description": "Generates a JIT configuration for a GitHub organization's new self-hosted runner to run a single job then unregister; requires admin:org scope and the runner_group_id must exist in the organization."
703 },
704 {
705 "slug": "GITHUB_CONFIGURE_OIDCSUBJECT_CLAIM_TEMPLATE",
706 "name": "Configure OIDC subject claim template",
652 - "description": "Sets or updates the oidc subject claim customization template for an existing github organization by specifying which claims (e.g., 'repo', 'actor') form the oidc token's subject (`sub`)."
707 + "description": "Sets or updates the OIDC subject claim customization template for an existing GitHub organization by specifying which claims (e.g., 'repo', 'actor') form the OIDC token's subject (`sub`). This action customizes which claim keys are included in the OIDC subject claim for the specified organization. It allows for fine-tuning the content of the subject claim based on organizational needs."
708 },
709 {
710 "slug": "GITHUB_CONVERT_AN_ORGANIZATION_MEMBER_TO_OUTSIDE_COLLABORATOR",
@@ -659,37 +714,37 @@
714 {
715 "slug": "GITHUB_CREATE_A_BLOB",
716 "name": "Create a blob",
662 - "description": "Creates a git blob in a repository, requiring content and encoding ('utf-8' or 'base64')."
717 + "description": "Creates a Git blob in a repository, requiring content and encoding ('utf-8' or 'base64'). Requires write access to the repository."
718 },
719 {
720 "slug": "GITHUB_CREATE_A_CHECK_RUN",
721 "name": "Create a check run",
667 - "description": "Creates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images directly within the github ui."
722 + "description": "Creates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images directly within the GitHub UI. NOTE: This endpoint requires GitHub App authentication - OAuth tokens and personal access tokens cannot create check runs."
723 },
724 {
725 "slug": "GITHUB_CREATE_A_CHECK_SUITE",
726 "name": "Create a check suite",
672 - "description": "Creates a new check suite for a specific commit (`head sha`) in an original repository (not a fork); github dispatches a `check suite` webhook event with the `requested` action upon success."
727 + "description": "Creates a new check suite for a specific commit (`head_sha`) in an original repository (not a fork). IMPORTANT: This endpoint requires a GitHub App installation access token - OAuth tokens and classic personal access tokens cannot use this endpoint. GitHub dispatches a `check_suite` webhook event with the `requested` action upon success."
728 },
729 {
730 "slug": "GITHUB_CREATE_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
731 "name": "Create a codespace for the authenticated user",
677 - "description": "Creates a github codespace for the authenticated user, requiring a json request body with either `repository id` (integer) or a `pull request` object (containing `pull request number` (integer) and `repository id` (integer))."
732 + "description": "Creates a GitHub Codespace for the authenticated user, requiring a JSON request body with either `repository_id` (integer) or a `pull_request` object (containing `pull_request_number` (integer) and `repository_id` (integer)). This action allows users to set up a development environment quickly by creating a codespace from a specified repository or pull request."
733 },
734 {
735 "slug": "GITHUB_CREATE_A_CODESPACE_FROM_A_PULL_REQUEST",
736 "name": "Create a codespace from a pull request",
682 - "description": "Creates a github codespace for an open pull request in a codespaces-enabled repository, with options to customize its configuration."
737 + "description": "Creates a GitHub Codespace for an open pull request in a Codespaces-enabled repository, with options to customize its configuration."
738 },
739 {
740 "slug": "GITHUB_CREATE_A_CODESPACE_IN_A_REPOSITORY",
741 "name": "Create a codespace in a repository",
687 - "description": "Creates a github codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.json` if `devcontainer path` is specified."
742 + "description": "Creates a GitHub Codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.json` if `devcontainer_path` is specified."
743 },
744 {
745 "slug": "GITHUB_CREATE_A_COMMIT",
746 "name": "Create a commit",
692 - "description": "Creates a new commit in a github repository; the `tree` sha and any `parents` shas must already exist in the repository."
747 + "description": "Creates a new commit in a GitHub repository; the `tree` SHA and any `parents` SHAs must already exist in the repository."
748 },
749 {
750 "slug": "GITHUB_CREATE_A_COMMIT_COMMENT",
@@ -699,32 +754,32 @@
754 {
755 "slug": "GITHUB_CREATE_A_COMMIT_STATUS",
756 "name": "Create a commit status",
702 - "description": "Sets a commit's status (e.g., error, failure, pending, success from ci/cd) for a given sha; max 1000 statuses per sha/context."
757 + "description": "Sets a commit's status (e.g., error, failure, pending, success from CI/CD) for a given SHA; max 1000 statuses per SHA/context."
758 },
759 {
760 "slug": "GITHUB_CREATE_A_CUSTOM_ORGANIZATION_ROLE",
761 "name": "Create a custom organization role",
707 - "description": "Creates a custom role with defined permissions within a github organization."
762 + "description": "Creates a custom role with defined permissions within a GitHub organization."
763 },
764 {
765 "slug": "GITHUB_CREATE_A_DEPLOY_KEY",
766 "name": "Create a deploy key",
712 - "description": "Creates a deploy key for a repository; the repository must exist and be accessible, and the provided key must be a valid public ssh key."
767 + "description": "Creates a deploy key for a repository; the repository must exist and be accessible, and the provided key must be a valid public SSH key."
768 },
769 {
770 "slug": "GITHUB_CREATE_A_DEPLOYMENT",
771 "name": "Create a deployment",
717 - "description": "Creates a github deployment for an existing repository, targeting a specific ref (branch, tag, or sha) that must also exist within the repository."
772 + "description": "Creates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA) that must also exist within the repository."
773 },
774 {
775 "slug": "GITHUB_CREATE_A_DEPLOYMENT_BRANCH_POLICY",
776 "name": "Create a deployment branch policy",
722 - "description": "Creates a deployment branch or tag policy for an existing environment in a github repository, using a ruby file.fnmatch pattern (where `*` doesn't match `/`) to specify which branches or tags are deployable."
777 + "description": "Creates a deployment branch or tag policy for an existing environment in a GitHub repository, using a Ruby File.fnmatch pattern (where `*` doesn't match `/`) to specify which branches or tags are deployable."
778 },
779 {
780 "slug": "GITHUB_CREATE_A_DEPLOYMENT_STATUS",
781 "name": "Create a deployment status",
727 - "description": "Creates a status for an existing deployment, updating its operational state, associated urls, and description."
782 + "description": "Creates a status for an existing deployment, updating its operational state, associated URLs, and description."
783 },
784 {
785 "slug": "GITHUB_CREATE_A_DISCUSSION",
@@ -734,7 +789,7 @@
789 {
790 "slug": "GITHUB_CREATE_A_DISCUSSION_COMMENT",
791 "name": "Create a discussion comment",
737 - "description": "Creates a new comment on an existing team discussion within a github organization."
792 + "description": "Creates a new comment on an existing team discussion within a GitHub organization."
793 },
794 {
795 "slug": "GITHUB_CREATE_A_FORK",
@@ -744,102 +799,102 @@
799 {
800 "slug": "GITHUB_CREATE_A_GIST",
801 "name": "Create a gist",
747 - "description": "Creates a new gist on github with provided files, an optional description, and public/secret visibility."
802 + "description": "Creates a new gist on GitHub with provided files, an optional description, and public/secret visibility."
803 },
804 {
805 "slug": "GITHUB_CREATE_A_GIST_COMMENT",
806 "name": "Create a gist comment",
752 - "description": "Creates a new comment on a specified github gist."
807 + "description": "Creates a new comment on a specified GitHub gist."
808 },
809 {
810 "slug": "GITHUB_CREATE_A_GITHUB_APP_FROM_A_MANIFEST",
811 "name": "Create a GitHub App from a manifest",
757 - "description": "Use this action to finalize a github app's creation by exchanging the temporary `code` (received as a url parameter during the app manifest setup redirection) for the app's full configuration details."
812 + "description": "Use this action to complete the GitHub App Manifest flow (step 3 of 3) by exchanging the temporary authorization `code` for the app's full configuration, including credentials and private key. The code is provided via redirect URL after creating the app through GitHub's web interface and must be used within 1 hour."
813 },
814 {
815 "slug": "GITHUB_CREATE_A_GITHUB_PAGES_DEPLOYMENT",
816 "name": "Create a github pages deployment",
762 - "description": "Creates a github pages deployment for a repository using a specified artifact and oidc token, provided github pages is enabled and the artifact (containing static assets) is accessible."
817 + "description": "Creates a GitHub Pages deployment for a repository using a specified artifact and OIDC token, provided GitHub Pages is enabled and the artifact (containing static assets) is accessible."
818 },
819 {
820 "slug": "GITHUB_CREATE_A_GITHUB_PAGES_SITE",
821 "name": "Create a github pages site",
767 - "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`."
822 + "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."
823 },
824 {
825 "slug": "GITHUB_CREATE_A_LABEL",
826 "name": "Create a label",
772 - "description": "Creates a new label in a specified github repository, provided the repository exists and the user has write permissions."
827 + "description": "Creates a new label in a specified GitHub repository, provided the repository exists and the user has write permissions."
828 },
829 {
830 "slug": "GITHUB_CREATE_A_MILESTONE",
831 "name": "Create a milestone",
777 - "description": "Creates a milestone in a github repository for tracking progress on issues or pull requests; requires repository existence and user write permissions."
832 + "description": "Creates a milestone in a GitHub repository for tracking progress on issues or pull requests; requires repository existence and user write permissions."
833 },
834 {
835 "slug": "GITHUB_CREATE_AN_AUTOLINK_REFERENCE_FOR_A_REPOSITORY",
836 "name": "Create an autolink reference for a repository",
782 - "description": "Creates a repository autolink to automatically convert text references (e.g., 'ticket-123') into hyperlinks, using a unique `key prefix` and a `url template` that includes `<num>`."
837 + "description": "Creates a repository autolink to automatically convert text references (e.g., 'TICKET-123') into hyperlinks, using a unique `key_prefix` and a `url_template` that includes `<num>`."
838 },
839 {
840 "slug": "GITHUB_CREATE_AN_ENVIRONMENT_VARIABLE",
841 "name": "Create an environment variable",
787 - "description": "Creates an encrypted environment variable for a pre-existing environment within a github repository; will fail if the variable name already exists."
842 + "description": "Creates an encrypted environment variable for a pre-existing environment within a GitHub repository; will fail if the variable name already exists."
843 },
844 {
845 "slug": "GITHUB_CREATE_AN_ISSUE",
846 "name": "Create an issue",
792 - "description": "Creates a new issue in a github repository, requiring the repository to exist and have issues enabled; specific fields like assignees, milestone, or labels may require push access."
847 + "description": "Creates a new issue in a GitHub repository, requiring the repository to exist and have issues enabled; specific fields like assignees, milestone, or labels may require push access."
848 },
849 {
850 "slug": "GITHUB_CREATE_AN_ISSUE_COMMENT",
851 "name": "Create an issue comment",
797 - "description": "Creates a new comment on an existing github issue or pull request within the specified repository."
852 + "description": "Creates a new comment on an existing GitHub issue or pull request within the specified repository."
853 },
854 {
855 "slug": "GITHUB_CREATE_AN_ORGANIZATION_PROJECT",
856 "name": "Create an organization project",
802 - "description": "Creates a new classic project board within a specified github organization."
857 + "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"
858 },
859 {
860 "slug": "GITHUB_CREATE_AN_ORGANIZATION_REPOSITORY",
861 "name": "Create an organization repository",
807 - "description": "Creates a new repository within a specified github organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates."
862 + "description": "Creates a new repository within a specified GitHub organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates."
863 },
864 {
865 "slug": "GITHUB_CREATE_AN_ORGANIZATION_VARIABLE",
866 "name": "Create an organization variable",
812 - "description": "Creates a new, uniquely named github actions variable for an organization, with configurable repository access visibility (all, private, or selected)."
867 + "description": "Creates a new, uniquely named GitHub Actions variable for an organization, with configurable repository access visibility (all, private, or selected)."
868 },
869 {
870 "slug": "GITHUB_CREATE_AN_ORGANIZATION_WEBHOOK",
871 "name": "Create an organization webhook",
817 - "description": "Creates a webhook for a github organization to deliver event notifications to a configured url."
872 + "description": "Creates a webhook for a GitHub organization to deliver event notifications to a configured URL."
873 },
874 {
875 "slug": "GITHUB_CREATE_A_PROJECT_CARD",
876 "name": "Create a project card",
822 - "description": "Creates a project card in a github project column; the request body must contain either a `note` for a note-only card, or both `content id` (id of an issue or pull request) and `content type` (e.g., 'issue', 'pullrequest')."
877 + "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"
878 },
879 {
880 "slug": "GITHUB_CREATE_A_PROJECT_COLUMN",
826 - "name": "Create a project column",
827 - "description": "Creates a new column in a github project (classic)."
881 + "name": "Create a project column (Classic - Deprecated)",
882 + "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/"
883 },
884 {
885 "slug": "GITHUB_CREATE_A_PULL_REQUEST",
886 "name": "Create a pull request",
832 - "description": "Creates a pull request in a github repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided."
887 + "description": "Creates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided."
888 },
889 {
890 "slug": "GITHUB_CREATE_A_REFERENCE",
891 "name": "Create a reference",
837 - "description": "Creates a git reference (e.g., a branch or tag) in a repository; the repository must not be empty prior to this operation."
892 + "description": "Creates a NEW Git reference (branch or tag) in a repository. IMPORTANT: This action ONLY creates NEW references - if the reference already exists, it will fail with a 422 'Reference already exists' error. To update an existing reference, use the 'Update a reference' (GITHUB_UPDATE_A_REFERENCE) action instead. The repository must not be empty prior to this operation."
893 },
894 {
895 "slug": "GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_AN_ORGANIZATION",
896 "name": "Create a registration token for an organization",
842 - "description": "Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for github actions."
897 + "description": "Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for GitHub Actions."
898 },
899 {
900 "slug": "GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_A_REPOSITORY",
@@ -849,7 +904,7 @@
904 {
905 "slug": "GITHUB_CREATE_A_RELEASE",
906 "name": "Create a release",
852 - "description": "Creates a release in a github repository for a specified tag; the tag must be unique for published releases, and if a `discussion category name` is given, it must already exist."
907 + "description": "Creates a release in a GitHub repository for a specified tag; the tag must be unique for published releases, and if a `discussion_category_name` is given, it must already exist."
908 },
909 {
910 "slug": "GITHUB_CREATE_A_REMOVE_TOKEN_FOR_AN_ORGANIZATION",
@@ -864,17 +919,17 @@
919 {
920 "slug": "GITHUB_CREATE_A_REPLY_FOR_A_REVIEW_COMMENT",
921 "name": "Create a reply for a review comment",
867 - "description": "Posts a reply to a specific review comment on a github pull request, requiring the repository, pull request, and original comment to exist, and a non-empty reply body."
922 + "description": "Posts a reply to a specific review comment on a GitHub pull request, requiring the repository, pull request, and original comment to exist, and a non-empty reply body."
923 },
924 {
925 "slug": "GITHUB_CREATE_A_REPOSITORY_DISPATCH_EVENT",
926 "name": "Create a repository dispatch event",
872 - "description": "Triggers a github actions workflow or a webhook on a repository by creating a repository dispatch event, allowing programmatic triggering of workflows based on events outside of github."
927 + "description": "Triggers a GitHub Actions workflow or a webhook on a repository by creating a repository dispatch event, allowing programmatic triggering of workflows based on events outside of GitHub."
928 },
929 {
930 "slug": "GITHUB_CREATE_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER",
931 "name": "Create a repository for the authenticated user",
877 - "description": "Creates a new repository for the authenticated user, optionally within an organization if `team id` is specified."
932 + "description": "Creates a new repository for the authenticated user, optionally within an organization if `team_id` is specified."
933 },
934 {
935 "slug": "GITHUB_CREATE_A_REPOSITORY_FROM_AN_UNPUBLISHED_CODESPACE",
@@ -884,7 +939,7 @@
939 {
940 "slug": "GITHUB_CREATE_A_REPOSITORY_PROJECT",
941 "name": "Create a repository project",
887 - "description": "Creates a new classic project board within a specified repository; classic projects must be enabled for the target repository."
942 + "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."
943 },
944 {
945 "slug": "GITHUB_CREATE_A_REPOSITORY_RULESET",
@@ -899,7 +954,7 @@
954 {
955 "slug": "GITHUB_CREATE_A_REPOSITORY_VARIABLE",
956 "name": "Create a repository variable",
902 - "description": "Creates a new, unencrypted variable in a repository for github actions workflows; fails if a variable with the same name already exists."
957 + "description": "Creates a new, unencrypted variable in a repository for GitHub Actions workflows; fails if a variable with the same name already exists."
958 },
959 {
960 "slug": "GITHUB_CREATE_A_REPOSITORY_WEBHOOK",
@@ -914,52 +969,52 @@
969 {
970 "slug": "GITHUB_CREATE_A_REVIEW_FOR_A_PULL_REQUEST",
971 "name": "Create a review for a pull request",
917 - "description": "Creates a pull request review, allowing approval, change requests, or comments; `body` is required if `event` is `request changes` or `comment`, and omitting `event` makes the review `pending`."
972 + "description": "Creates a pull request review, allowing approval, change requests, or comments; `body` is required if `event` is `REQUEST_CHANGES` or `COMMENT`, and omitting `event` makes the review `PENDING`."
973 },
974 {
975 "slug": "GITHUB_CREATE_A_SCOPED_ACCESS_TOKEN",
976 "name": "Create a scoped access token",
922 - "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."
977 + "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."
978 },
979 {
980 "slug": "GITHUB_CREATE_A_SNAPSHOT_OF_DEPENDENCIES_FOR_A_REPOSITORY",
981 "name": "Create a dependency snapshot",
927 - "description": "Creates a snapshot of a repository's dependencies to populate the github dependency graph and enable security alerts; `sha` must be a 40-character commit id, `ref` a fully qualified git reference (e.g., `refs/heads/main`), and `scanned` an iso 8601 timestamp."
982 + "description": "Creates a snapshot of a repository's dependencies to populate the GitHub dependency graph and enable security alerts; `sha` must be a 40-character commit ID, `ref` a fully qualified Git reference (e.g., `refs/heads/main`), and `scanned` an ISO 8601 timestamp."
983 },
984 {
985 "slug": "GITHUB_CREATE_A_TAG_OBJECT",
986 "name": "Create a tag object",
932 - "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."
987 + "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."
988 },
989 {
990 "slug": "GITHUB_CREATE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORY",
991 "name": "Create a tag protection state for a repository",
937 - "description": "Creates a tag protection rule for a repository using a glob pattern; note: tag protections are deprecated (sunset august 30, 2024), migrate to repository rulesets."
992 + "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."
993 },
994 {
995 "slug": "GITHUB_CREATE_A_TEAM",
996 "name": "Create a team",
942 - "description": "Creates a new team in an organization, optionally with maintainers, repositories, specific privacy, notification settings, or a parent team; if `parent team id` is given, `privacy` must be 'closed'."
997 + "description": "Creates a new team in an organization, optionally with maintainers, repositories, specific privacy, notification settings, or a parent team; if `parent_team_id` is given, `privacy` must be 'closed'."
998 },
999 {
1000 "slug": "GITHUB_CREATE_A_TEMPORARY_PRIVATE_FORK",
1001 "name": "Create a temporary private fork",
947 - "description": "Creates a temporary private fork of the specified repository to address a security vulnerability, linking the fork to a ghsa id that must be specifically associated with this repository; the fork may take up to 5 minutes to become accessible."
1002 + "description": "Creates a temporary private fork of the specified repository to address a security vulnerability, linking the fork to a GHSA ID that must be specifically associated with this repository; the fork may take up to 5 minutes to become accessible."
1003 },
1004 {
1005 "slug": "GITHUB_CREATE_A_TREE",
1006 "name": "Create a tree",
952 - "description": "Creates a new git tree object in a repository, defining file/directory structure by specifying tree entries, optionally building on a `base tree` sha; all provided shas must be valid."
1007 + "description": "Creates a new Git tree object in a repository, defining file/directory structure by specifying tree entries, optionally building on a `base_tree` SHA; all provided SHAs must be valid."
1008 },
1009 {
1010 "slug": "GITHUB_CREATE_A_USER_PROJECT",
1011 "name": "Create a user project",
957 - "description": "Creates a new github project board for the authenticated user to organize and track issues, pull requests, and notes."
1012 + "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."
1013 },
1014 {
1015 "slug": "GITHUB_CREATE_A_WORKFLOW_DISPATCH_EVENT",
1016 "name": "Create a workflow dispatch event",
962 - "description": "Manually triggers a github actions workflow identified by `workflow id` at a given `ref`, if the workflow is configured to accept `workflow dispatch` events."
1017 + "description": "Manually triggers a GitHub Actions workflow identified by `workflow_id` at a given `ref`, if the workflow is configured to accept `workflow_dispatch` events."
1018 },
1019 {
1020 "slug": "GITHUB_CREATE_COMMIT_SIGNATURE_PROTECTION",
@@ -969,12 +1024,12 @@
1024 {
1025 "slug": "GITHUB_CREATE_DEPLOYMENT_PROTECTION_RULE",
1026 "name": "Create a custom deployment protection rule on an environment",
972 - "description": "Enables a custom deployment protection rule for an existing environment in a repository by linking a configured github app (via `integration id`) to control deployments."
1027 + "description": "Enables a custom deployment protection rule for an existing environment in a repository by linking a configured GitHub App (via `integration_id`) to control deployments."
1028 },
1029 {
1030 "slug": "GITHUB_CREATE_JIT_RUNNER_CONFIG",
1031 "name": "Create JIT runner config for repo",
977 - "description": "Generates a temporary just-in-time (jit) configuration for a new self-hosted github actions runner for a repository; any specified non-default `runner group id` must be an existing runner group accessible by the repository."
1032 + "description": "Generates a temporary Just-In-Time (JIT) configuration for a new self-hosted GitHub Actions runner for a repository; any specified non-default `runner_group_id` must be an existing runner group accessible by the repository."
1033 },
1034 {
1035 "slug": "GITHUB_CREATE_OR_UPDATE_A_CUSTOM_PROPERTY_FOR_AN_ORGANIZATION",
@@ -984,32 +1039,32 @@
1039 {
1040 "slug": "GITHUB_CREATE_OR_UPDATE_AN_ENVIRONMENT",
1041 "name": "Create or update an environment",
987 - "description": "Creates a new environment or updates an existing one in a github repository, allowing configuration of deployment protection rules such as wait timers and reviewers; ensure `environment name` is url-encoded if it contains special characters."
1042 + "description": "Creates a new environment or updates an existing one in a GitHub repository, allowing configuration of deployment protection rules such as wait timers and reviewers; ensure `environment_name` is URL-encoded if it contains special characters."
1043 },
1044 {
1045 "slug": "GITHUB_CREATE_OR_UPDATE_AN_ENVIRONMENT_SECRET",
1046 "name": "Create or update an environment secret",
992 - "description": "Creates or updates an environment secret with an `encrypted value` that was encrypted using the public key identified by `key id` for the specified environment."
1047 + "description": "Creates or updates an environment secret with an `encrypted_value` that was encrypted using the public key identified by `key_id` for the specified environment."
1048 },
1049 {
1050 "slug": "GITHUB_CREATE_OR_UPDATE_AN_ORGANIZATION_SECRET",
1051 "name": "Create or update an organization secret",
997 - "description": "Creates or updates an organization secret for github actions, requiring its value to be pre-encrypted via libsodium using the organization's public key."
1052 + "description": "Creates or updates an organization secret for GitHub Actions, requiring its value to be pre-encrypted via LibSodium using the organization's public key."
1053 },
1054 {
1055 "slug": "GITHUB_CREATE_OR_UPDATE_A_REPOSITORY_SECRET",
1056 "name": "Create or update a repository secret",
1002 - "description": "Creates or updates a github actions secret within a specific repository; use `encrypted value` and `key id` to set or change its value."
1057 + "description": "Creates or updates a GitHub Actions secret within a specific repository; use `encrypted_value` and `key_id` to set or change its value."
1058 },
1059 {
1060 "slug": "GITHUB_CREATE_OR_UPDATE_A_SECRET_FOR_THE_AUTHENTICATED_USER",
1061 "name": "Create or update a secret for the authenticated user",
1007 - "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."
1062 + "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."
1063 },
1064 {
1010 - "slug": "GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATION",
1065 + "slug": "GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORG",
1066 "name": "Create or update custom properties for an organization",
1012 - "description": "Creates new custom property schemas or updates existing ones in bulk for a specified organization; each property definition must include `property name` and `value type`."
1067 + "description": "Creates new custom property schemas or updates existing ones in bulk for a specified organization; each property definition must include `property_name` and `value_type`."
1068 },
1069 {
1070 "slug": "GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTY_VALUES_FOR_A_REPOSITORY",
@@ -1019,12 +1074,17 @@
1074 {
1075 "slug": "GITHUB_CREATE_OR_UPDATE_FILE_CONTENTS",
1076 "name": "Create or update file contents",
1022 - "description": "Creates a new file or updates an existing file in a github repository; provide `sha` to update an existing file, otherwise a new file is created."
1077 + "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."
1078 + },
1079 + {
1080 + "slug": "GITHUB_CREATE_OR_UPDATE_GITHUB_PAGES_SITE",
1081 + "name": "Create or Update GitHub Pages Site",
1082 + "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."
1083 },
1084 {
1085 "slug": "GITHUB_CREATE_OR_UPDATE_REPO_SECRET_WITH_ENCRYPTED_VALUE",
1086 "name": "Create or update repo secret with encrypted value",
1027 - "description": "Creates or updates a dependabot secret in a repository using an `encrypted value` (pre-encrypted with libsodium using the repository's dependabot public key) and its corresponding `key id`."
1087 + "description": "Creates or updates a Dependabot secret in a repository using an `encrypted_value` (pre-encrypted with LibSodium using the repository's Dependabot public key) and its corresponding `key_id`. This action allows you to securely manage secrets for a given repository, ensuring that sensitive data remains protected during the update process. By providing the encrypted value alongside the key ID, you can seamlessly maintain the necessary credentials for your repository's operations."
1088 },
1089 {
1090 "slug": "GITHUB_CREATE_REACTION_FOR_A_COMMIT_COMMENT",
@@ -1034,27 +1094,27 @@
1094 {
1095 "slug": "GITHUB_CREATE_REACTION_FOR_AN_ISSUE",
1096 "name": "Create reaction for an issue",
1037 - "description": "Creates a reaction for a specified issue within a github repository."
1097 + "description": "Creates a reaction for a specified issue within a GitHub repository."
1098 },
1099 {
1100 "slug": "GITHUB_CREATE_REACTION_FOR_AN_ISSUE_COMMENT",
1101 "name": "Create reaction for an issue comment",
1042 - "description": "Creates a reaction for a specific comment on an issue within a github repository."
1102 + "description": "Creates a reaction for a specific comment on an issue within a GitHub repository."
1103 },
1104 {
1105 "slug": "GITHUB_CREATE_REACTION_FOR_A_PULL_REQUEST_REVIEW_COMMENT",
1106 "name": "Create reaction for a pull request review comment",
1047 - "description": "Adds a specified reaction to a pull request review comment within a github repository."
1107 + "description": "Adds a specified reaction to a pull request review comment within a GitHub repository."
1108 },
1109 {
1110 "slug": "GITHUB_CREATE_REACTION_FOR_A_RELEASE",
1111 "name": "Create reaction for a release",
1052 - "description": "Creates an emoji reaction for a specific, existing release in a github repository."
1112 + "description": "Creates an emoji reaction for a specific, existing release in a GitHub repository."
1113 },
1114 {
1115 "slug": "GITHUB_CREATE_REACTION_FOR_A_TEAM_DISCUSSION",
1116 "name": "Create reaction for a team discussion",
1057 - "description": "Creates a reaction for a team discussion within a github organization."
1117 + "description": "Creates a reaction for a team discussion within a GitHub organization."
1118 },
1119 {
1120 "slug": "GITHUB_CREATE_REACTION_FOR_A_TEAM_DISCUSSION_COMMENT",
@@ -1064,27 +1124,27 @@
1124 {
1125 "slug": "GITHUB_CREATE_UPDATE_ORG_SECRET_WITH_LIB_SODIUM",
1126 "name": "Create or Update Organization Secret with LibSodium",
1067 - "description": "Creates or updates a dependabot organization secret, requiring the secret value to be pre-encrypted with libsodium using the organization's public key obtained from the 'get an organization public key' endpoint."
1127 + "description": "Creates or updates a Dependabot organization secret, requiring the secret value to be pre-encrypted with LibSodium using the organization's public key obtained from the 'Get an organization public key' endpoint."
1128 },
1129 {
1130 "slug": "GITHUB_CUSTOMIZE_OIDC_SUBJECT_CLAIM_TEMPLATE",
1131 "name": "Customize OIDC subject claim template",
1072 - "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."
1132 + "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."
1133 },
1134 {
1135 "slug": "GITHUB_CUSTOM_OIDCSUBJECT_CLAIM_TEMPLATE",
1136 "name": "Get custom OIDC subject claim template",
1077 - "description": "Retrieves the openid connect (oidc) subject claim customization template for a github organization, which defines how the `sub` claim in oidc tokens for workflows is constructed."
1137 + "description": "Retrieves the OpenID Connect (OIDC) subject claim customization template for a GitHub organization, which defines how the `sub` claim in OIDC tokens for workflows is constructed."
1138 },
1139 {
1140 "slug": "GITHUB_CUSTOM_OIDCSUBJECT_CLAIM_TEMPLATE_SETTER",
1141 "name": "Set custom OIDC subject claim template",
1082 - "description": "Sets the openid connect (oidc) subject claim template for a github repository, allowing use of the default template or a custom one defined by `include claim keys` if `use default` is `false`."
1142 + "description": "Sets the OpenID Connect (OIDC) subject claim template for a GitHub repository, allowing use of the default template or a custom one defined by `include_claim_keys` if `use_default` is `false`."
1143 },
1144 {
1145 "slug": "GITHUB_DECLINE_A_REPOSITORY_INVITATION",
1146 "name": "Decline a repository invitation",
1087 - "description": "Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation id`."
1147 + "description": "Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation_id`."
1148 },
1149 {
1150 "slug": "GITHUB_DELETE_ACCESS_RESTRICTIONS",
@@ -1094,7 +1154,7 @@
1154 {
1155 "slug": "GITHUB_DELETE_A_CODE_SCANNING_ANALYSIS_FROM_A_REPOSITORY",
1156 "name": "Delete a code scanning analysis from a repository",
1097 - "description": "Deletes a specific code scanning analysis by its id from a repository; `confirm delete` must be `true` if it's the last analysis of its type for a given tool and reference to prevent data loss."
1157 + "description": "Deletes a specific code scanning analysis by its ID from a repository; `confirm_delete` must be `true` if it's the last analysis of its type for a given tool and reference to prevent data loss."
1158 },
1159 {
1160 "slug": "GITHUB_DELETE_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
@@ -1109,17 +1169,17 @@
1169 {
1170 "slug": "GITHUB_DELETE_A_COMMIT_COMMENT",
1171 "name": "Delete a commit comment",
1112 - "description": "Deletes a specific commit comment, identified by its `comment id`, from the specified repository; the comment must exist."
1172 + "description": "Deletes a specific commit comment, identified by its `comment_id`, from the specified repository; the comment must exist."
1173 },
1174 {
1175 "slug": "GITHUB_DELETE_A_COMMIT_COMMENT_REACTION",
1176 "name": "Delete a commit comment reaction",
1117 - "description": "Deletes a reaction from a commit comment in a github repository."
1177 + "description": "Deletes a reaction from a commit comment in a GitHub repository."
1178 },
1179 {
1180 "slug": "GITHUB_DELETE_A_CUSTOM_ORGANIZATION_ROLE",
1181 "name": "Delete a custom organization role",
1122 - "description": "Deletes a custom organization role (which should not be actively assigned) by its id; a 204 no content response indicates success."
1182 + "description": "Deletes a custom organization role (which should not be actively assigned) by its ID; a 204 No Content response indicates success."
1183 },
1184 {
1185 "slug": "GITHUB_DELETE_A_DEPLOY_KEY",
@@ -1134,7 +1194,7 @@
1194 {
1195 "slug": "GITHUB_DELETE_A_DEPLOYMENT_BRANCH_POLICY",
1196 "name": "Delete a deployment branch policy",
1137 - "description": "Deletes a specific deployment branch or tag policy, identified by its id, from a given environment within a repository."
1197 + "description": "Deletes a specific deployment branch or tag policy, identified by its ID, from a given environment within a repository."
1198 },
1199 {
1200 "slug": "GITHUB_DELETE_A_DISCUSSION",
@@ -1154,22 +1214,22 @@
1214 {
1215 "slug": "GITHUB_DELETE_A_FILE",
1216 "name": "Delete a file",
1157 - "description": "Deletes a file by path from a github repository, requiring a commit message and the file's current blob sha to confirm the deletion."
1217 + "description": "Deletes a file by path from a GitHub repository. The file's blob SHA is automatically fetched if not provided."
1218 },
1219 {
1220 "slug": "GITHUB_DELETE_A_GIST",
1221 "name": "Delete a gist",
1162 - "description": "Permanently deletes an existing github gist, specified by its `gist id`; this action is destructive and cannot be undone."
1222 + "description": "Permanently deletes an existing GitHub gist, specified by its `gist_id`; this action is destructive and cannot be undone."
1223 },
1224 {
1225 "slug": "GITHUB_DELETE_A_GIST_COMMENT",
1226 "name": "Delete a gist comment",
1167 - "description": "Deletes a specific comment from a github gist using its `gist id` and `comment id`."
1227 + "description": "Deletes a specific comment from a GitHub Gist using its `gist_id` and `comment_id`."
1228 },
1229 {
1230 "slug": "GITHUB_DELETE_A_GITHUB_PAGES_SITE",
1231 "name": "Delete a GitHub Pages site",
1172 - "description": "Deletes the github pages site for the specified repository; completes without error if no site is currently enabled."
1232 + "description": "Deletes the GitHub Pages site for the specified repository; completes without error if no site is currently enabled."
1233 },
1234 {
1235 "slug": "GITHUB_DELETE_A_LABEL",
@@ -1184,27 +1244,27 @@
1244 {
1245 "slug": "GITHUB_DELETE_AN_APP_AUTHORIZATION",
1246 "name": "Delete an app authorization",
1187 - "description": "Revokes a single, specific oauth access token for an oauth app, not all authorizations for the app."
1247 + "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."
1248 },
1249 {
1250 "slug": "GITHUB_DELETE_AN_APP_TOKEN",
1251 "name": "Delete an app token",
1192 - "description": "Revokes an oauth access token for a github app, if the app exists and the token was issued to it."
1252 + "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."
1253 },
1254 {
1255 "slug": "GITHUB_DELETE_AN_ARTIFACT",
1256 "name": "Delete an artifact",
1197 - "description": "Deletes a github artifact by its id within a repository, typically resulting in an empty response (http 204 no content) on success."
1257 + "description": "Deletes a GitHub artifact by its ID within a repository, typically resulting in an empty response (HTTP 204 No Content) on success."
1258 },
1259 {
1260 "slug": "GITHUB_DELETE_AN_AUTOLINK_REFERENCE_FROM_A_REPOSITORY",
1261 "name": "Delete an autolink reference from a repository",
1202 - "description": "Deletes a specific autolink reference (which automatically links external resource ids like jira-123 to urls) from the specified repository."
1262 + "description": "Deletes a specific autolink reference (which automatically links external resource IDs like JIRA-123 to URLs) from the specified repository."
1263 },
1264 {
1265 "slug": "GITHUB_DELETE_AN_EMAIL_ADDRESS_FOR_THE_AUTHENTICATED_USER",
1266 "name": "Delete authenticated user email address",
1207 - "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."
1267 + "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."
1268 },
1269 {
1270 "slug": "GITHUB_DELETE_AN_ENVIRONMENT",
@@ -1214,17 +1274,17 @@
1274 {
1275 "slug": "GITHUB_DELETE_AN_ENVIRONMENT_SECRET",
1276 "name": "Delete an environment secret",
1217 - "description": "Deletes an existing and accessible secret from a specified environment within a github repository, returning an empty dictionary on success or error details otherwise."
1277 + "description": "Deletes an existing and accessible secret from a specified environment within a GitHub repository, returning an empty dictionary on success or error details otherwise."
1278 },
1279 {
1280 "slug": "GITHUB_DELETE_AN_ENVIRONMENT_VARIABLE",
1281 "name": "Delete an environment variable",
1222 - "description": "Deletes a named environment variable from a specified, existing environment within a github repository."
1282 + "description": "Deletes a named environment variable from a specified, existing environment within a GitHub repository."
1283 },
1284 {
1285 "slug": "GITHUB_DELETE_AN_ISSUE_COMMENT",
1286 "name": "Delete an issue comment",
1227 - "description": "Permanently deletes a specific comment by its id from an issue or pull request, if the repository exists and the comment id is valid."
1287 + "description": "Permanently deletes a specific comment by its ID from an issue or pull request, if the repository exists and the comment ID is valid."
1288 },
1289 {
1290 "slug": "GITHUB_DELETE_AN_ISSUE_COMMENT_REACTION",
@@ -1234,27 +1294,27 @@
1294 {
1295 "slug": "GITHUB_DELETE_AN_ISSUE_REACTION",
1296 "name": "Delete an issue reaction",
1237 - "description": "Permanently removes a specific reaction from an issue in a github repository."
1297 + "description": "Permanently removes a specific reaction from an issue in a GitHub repository."
1298 },
1299 {
1300 "slug": "GITHUB_DELETE_AN_ORGANIZATION",
1301 "name": "Delete an organization",
1242 - "description": "Deletes a github organization and its repositories; this is a destructive action and the organization name will be unavailable for reuse for approximately 90 days."
1302 + "description": "Deletes a GitHub organization and its repositories; this is a destructive action and the organization name will be unavailable for reuse for approximately 90 days."
1303 },
1304 {
1305 "slug": "GITHUB_DELETE_AN_ORGANIZATION_SECRET",
1306 "name": "Delete an organization secret",
1247 - "description": "Permanently deletes a secret from a github organization, making it inaccessible to github actions workflows or other tools."
1307 + "description": "Permanently deletes a secret from a GitHub organization, making it inaccessible to GitHub Actions workflows or other tools."
1308 },
1309 {
1310 "slug": "GITHUB_DELETE_AN_ORGANIZATION_VARIABLE",
1311 "name": "Delete an organization variable",
1252 - "description": "Deletes a named github actions variable from a specified organization."
1312 + "description": "Deletes a named GitHub Actions variable from a specified organization."
1313 },
1314 {
1315 "slug": "GITHUB_DELETE_AN_ORGANIZATION_WEBHOOK",
1316 "name": "Delete an organization webhook",
1257 - "description": "Deletes a specific webhook, identified by `hook id`, from an existing organization."
1317 + "description": "Deletes a specific webhook, identified by `hook_id`, from an existing organization."
1318 },
1319 {
1320 "slug": "GITHUB_DELETE_A_PACKAGE_FOR_AN_ORGANIZATION",
@@ -1264,12 +1324,12 @@
1324 {
1325 "slug": "GITHUB_DELETE_A_PACKAGE_FOR_A_USER",
1326 "name": "Delete a package for a user",
1267 - "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."
1327 + "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."
1328 },
1329 {
1330 "slug": "GITHUB_DELETE_A_PACKAGE_FOR_THE_AUTHENTICATED_USER",
1331 "name": "Delete a package for the authenticated user",
1272 - "description": "Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this api."
1332 + "description": "Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API."
1333 },
1334 {
1335 "slug": "GITHUB_DELETE_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USER",
@@ -1284,17 +1344,17 @@
1344 {
1345 "slug": "GITHUB_DELETE_A_PROJECT",
1346 "name": "Delete a project",
1287 - "description": "Deletes the github project specified by `project id` if the project exists and the projects feature is enabled for its repository or organization; a successful deletion results in a 204 no content response."
1347 + "description": "Deletes the specified GitHub project (Projects V2) using the GraphQL API. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025 and is no longer available. The project is permanently deleted and cannot be recovered. The user must have admin permissions for the project to delete it."
1348 },
1349 {
1350 "slug": "GITHUB_DELETE_A_PROJECT_CARD",
1291 - "name": "Delete a project card",
1292 - "description": "Deletes a project card from a github 'project (classic)'; this operation is idempotent."
1351 + "name": "Delete a project card (Classic - Deprecated)",
1352 + "description": "Deletes a project card from a GitHub 'Project (classic)'; this operation is idempotent. DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action may 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/"
1353 },
1354 {
1355 "slug": "GITHUB_DELETE_A_PROJECT_COLUMN",
1296 - "name": "Delete a project column",
1297 - "description": "Deletes a project column by its id from a github project (classic); this is a destructive operation."
1356 + "name": "Delete a project field (column)",
1357 + "description": "Deletes a project field (column) from a GitHub Projects V2 project using the GraphQL API. IMPORTANT: GitHub Classic Projects REST API was sunset on April 1, 2025. This action now uses the GitHub Projects V2 GraphQL API with the deleteProjectV2Field mutation. Note: The built-in Status field cannot be deleted as it is a core field in GitHub Projects V2. Only custom fields can be deleted."
1358 },
1359 {
1360 "slug": "GITHUB_DELETE_A_PULL_REQUEST_COMMENT_REACTION",
@@ -1304,22 +1364,22 @@
1364 {
1365 "slug": "GITHUB_DELETE_A_REFERENCE",
1366 "name": "Delete a reference",
1307 - "description": "Deletes a git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag')."
1367 + "description": "Deletes a Git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag')."
1368 },
1369 {
1370 "slug": "GITHUB_DELETE_A_RELEASE",
1371 "name": "Delete a release",
1312 - "description": "Permanently deletes a specific release, its assets, and potentially its associated git tag from a repository."
1372 + "description": "Permanently deletes a specific release, its assets, and potentially its associated Git tag from a repository."
1373 },
1374 {
1375 "slug": "GITHUB_DELETE_A_RELEASE_ASSET",
1376 "name": "Delete a release asset",
1317 - "description": "Deletes a specific release asset from a github repository; this action is idempotent."
1377 + "description": "Deletes a specific release asset from a GitHub repository; this action is idempotent."
1378 },
1379 {
1380 "slug": "GITHUB_DELETE_A_RELEASE_REACTION",
1381 "name": "Delete a release reaction",
1322 - "description": "Deletes a reaction from a github release, provided the repository, release, and reaction exist."
1382 + "description": "Deletes a reaction from a GitHub release, provided the repository, release, and reaction exist."
1383 },
1384 {
1385 "slug": "GITHUB_DELETE_A_REPOSITORY",
@@ -1339,7 +1399,7 @@
1399 {
1400 "slug": "GITHUB_DELETE_A_REPOSITORY_SECRET",
1401 "name": "Delete a repository secret",
1342 - "description": "Deletes a named github actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist."
1402 + "description": "Deletes a named GitHub Actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist."
1403 },
1404 {
1405 "slug": "GITHUB_DELETE_A_REPOSITORY_SUBSCRIPTION",
@@ -1349,7 +1409,7 @@
1409 {
1410 "slug": "GITHUB_DELETE_A_REPOSITORY_VARIABLE",
1411 "name": "Delete a repository variable",
1352 - "description": "Deletes a named variable (e.g., for github actions workflows) from a repository; the repository and the variable must already exist."
1412 + "description": "Deletes a named variable (e.g., for GitHub Actions workflows) from a repository; the repository and the variable must already exist."
1413 },
1414 {
1415 "slug": "GITHUB_DELETE_A_REPOSITORY_WEBHOOK",
@@ -1364,22 +1424,22 @@
1424 {
1425 "slug": "GITHUB_DELETE_A_SECRET_FOR_THE_AUTHENTICATED_USER",
1426 "name": "Delete a secret for the authenticated user",
1367 - "description": "Deletes an existing codespaces secret for the authenticated user by `secret name`; this is a destructive, irreversible, and idempotent operation."
1427 + "description": "Deletes an existing Codespaces secret for the authenticated user by `secret_name`. This is a destructive and irreversible operation. Returns 404 if the secret does not exist."
1428 },
1429 {
1430 "slug": "GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_AN_ORGANIZATION",
1431 "name": "Delete a self hosted runner from an organization",
1372 - "description": "Deletes an existing and registered self-hosted runner from an organization, typically returning 204 no content on success."
1432 + "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."
1433 },
1434 {
1435 "slug": "GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_A_REPOSITORY",
1436 "name": "Delete a self hosted runner from a repository",
1377 - "description": "Removes a specific self-hosted runner (by `runner id`) from a repository, if registered there; this is idempotent."
1437 + "description": "Removes a specific self-hosted runner (by `runner_id`) from a repository, if registered there; this is idempotent."
1438 },
1439 {
1440 "slug": "GITHUB_DELETE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORY",
1441 "name": "Delete a tag protection state for a repository",
1382 - "description": "Permanently deletes a specific tag protection rule, identified by its id, from the given repository."
1442 + "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."
1443 },
1444 {
1445 "slug": "GITHUB_DELETE_A_TEAM",
@@ -1399,22 +1459,22 @@
1459 {
1460 "slug": "GITHUB_DELETE_BRANCH_PROTECTION",
1461 "name": "Delete branch protection",
1402 - "description": "Removes all protection rules from a specific branch in a github repository; the branch must currently have protection rules enabled."
1462 + "description": "Removes all protection rules from a specific branch in a GitHub repository; the branch must currently have protection rules enabled."
1463 },
1464 {
1465 "slug": "GITHUB_DELETE_COMMIT_SIGNATURE_PROTECTION",
1466 "name": "Delete commit signature protection",
1407 - "description": "Disables gpg commit signature protection for a specific branch in a github repository, meaning commits pushed to this branch no longer require gpg signing."
1467 + "description": "Disables GPG commit signature protection for a specific branch in a GitHub repository, meaning commits pushed to this branch no longer require GPG signing."
1468 },
1469 {
1470 "slug": "GITHUB_DELETE_DEPENDEBOT_SECRET_BY_NAME",
1471 "name": "Delete dependabot secret by name",
1412 - "description": "Deletes a specific dependabot secret, identified by its name, from a given repository if both the repository and secret exist."
1472 + "description": "Deletes a specific Dependabot secret, identified by its name, from a given repository if both the repository and secret exist."
1473 },
1474 {
1475 "slug": "GITHUB_DELETE_GITHUB_ACTIONS_CACHE_BY_ID",
1476 "name": "Delete GitHub Actions cache by ID",
1417 - "description": "Deletes a specific github actions cache from a repository using its unique `cache id`."
1477 + "description": "Deletes a specific GitHub Actions cache from a repository using its unique `cache_id`."
1478 },
1479 {
1480 "slug": "GITHUB_DELETE_PACKAGE_VERSION_FOR_AN_ORGANIZATION",
@@ -1434,17 +1494,17 @@
1494 {
1495 "slug": "GITHUB_DELETE_REPO_CODESPACE_SECRET_BY_NAME",
1496 "name": "Delete repo codespace secret by name",
1437 - "description": "Deletes a specific codespace secret from a repository by its name; this action is idempotent and will succeed even if the secret doesn't exist."
1497 + "description": "Deletes a specific Codespace secret from a repository by its name; this action is idempotent and will succeed even if the secret doesn't exist."
1498 },
1499 {
1500 "slug": "GITHUB_DELETE_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER",
1501 "name": "Delete social accounts for the authenticated user",
1442 - "description": "Deletes currently linked social media account urls from the authenticated user's github profile."
1502 + "description": "Deletes currently linked social media account URLs from the authenticated user's GitHub profile."
1503 },
1504 {
1505 "slug": "GITHUB_DELETE_TEAM_DISCUSSION_COMMENT_REACTION",
1506 "name": "Delete team discussion comment reaction",
1447 - "description": "Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction id."
1507 + "description": "Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction ID."
1508 },
1509 {
1510 "slug": "GITHUB_DELETE_TEAM_DISCUSSION_REACTION",
@@ -1454,77 +1514,72 @@
1514 {
1515 "slug": "GITHUB_DELETE_WORKFLOW_RUN_LOGS",
1516 "name": "Delete workflow run logs",
1457 - "description": "Deletes all logs for a specific workflow run in a github repository, provided the repository and run exist."
1517 + "description": "Deletes all logs for a specific workflow run in a GitHub repository, provided the repository and run exist."
1518 },
1519 {
1520 "slug": "GITHUB_DISABLE_A_CUSTOM_PROTECTION_RULE_FOR_AN_ENVIRONMENT",
1521 "name": "Disable a custom protection rule for an environment",
1462 - "description": "Disables a specific, currently active custom deployment protection rule for an existing environment within a github repository."
1522 + "description": "Disables a specific, currently active custom deployment protection rule for an existing environment within a GitHub repository."
1523 },
1524 {
1525 "slug": "GITHUB_DISABLE_A_WORKFLOW",
1526 "name": "Disable a workflow",
1467 - "description": "Disables a specified workflow (by id or filename) in a given github repository, preventing new automatic triggers; any in-progress runs will continue."
1527 + "description": "Disables a specified workflow (by ID or filename) in a given GitHub repository, preventing new automatic triggers; any in-progress runs will continue."
1528 },
1529 {
1530 "slug": "GITHUB_DISABLE_PRIVATE_VULNERABILITY_REPORTING_FOR_A_REPOSITORY",
1531 "name": "Disable private vulnerability reporting for a repository",
1472 - "description": "Disables private vulnerability reporting for an existing github repository, preventing direct private vulnerability reports to maintainers via github's interface for this repository."
1532 + "description": "Disables private vulnerability reporting for an existing GitHub repository, preventing direct private vulnerability reports to maintainers via GitHub's interface for this repository."
1533 },
1534 {
1535 "slug": "GITHUB_DISABLE_REPOSITORY_ACTIONS_IN_ORG",
1476 - "name": "Disablerepositoryactionsinorg",
1477 - "description": "Disables github actions for a specific repository within an organization; this action is only effective if the organization's github actions `enabled repositories` setting is configured to `selected`."
1536 + "name": "Disable Repository Actions In Org",
1537 + "description": "Removes a repository from the list of selected repositories enabled for GitHub Actions in an organization. Only works when the organization's `enabled_repositories` policy is set to `selected`. Requires admin:org scope."
1538 },
1539 {
1540 "slug": "GITHUB_DISMISS_A_REVIEW_FOR_A_PULL_REQUEST",
1541 "name": "Dismiss a review for a pull request",
1482 - "description": "Dismisses a review on a pull request with a mandatory explanatory message."
1542 + "description": "Dismisses an APPROVED or CHANGES_REQUESTED review on a pull request with a mandatory explanatory message. IMPORTANT: Only reviews in APPROVED or CHANGES_REQUESTED state can be dismissed. Reviews in COMMENTED, PENDING, or already DISMISSED state will return a 422 error. To dismiss a review on a protected branch, you must be a repository admin or be authorized to dismiss pull request reviews."
1543 },
1544 {
1545 "slug": "GITHUB_DOWNLOAD_AN_ARTIFACT",
1546 "name": "Download an artifact",
1487 - "description": "Downloads a specific github repository artifact, returning a temporary url to its 'zip' archive, valid for one minute."
1547 + "description": "Downloads a GitHub Actions workflow artifact as a ZIP file. Returns the artifact as a downloadable file. Use GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY or GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS to get valid artifact IDs first."
1548 },
1549 {
1550 "slug": "GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_TAR",
1551 "name": "Download a repository tarball",
1492 - "description": "Downloads a repository's source code as a tarball (.tar.gz) archive for a specific git reference, if the repository is accessible."
1552 + "description": "Downloads a repository's source code as a tarball (.tar.gz) archive for a specific Git reference, if the repository is accessible."
1553 },
1554 {
1555 "slug": "GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_ZIP",
1556 "name": "Download a repository archive ZIP",
1497 - "description": "Downloads a repository's source code as a zip archive for a specific git reference (branch, tag, or commit sha)."
1557 + "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."
1558 },
1559 {
1560 "slug": "GITHUB_DOWNLOAD_JOB_LOGS_FOR_A_WORKFLOW_RUN",
1561 "name": "Download job logs for a workflow run",
1502 - "description": "Downloads logs for a specific job in a github actions workflow run, contingent on the repository's existence and the job id being valid and having produced logs."
1562 + "description": "Downloads logs for a specific job in a GitHub Actions workflow run, contingent on the repository's existence and the job ID being valid and having produced logs."
1563 },
1564 {
1565 "slug": "GITHUB_DOWNLOAD_WORKFLOW_RUN_ATTEMPT_LOGS",
1566 "name": "Download workflow run attempt logs",
1507 - "description": "Downloads a zip archive of logs for a specific workflow run attempt."
1567 + "description": "Downloads a ZIP archive of logs for a specific workflow run attempt. Returns a downloadable ZIP file containing logs for all jobs and steps in the workflow run."
1568 },
1569 {
1570 "slug": "GITHUB_DOWNLOAD_WORKFLOW_RUN_LOGS",
1571 "name": "Download workflow run logs",
1512 - "description": "Downloads logs for a specific github actions workflow run, typically archived as a zip file, if logs are available (e.g., not expired and the workflow has produced output)."
1513 - },
1514 - {
1515 - "slug": "GITHUB_EMO_J_IS_GET",
1516 - "name": "Get emojis",
1517 - "description": "Lists all emojis available for use on github; deprecated, use `get emojis` instead."
1572 + "description": "Downloads logs for a specific GitHub Actions workflow run as a ZIP archive containing log files for each job in the workflow."
1573 },
1574 {
1575 "slug": "GITHUB_ENABLE_A_WORKFLOW",
1576 "name": "Enable a workflow",
1522 - "description": "Reactivates a currently disabled github actions workflow within a repository using its numerical id."
1577 + "description": "Reactivates a currently disabled GitHub Actions workflow within a repository using its workflow ID or filename."
1578 },
1579 {
1580 "slug": "GITHUB_ENABLE_GITHUB_ACTIONS_IN_SELECTED_REPOSITORIES",
1581 "name": "Enable GitHub actions in selected repositories",
1527 - "description": "Sets the specific repositories that can use github actions within an organization by replacing the current list; only applies if the organization's actions policy is 'selected repositories'."
1582 + "description": "Sets the specific repositories that can use GitHub Actions within an organization by replacing the current list; only applies if the organization's Actions policy is 'selected repositories'."
1583 },
1584 {
1585 "slug": "GITHUB_ENABLE_PRIVATE_VULNERABILITY_REPORTING_FOR_A_REPOSITORY",
@@ -1534,57 +1589,57 @@
1589 {
1590 "slug": "GITHUB_ENABLE_REPO_FORGITHUB_ACTIONS",
1591 "name": "Enable repo for Github Actions",
1537 - "description": "Enables github actions for a repository if the organization's actions permissions are set to allow for 'selected repositories'."
1592 + "description": "Adds a repository to the list of selected repositories enabled for GitHub Actions in an organization. Requires the organization's 'enabled_repositories' policy to be set to 'selected'."
1593 },
1594 {
1595 "slug": "GITHUB_ENCRYPT_AND_UPDATE_DEV_SECRET",
1596 "name": "Encrypt and update dev secret",
1542 - "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."
1597 + "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."
1598 },
1599 {
1600 "slug": "GITHUB_ENCRYPT_ORG_DEV_ENV_SECRET",
1601 "name": "Encrypt org dev env secret",
1547 - "description": "Creates or updates an organization's github codespaces secret using an encrypted value and its corresponding public key id."
1602 + "description": "Creates or updates an organization's GitHub Codespaces secret using an encrypted value and its corresponding public key ID."
1603 },
1604 {
1605 "slug": "GITHUB_ENCRYPT_ORG_SECRETS_USING_PUBLIC_KEY",
1551 - "name": "Encrypt org secrets using public key",
1552 - "description": "Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for codespaces."
1606 + "name": "Get organization public key for Codespaces secrets",
1607 + "description": "Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for Codespaces."
1608 },
1609 {
1610 "slug": "GITHUB_EXPORT_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
1611 "name": "Export a codespace for the authenticated user",
1557 - "description": "Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download url."
1612 + "description": "Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download URL."
1613 },
1614 {
1615 "slug": "GITHUB_EXPORT_A_SOFTWARE_BILL_OF_MATERIALS_SBOM_FOR_A_REPOSITORY",
1616 "name": "Export an SBOM for a repository",
1562 - "description": "Exports the software bill of materials (sbom) in spdx json format for a repository, if its dependency graph is enabled and it has at least one commit."
1617 + "description": "Exports the software bill of materials (SBOM) in SPDX JSON format for a repository, if its dependency graph is enabled and it has at least one commit."
1618 },
1619 {
1620 "slug": "GITHUB_FETCH_PUBLIC_KEY_FOR_SECRET_ENCRYPTION",
1566 - "name": "Fetchpublickeyforsecretencryption",
1567 - "description": "Retrieves the public key for an existing github organization, required for encrypting dependabot secrets."
1621 + "name": "Fetch Public Key For Secret Encryption",
1622 + "description": "Retrieves the public key for an existing GitHub organization, required for encrypting Dependabot secrets. Requires admin:org scope."
1623 },
1624 {
1625 "slug": "GITHUB_FIND_PULL_REQUESTS",
1626 "name": "Find Pull Requests",
1572 - "description": "Ai-optimized pull request search with smart filtering by repo, author, state, labels, and merge status. builds intelligent search queries and returns clean, actionable pr data."
1627 + "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."
1628 },
1629 {
1630 "slug": "GITHUB_FIND_REPOSITORIES",
1631 "name": "Find Repositories",
1577 - "description": "Ai-optimized repository search with smart filtering by language, stars, topics, and ownership. builds intelligent search queries and returns clean, actionable repository data."
1632 + "description": "AI-optimized repository search with smart filtering by language, stars, topics, and ownership. Builds intelligent search queries and returns clean, actionable repository data."
1633 },
1634 {
1635 "slug": "GITHUB_FOLLOW_A_USER",
1636 "name": "Follow a user",
1582 - "description": "Allows the authenticated user to follow the github user specified by `username`; this action is idempotent and the user cannot follow themselves."
1637 + "description": "Allows the authenticated user to follow the GitHub user specified by `username`; this action is idempotent and the user cannot follow themselves."
1638 },
1639 {
1640 "slug": "GITHUB_FORCE_CANCEL_A_WORKFLOW_RUN",
1641 "name": "Force cancel a workflow run",
1587 - "description": "Forcefully cancels an existing github actions workflow run, bypassing normal cancellation conditions; requires write permissions to the repository."
1642 + "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."
1643 },
1644 {
1645 "slug": "GITHUB_FORK_A_GIST",
@@ -1594,57 +1649,57 @@
1649 {
1650 "slug": "GITHUB_GENERATE_RELEASE_NOTES_CONTENT_FOR_A_RELEASE",
1651 "name": "Generate release notes content for a release",
1597 - "description": "Generates markdown release notes content (listing changes, pull requests, and contributors) for a github repository release, customizable via tags and a configuration file."
1652 + "description": "Generates Markdown release notes content (listing changes, pull requests, and contributors) for a GitHub repository release, customizable via tags and a configuration file."
1653 },
1654 {
1655 "slug": "GITHUB_GET_A_BLOB",
1656 "name": "Get a blob",
1602 - "description": "Retrieves the raw, typically base64-encoded, content of a file (blob) from a github repository using its sha hash, if the repository and blob sha exist."
1657 + "description": "Retrieves the raw, typically Base64-encoded, content of a file (blob) from a GitHub repository using its SHA hash, if the repository and blob SHA exist."
1658 },
1659 {
1660 "slug": "GITHUB_GET_A_BRANCH",
1661 "name": "Get a branch",
1607 - "description": "Retrieves detailed information for a specified branch within a github repository."
1662 + "description": "Retrieves detailed information for a specified branch within a GitHub repository."
1663 },
1664 {
1665 "slug": "GITHUB_GET_ACCESS_RESTRICTIONS",
1666 "name": "Get access restrictions",
1612 - "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."
1667 + "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."
1668 },
1669 {
1670 "slug": "GITHUB_GET_A_CHECK_RUN",
1671 "name": "Get a check run",
1617 - "description": "Retrieves detailed information for a specific check run within a github repository."
1672 + "description": "Retrieves detailed information for a specific check run within a GitHub repository."
1673 },
1674 {
1675 "slug": "GITHUB_GET_A_CHECK_SUITE",
1676 "name": "Get a check suite",
1622 - "description": "Retrieves a specific check suite (a collection of check runs) by its id from a repository accessible to the authenticated user."
1677 + "description": "Retrieves a specific check suite (a collection of check runs) by its ID from a repository accessible to the authenticated user."
1678 },
1679 {
1680 "slug": "GITHUB_GET_A_CLASSROOM",
1681 "name": "Get a classroom",
1627 - "description": "Retrieves details for a specific github classroom; the classroom id must correspond to an existing classroom."
1682 + "description": "Retrieves details for a specific GitHub Classroom. Requires the authenticated user to be an administrator of the classroom."
1683 },
1684 {
1685 "slug": "GITHUB_GET_A_CODE_OF_CONDUCT",
1686 "name": "Get a code of conduct",
1632 - "description": "Retrieves the full details of a specific github code of conduct using its unique key."
1687 + "description": "Retrieves the full details of a specific GitHub code of conduct using its unique key."
1688 },
1689 {
1690 "slug": "GITHUB_GET_A_CODE_QL_DATABASE_FOR_A_REPOSITORY",
1691 "name": "Get a CodeQL database for a repository",
1637 - "description": "Gets an existing codeql database (including a download url) for a specified language in an accessible repository, if one has been successfully built for that language."
1692 + "description": "Gets an existing CodeQL database (including a download URL) for a specified language in an accessible repository, if one has been successfully built for that language."
1693 },
1694 {
1695 "slug": "GITHUB_GET_A_CODE_SCANNING_ALERT",
1696 "name": "Get a code scanning alert",
1642 - "description": "Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified github repository."
1697 + "description": "Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified GitHub repository."
1698 },
1699 {
1700 "slug": "GITHUB_GET_A_CODE_SCANNING_ANALYSIS_FOR_A_REPOSITORY",
1701 "name": "Get a code scanning analysis for a repository",
1647 - "description": "Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis id`."
1702 + "description": "Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis_id`."
1703 },
1704 {
1705 "slug": "GITHUB_GET_A_CODE_SCANNING_DEFAULT_SETUP_CONFIGURATION",
@@ -1654,27 +1709,27 @@
1709 {
1710 "slug": "GITHUB_GET_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
1711 "name": "Get a codespace for the authenticated user",
1657 - "description": "Call to retrieve detailed information for a `codespace name` belonging to the authenticated user, ensuring the codespace exists and is accessible."
1712 + "description": "Call to retrieve detailed information for a `codespace_name` belonging to the authenticated user, ensuring the codespace exists and is accessible."
1713 },
1714 {
1715 "slug": "GITHUB_GET_A_COMMIT",
1716 "name": "Get a commit",
1662 - "description": "Retrieves a specific commit from a repository by its owner, name, and a valid commit reference (sha, branch, or tag), supporting pagination for large diffs."
1717 + "description": "Retrieves a specific commit from a repository by its owner, name, and a valid commit reference (SHA, branch, or tag), supporting pagination for large diffs."
1718 },
1719 {
1720 "slug": "GITHUB_GET_A_COMMIT_COMMENT",
1721 "name": "Get a commit comment",
1667 - "description": "Retrieves the full details of a specific commit comment in a github repository, using its unique identifier."
1722 + "description": "Retrieves the full details of a specific commit comment in a GitHub repository, using its unique identifier."
1723 },
1724 {
1725 "slug": "GITHUB_GET_A_COMMIT_OBJECT",
1726 "name": "Get a commit object",
1672 - "description": "Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a github repository, identified by its sha."
1727 + "description": "Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a GitHub repository, identified by its SHA."
1728 },
1729 {
1730 "slug": "GITHUB_GET_A_CUSTOM_DEPLOYMENT_PROTECTION_RULE",
1731 "name": "Get a custom deployment protection rule",
1677 - "description": "Retrieves a specific custom deployment protection rule (used by github apps for external validation or manual approval of deployments) for a given environment in a repository."
1732 + "description": "Retrieves a specific custom deployment protection rule (used by GitHub Apps for external validation or manual approval of deployments) for a given environment in a repository."
1733 },
1734 {
1735 "slug": "GITHUB_GET_A_CUSTOM_PROPERTY_FOR_AN_ORGANIZATION",
@@ -1684,37 +1739,37 @@
1739 {
1740 "slug": "GITHUB_GET_A_DELIVERY_FOR_A_REPOSITORY_WEBHOOK",
1741 "name": "Get a delivery for a repository webhook",
1687 - "description": "Retrieves a specific delivery for a repository webhook, identified by its `hook id` and `delivery id`."
1742 + "description": "Retrieves a specific delivery for a repository webhook, identified by its `hook_id` and `delivery_id`."
1743 },
1744 {
1745 "slug": "GITHUB_GET_A_DEPLOY_KEY",
1746 "name": "Get a deploy key",
1692 - "description": "Gets a specific deploy key, identified by its `key id`, for the github repository specified by `owner` and `repo`."
1747 + "description": "Gets a specific deploy key, identified by its `key_id`, for the GitHub repository specified by `owner` and `repo`."
1748 },
1749 {
1750 "slug": "GITHUB_GET_A_DEPLOYMENT",
1751 "name": "Get a deployment",
1697 - "description": "Gets a specific deployment by id from a repository, provided the repository and deployment id exist."
1752 + "description": "Gets a specific deployment by ID from a repository, provided the repository and deployment ID exist."
1753 },
1754 {
1755 "slug": "GITHUB_GET_A_DEPLOYMENT_BRANCH_POLICY",
1756 "name": "Get a deployment branch policy",
1702 - "description": "Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique id."
1757 + "description": "Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique ID."
1758 },
1759 {
1760 "slug": "GITHUB_GET_A_DEPLOYMENT_STATUS",
1761 "name": "Get a deployment status",
1707 - "description": "Retrieves a specific deployment status by its id for a given deployment within a github repository."
1762 + "description": "Retrieves a specific deployment status by its ID for a given deployment within a GitHub repository."
1763 },
1764 {
1765 "slug": "GITHUB_GET_A_DIFF_OF_THE_DEPENDENCIES_BETWEEN_COMMITS",
1766 "name": "Get a diff of the dependencies between commits",
1712 - "description": "Gets the dependency diff between two git revisions in a repository, where 'basehead' specifies the revisions and 'name' can optionally scope to a specific manifest file."
1767 + "description": "Gets the dependency diff between two Git revisions in a repository, where 'basehead' specifies the revisions and 'name' can optionally scope to a specific manifest file."
1768 },
1769 {
1770 "slug": "GITHUB_GET_A_DISCUSSION",
1771 "name": "Get a discussion",
1717 - "description": "Fetches a specific discussion by its number from a team within an organization."
1772 + "description": "Fetches a specific discussion by its number from a team within an organization. This is a read-only action that retrieves discussion details including title, body, author information, comment count, and reactions. The authenticated user must be a member of the organization to access team discussions."
1773 },
1774 {
1775 "slug": "GITHUB_GET_A_DISCUSSION_COMMENT",
@@ -1729,17 +1784,17 @@
1784 {
1785 "slug": "GITHUB_GET_A_DNS_HEALTH_CHECK_FOR_GITHUB_PAGES",
1786 "name": "Get a dns health check for github pages",
1732 - "description": "Retrieves the dns health check status (e.g., cname/a records, https) for a github pages site; the check may be pending (http 202) on initial calls or after site changes."
1787 + "description": "Retrieves the DNS health check status (e.g., CNAME/A records, HTTPS) for a GitHub Pages site; the check may be pending (HTTP 202) on initial calls or after site changes."
1788 },
1789 {
1790 "slug": "GITHUB_GET_A_GIST",
1791 "name": "Get a gist",
1737 - "description": "Fetches a specific github gist by its `gist id`, returning comprehensive details if the gist exists."
1792 + "description": "Fetches a specific GitHub gist by its `gist_id`, returning comprehensive details if the gist exists."
1793 },
1794 {
1795 "slug": "GITHUB_GET_A_GIST_COMMENT",
1796 "name": "Get a gist comment",
1742 - "description": "Retrieves a specific gist comment by its id and the gist's id."
1797 + "description": "Retrieves a specific Gist comment by its ID and the Gist's ID."
1798 },
1799 {
1800 "slug": "GITHUB_GET_A_GIST_REVISION",
@@ -1749,52 +1804,52 @@
1804 {
1805 "slug": "GITHUB_GET_A_GITHUB_PAGES_SITE",
1806 "name": "Get a GitHub Pages site",
1752 - "description": "Retrieves information for a github pages site, which must be enabled for the repository."
1807 + "description": "Retrieves information for a GitHub Pages site, which must be enabled for the repository."
1808 },
1809 {
1810 "slug": "GITHUB_GET_A_GITIGNORE_TEMPLATE",
1811 "name": "Get a gitignore template",
1757 - "description": "Retrieves a specific .gitignore template from github by its name, which must be an existing template in github's collection."
1812 + "description": "Retrieves a specific .gitignore template from GitHub by its name, which must be an existing template in GitHub's collection."
1813 },
1814 {
1815 "slug": "GITHUB_GET_A_JOB_FOR_A_WORKFLOW_RUN",
1816 "name": "Get a job for a workflow run",
1762 - "description": "Retrieves detailed information for a specific job within a github actions workflow run, given its `job id` which must be valid for the specified repository's workflow."
1817 + "description": "Retrieves detailed information for a specific job within a GitHub Actions workflow run, given its `job_id` which must be valid for the specified repository's workflow."
1818 },
1819 {
1820 "slug": "GITHUB_GET_A_LABEL",
1821 "name": "Get a label",
1767 - "description": "Retrieves a specific label by its name from a specified github repository."
1822 + "description": "Retrieves a specific label by its name from a specified GitHub repository."
1823 },
1824 {
1825 "slug": "GITHUB_GET_A_LICENSE",
1826 "name": "Get a license",
1772 - "description": "Call this action to retrieve comprehensive details for a specific software license recognized by github, using its unique license key."
1827 + "description": "Call this action to retrieve comprehensive details for a specific software license recognized by GitHub, using its unique license key."
1828 },
1829 {
1830 "slug": "GITHUB_GET_ALL_API_VERSIONS",
1831 "name": "Get all API versions",
1777 - "description": "Retrieves all officially supported, date-based (e.g., \"2022-11-28\") versions of the github rest api from the /versions endpoint."
1832 + "description": "Retrieves all officially supported, date-based (e.g., \"2022-11-28\") versions of the GitHub REST API from the /versions endpoint."
1833 },
1834 {
1835 "slug": "GITHUB_GET_ALL_AUTOLINKS_OF_A_REPOSITORY",
1836 "name": "Get all autolinks of a repository",
1782 - "description": "Retrieves all autolinks (e.g., for jira issues) configured for a repository; requires admin permissions on the repository."
1837 + "description": "Retrieves all autolinks (e.g., for JIRA issues) configured for a repository; requires admin permissions on the repository."
1838 },
1839 {
1840 "slug": "GITHUB_GET_ALL_CODES_OF_CONDUCT",
1841 "name": "Get all codes of conduct",
1787 - "description": "Retrieves all available codes of conduct from github, often used to select one for a repository."
1842 + "description": "Retrieves all available codes of conduct from GitHub, often used to select one for a repository."
1843 },
1844 {
1845 "slug": "GITHUB_GET_ALL_COMMONLY_USED_LICENSES",
1846 "name": "Get all commonly used licenses",
1792 - "description": "Retrieves a list of commonly used software licenses from github, optionally filtering for 'featured' licenses whose specific selection criteria by github may vary."
1847 + "description": "Retrieves a list of commonly used software licenses from GitHub, optionally filtering for 'featured' licenses whose specific selection criteria by GitHub may vary."
1848 },
1849 {
1850 "slug": "GITHUB_GET_ALL_CONTRIBUTOR_COMMIT_ACTIVITY",
1851 "name": "Get all contributor commit activity",
1797 - "description": "Retrieves commit activity (total commits, weekly additions/deletions/commits) for all contributors to a repository; may require a retry if github returns 202 while preparing data."
1852 + "description": "Retrieves commit activity (total commits, weekly additions/deletions/commits) for all contributors to a repository; may require a retry if GitHub returns 202 while preparing data."
1853 },
1854 {
1855 "slug": "GITHUB_GET_ALL_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATION",
@@ -1804,7 +1859,7 @@
1859 {
1860 "slug": "GITHUB_GET_ALL_CUSTOM_PROPERTY_VALUES_FOR_A_REPOSITORY",
1861 "name": "Get all custom property values for a repository",
1807 - "description": "Gets all custom property values for a repository, which may include default values or be empty if no properties are explicitly set."
1862 + "description": "Gets all custom property values for a repository. Custom properties are defined at the organization level, so this endpoint works with organization-owned repositories. Returns an empty array if no custom properties are set."
1863 },
1864 {
1865 "slug": "GITHUB_GET_ALL_DEPLOYMENT_PROTECTION_RULES_FOR_AN_ENVIRONMENT",
@@ -1814,17 +1869,17 @@
1869 {
1870 "slug": "GITHUB_GET_ALL_GITIGNORE_TEMPLATES",
1871 "name": "Get all gitignore templates",
1817 - "description": "Retrieves all available .gitignore template names from github (e.g., 'python', 'node', 'java'), used for generating .gitignore files."
1872 + "description": "Retrieves all available .gitignore template names from GitHub (e.g., 'Python', 'Node', 'Java'), used for generating .gitignore files."
1873 },
1874 {
1875 "slug": "GITHUB_GET_ALL_ORGANIZATION_ROLES_FOR_AN_ORGANIZATION",
1876 "name": "Get all organization roles for an organization",
1822 - "description": "Lists all custom organization roles for an existing github organization."
1877 + "description": "Lists all custom organization roles for an existing GitHub organization."
1878 },
1879 {
1880 "slug": "GITHUB_GET_ALL_REPOSITORY_RULESETS",
1881 "name": "Get all repository rulesets",
1827 - "description": "Retrieves all rulesets for a github repository, which define conditions and actions for repository interactions (e.g., branch protections)."
1882 + "description": "Retrieves all rulesets for a GitHub repository, which define conditions and actions for repository interactions (e.g., branch protections)."
1883 },
1884 {
1885 "slug": "GITHUB_GET_ALL_REPOSITORY_TOPICS",
@@ -1844,62 +1899,62 @@
1899 {
1900 "slug": "GITHUB_GET_A_MILESTONE",
1901 "name": "Get a milestone",
1847 - "description": "Retrieves detailed information for a specific milestone within a github repository by its number."
1902 + "description": "Retrieves detailed information for a specific milestone within a GitHub repository by its number."
1903 },
1904 {
1905 "slug": "GITHUB_GET_AN_APP",
1906 "name": "Get an app",
1852 - "description": "Retrieves publicly available information for an existing github app, identified by its unique url-friendly `app slug`."
1907 + "description": "Retrieves publicly available information for an existing GitHub App, identified by its unique URL-friendly `app_slug`."
1908 },
1909 {
1910 "slug": "GITHUB_GET_AN_ARTIFACT",
1911 "name": "Get an artifact",
1857 - "description": "Gets a specific artifact for a repository by `artifact id`."
1912 + "description": "Gets a specific artifact for a repository by `artifact_id`. This action retrieves the details of a specific artifact from a GitHub repository using the artifact's unique identifier. It allows users to access information about artifacts stored in the repository."
1913 },
1914 {
1915 "slug": "GITHUB_GET_AN_ASSIGNMENT",
1916 "name": "Get an assignment",
1862 - "description": "Retrieves detailed information for a specific github classroom assignment if the authenticated user is an administrator of the classroom."
1917 + "description": "Retrieves detailed information for a specific GitHub Classroom assignment if the authenticated user is an administrator of the classroom."
1918 },
1919 {
1920 "slug": "GITHUB_GET_AN_AUTOLINK_REFERENCE_OF_A_REPOSITORY",
1921 "name": "Get an autolink reference of a repository",
1867 - "description": "Retrieves a specific autolink reference (which automatically hyperlinks text like 'jira-123' to an external system) for a repository using its unique id; requires administrator access to the repository."
1922 + "description": "Retrieves a specific autolink reference (which automatically hyperlinks text like 'JIRA-123' to an external system) for a repository using its unique ID; requires administrator access to the repository."
1923 },
1924 {
1925 "slug": "GITHUB_GET_AN_ENVIRONMENT",
1926 "name": "Get an environment",
1872 - "description": "Get an environment"
1927 + "description": "Action docstring"
1928 },
1929 {
1930 "slug": "GITHUB_GET_AN_ENVIRONMENT_PUBLIC_KEY",
1931 "name": "Get an environment public key",
1877 - "description": "Retrieves the public key for a specified github repository environment, used to encrypt secrets for github actions."
1932 + "description": "Retrieves the public key for a specified GitHub repository environment, used to encrypt secrets for GitHub Actions."
1933 },
1934 {
1935 "slug": "GITHUB_GET_AN_ENVIRONMENT_SECRET",
1936 "name": "Get an environment secret",
1882 - "description": "Get an environment secret"
1937 + "description": "Retrieves metadata (name and timestamps) for a single secret in a GitHub Actions environment. Note: The actual secret value is never returned by this API for security reasons."
1938 },
1939 {
1940 "slug": "GITHUB_GET_AN_ENVIRONMENT_VARIABLE",
1941 "name": "Get an environment variable",
1887 - "description": "Get an environment variable"
1942 + "description": "Action docstring"
1943 },
1944 {
1945 "slug": "GITHUB_GET_AN_ISSUE",
1946 "name": "Get an issue",
1892 - "description": "Get an issue"
1947 + "description": "Action docstring"
1948 },
1949 {
1950 "slug": "GITHUB_GET_AN_ISSUE_COMMENT",
1951 "name": "Get an issue comment",
1897 - "description": "Get an issue comment"
1952 + "description": "Action to get an issue comment."
1953 },
1954 {
1955 "slug": "GITHUB_GET_AN_ISSUE_EVENT",
1956 "name": "Get an issue event",
1902 - "description": "Get an issue event"
1957 + "description": "Fetches details of a specific issue event for a given repository and event ID."
1958 },
1959 {
1960 "slug": "GITHUB_GET_AN_ORGANIZATION",
@@ -1909,12 +1964,12 @@
1964 {
1965 "slug": "GITHUB_GET_AN_ORGANIZATION_PUBLIC_KEY",
1966 "name": "Get an organization public key",
1912 - "description": "Get an organization public key"
1967 + "description": "Action for `GetAnOrganizationPublicKey`."
1968 },
1969 {
1970 "slug": "GITHUB_GET_AN_ORGANIZATION_ROLE",
1971 "name": "Get an organization role",
1917 - "description": "Retrieves a specific github organization role by its id."
1972 + "description": "Retrieves a specific GitHub organization role by its ID."
1973 },
1974 {
1975 "slug": "GITHUB_GET_AN_ORGANIZATION_SECRET",
@@ -1924,7 +1979,7 @@
1979 {
1980 "slug": "GITHUB_GET_AN_ORGANIZATION_VARIABLE",
1981 "name": "Get an organization variable",
1927 - "description": "Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing github organization."
1982 + "description": "Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing GitHub organization."
1983 },
1984 {
1985 "slug": "GITHUB_GET_AN_ORGANIZATION_WEBHOOK",
@@ -1939,7 +1994,7 @@
1994 {
1995 "slug": "GITHUB_GET_A_PACKAGE_FOR_A_USER",
1996 "name": "Get a package for a user",
1942 - "description": "Retrieves metadata for a specific package owned by a github user, using package type, name, and username as identifiers."
1997 + "description": "Retrieves metadata for a specific package owned by a GitHub user, using package type, name, and username as identifiers."
1998 },
1999 {
2000 "slug": "GITHUB_GET_A_PACKAGE_FOR_THE_AUTHENTICATED_USER",
@@ -1954,87 +2009,87 @@
2009 {
2010 "slug": "GITHUB_GET_A_PACKAGE_VERSION_FOR_A_USER",
2011 "name": "Get a package version for a user",
1957 - "description": "Retrieves a specific public package version associated with a github user."
2012 + "description": "Retrieves a specific public package version associated with a GitHub user."
2013 },
2014 {
2015 "slug": "GITHUB_GET_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USER",
2016 "name": "Get authenticated user package version",
1962 - "description": "Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version id."
2017 + "description": "Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version ID."
2018 },
2019 {
2020 "slug": "GITHUB_GET_APPS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
2021 "name": "Get apps with access to the protected branch",
1967 - "description": "Lists github apps with push access to a repository's protected branch."
2022 + "description": "Lists GitHub Apps with push access to a repository's protected branch."
2023 },
2024 {
2025 "slug": "GITHUB_GET_A_PROJECT",
2026 "name": "Get a project",
1972 - "description": "Retrieves detailed information for a specific github project using its unique `project id`."
2027 + "description": "Retrieves detailed information for a specific GitHub project (V2) using its project number and owner. Note: This action uses GitHub's Projects V2 REST API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed."
2028 },
2029 {
2030 "slug": "GITHUB_GET_A_PROJECT_CARD",
2031 "name": "Get a project card",
1977 - "description": "Retrieves all details of a specific project card, given its unique `card id`."
2032 + "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."
2033 },
2034 {
2035 "slug": "GITHUB_GET_A_PROJECT_COLUMN",
1981 - "name": "Get a project column",
1982 - "description": "Retrieves detailed information for a specific project column; the column must exist."
2036 + "name": "Get a project column (Classic - Deprecated)",
2037 + "description": "Retrieves detailed information for a specific project column from GitHub Projects (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) 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 column details including: id, name, url, project_url, cards_url, node_id, created_at, and updated_at timestamps."
2038 },
2039 {
2040 "slug": "GITHUB_GET_A_PULL_REQUEST",
2041 "name": "Get a pull request",
1987 - "description": "Retrieves a specific pull request from a github repository using its owner, repository name, and pull request number."
2042 + "description": "Retrieves a specific pull request from a GitHub repository using its owner, repository name, and pull request number."
2043 },
2044 {
2045 "slug": "GITHUB_GET_A_REFERENCE",
2046 "name": "Get a reference",
1992 - "description": "Retrieves a specific git reference (e.g., a branch, tag, or fully qualified like 'heads/main') from a github repository."
2047 + "description": "Retrieves a specific Git reference (e.g., a branch, tag, or fully qualified like 'heads/main') from a GitHub repository. The reference must exist in the repository; use 'list_matching_references' first if unsure what references are available."
2048 },
2049 {
2050 "slug": "GITHUB_GET_A_RELEASE",
2051 "name": "Get a release",
1997 - "description": "Gets a specific release from a github repository, provided the repository is accessible and the release exists."
2052 + "description": "Gets a specific release from a GitHub repository, provided the repository is accessible and the release exists."
2053 },
2054 {
2055 "slug": "GITHUB_GET_A_RELEASE_ASSET",
2056 "name": "Get a release asset",
2002 - "description": "Gets metadata for a specific release asset in a github repository, including a `browser download url` for downloading the asset."
2057 + "description": "Gets metadata for a specific release asset in a GitHub repository, including a `browser_download_url` for downloading the asset."
2058 },
2059 {
2060 "slug": "GITHUB_GET_A_RELEASE_BY_TAG_NAME",
2061 "name": "Get a release by tag name",
2007 - "description": "Gets a release from a github repository by its tag name; the repository and a release with this tag must already exist."
2062 + "description": "Gets a release from a GitHub repository by its tag name; the repository and a release with this tag must already exist."
2063 },
2064 {
2065 "slug": "GITHUB_GET_A_REPOSITORY",
2066 "name": "Get a repository",
2012 - "description": "Retrieves detailed information about an existing and accessible github repository."
2067 + "description": "Retrieves detailed information about an existing and accessible GitHub repository."
2068 },
2069 {
2070 "slug": "GITHUB_GET_A_REPOSITORY_PUBLIC_KEY",
2071 "name": "Get a repository public key",
2017 - "description": "Gets a repository's public key for encrypting secrets to be used in github actions, if the repository exists and is accessible."
2072 + "description": "Gets a repository's public key for encrypting secrets to be used in GitHub Actions, if the repository exists and is accessible."
2073 },
2074 {
2075 "slug": "GITHUB_GET_A_REPOSITORY_README",
2076 "name": "Get a repository readme",
2022 - "description": "Fetches the readme file (if it exists and is accessible) from a specified github repository, returning its base64-encoded content and metadata."
2077 + "description": "Fetches the README file (if it exists and is accessible) from a specified GitHub repository, returning its Base64-encoded content and metadata."
2078 },
2079 {
2080 "slug": "GITHUB_GET_A_REPOSITORY_README_FOR_A_DIRECTORY",
2081 "name": "Get a repository readme for a directory",
2027 - "description": "Retrieves the readme file from a specified directory within a github repository, optionally at a given commit, branch, or tag."
2082 + "description": "Retrieves the README file from a specified directory within a GitHub repository, optionally at a given commit, branch, or tag."
2083 },
2084 {
2085 "slug": "GITHUB_GET_A_REPOSITORY_RULESET",
2086 "name": "Get a repository ruleset",
2032 - "description": "Retrieves a specific repository ruleset by its id; if `includes parents` is true, the search for this `ruleset id` also extends to rulesets from parent organizations."
2087 + "description": "Retrieves a specific repository ruleset by its ID; if `includes_parents` is true, the search for this `ruleset_id` also extends to rulesets from parent organizations."
2088 },
2089 {
2090 "slug": "GITHUB_GET_A_REPOSITORY_RULE_SUITE",
2091 "name": "Get a repository rule suite",
2037 - "description": "Gets detailed information for a specific repository rule suite by its id, including its evaluation status and the results of its individual rules."
2092 + "description": "Gets detailed information for a specific repository rule suite by its ID, including its evaluation status and the results of its individual rules."
2093 },
2094 {
2095 "slug": "GITHUB_GET_A_REPOSITORY_SECRET",
@@ -2049,7 +2104,7 @@
2104 {
2105 "slug": "GITHUB_GET_A_REPOSITORY_VARIABLE",
2106 "name": "Get a repository variable",
2052 - "description": "Gets a specific github actions variable by name from an accessible repository."
2107 + "description": "Gets a specific GitHub Actions variable by name from an accessible repository."
2108 },
2109 {
2110 "slug": "GITHUB_GET_A_REPOSITORY_WEBHOOK",
@@ -2059,67 +2114,67 @@
2114 {
2115 "slug": "GITHUB_GET_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
2116 "name": "Get a review comment for a pull request",
2062 - "description": "Retrieves a specific pull request review comment by its id, provided the repository exists, is accessible, and the comment id is valid."
2117 + "description": "Retrieves a specific pull request review comment by its ID, provided the repository exists, is accessible, and the comment ID is valid."
2118 },
2119 {
2120 "slug": "GITHUB_GET_A_REVIEW_FOR_A_PULL_REQUEST",
2121 "name": "Get a review for a pull request",
2067 - "description": "Retrieves a specific review for a pull request using its owner, repository, pull request number, and review id."
2122 + "description": "Retrieves a specific review for a pull request using its owner, repository, pull request number, and review ID."
2123 },
2124 {
2125 "slug": "GITHUB_GET_A_SECRET_FOR_THE_AUTHENTICATED_USER",
2126 "name": "Get a secret for the authenticated user",
2072 - "description": "Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's github codespaces."
2127 + "description": "Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's GitHub Codespaces."
2128 },
2129 {
2130 "slug": "GITHUB_GET_A_SELF_HOSTED_RUNNER_FOR_AN_ORGANIZATION",
2131 "name": "Get a self hosted runner for an organization",
2077 - "description": "Retrieves detailed information about a specific self-hosted runner registered within a github organization."
2132 + "description": "Retrieves detailed information about a specific self-hosted runner registered within a GitHub organization."
2133 },
2134 {
2135 "slug": "GITHUB_GET_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORY",
2136 "name": "Get a self hosted runner for a repository",
2082 - "description": "Gets a specific self-hosted runner for a repository by its unique id."
2137 + "description": "Gets a specific self-hosted runner for a repository by its unique ID."
2138 },
2139 {
2140 "slug": "GITHUB_GET_ASSIGNMENT_GRADES",
2141 "name": "Get assignment grades",
2087 - "description": "Retrieves all grades for an existing github classroom assignment."
2142 + "description": "Retrieves all grades for an existing GitHub Classroom assignment."
2143 },
2144 {
2145 "slug": "GITHUB_GET_A_TAG",
2146 "name": "Get a tag",
2092 - "description": "Retrieves detailed information for a specific git tag object from a github repository, using the sha of the tag object itself."
2147 + "description": "Retrieves detailed information for a specific Git tag object from a GitHub repository, using the SHA of the tag object itself."
2148 },
2149 {
2150 "slug": "GITHUB_GET_A_TEAM_BY_NAME",
2151 "name": "Get a team by name",
2097 - "description": "Retrieves a github team by its slug from a specific organization."
2152 + "description": "Retrieves a GitHub team by its slug from a specific organization."
2153 },
2154 {
2155 "slug": "GITHUB_GET_A_THREAD",
2156 "name": "Get a thread",
2102 - "description": "Retrieves a specific github notification thread using its unique `thread id`."
2157 + "description": "Retrieves a specific GitHub notification thread using its unique `thread_id`."
2158 },
2159 {
2160 "slug": "GITHUB_GET_A_THREAD_SUBSCRIPTION_FOR_THE_AUTHENTICATED_USER",
2161 "name": "Get a thread subscription for the authenticated user",
2107 - "description": "Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread id`."
2162 + "description": "Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread_id`."
2163 },
2164 {
2165 "slug": "GITHUB_GET_A_TREE",
2111 - "name": "Get a tree",
2112 - "description": "Retrieves a git tree (directory listing) from a github repository using its sha, branch name, or tag name, optionally fetching all nested items recursively."
2166 + "name": "List repository files and directories",
2167 + "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."
2168 },
2169 {
2170 "slug": "GITHUB_GET_A_USER",
2171 "name": "Get a user",
2117 - "description": "Retrieves the public profile information for an existing github user, specified by their username."
2172 + "description": "Retrieves the public profile information for an existing GitHub user, specified by their username."
2173 },
2174 {
2175 "slug": "GITHUB_GET_A_WEBHOOK_CONFIGURATION_FOR_AN_ORGANIZATION",
2176 "name": "Get a webhook configuration for an organization",
2122 - "description": "Retrieves the configuration for a specific webhook associated with a github organization."
2177 + "description": "Retrieves the configuration for a specific webhook associated with a GitHub organization."
2178 },
2179 {
2180 "slug": "GITHUB_GET_A_WEBHOOK_CONFIGURATION_FOR_A_REPOSITORY",
@@ -2129,32 +2184,32 @@
2184 {
2185 "slug": "GITHUB_GET_A_WEBHOOK_DELIVERY_FOR_AN_ORGANIZATION_WEBHOOK",
2186 "name": "Get a webhook delivery for an organization webhook",
2132 - "description": "Returns detailed information for a specific delivery attempt of a webhook configured for the specified github organization."
2187 + "description": "Returns detailed information for a specific delivery attempt of a webhook configured for the specified GitHub organization."
2188 },
2189 {
2190 "slug": "GITHUB_GET_A_WORKFLOW",
2191 "name": "Get a workflow",
2137 - "description": "Retrieves detailed information for a specific github actions workflow in a repository, identified by either its numeric id or its filename."
2192 + "description": "Retrieves detailed information for a specific GitHub Actions workflow in a repository, identified by either its numeric ID or its filename."
2193 },
2194 {
2195 "slug": "GITHUB_GET_A_WORKFLOW_RUN",
2196 "name": "Get a workflow run",
2142 - "description": "Gets a specific workflow run by its id from a github repository."
2197 + "description": "Gets a specific workflow run by its ID from a GitHub repository."
2198 },
2199 {
2200 "slug": "GITHUB_GET_A_WORKFLOW_RUN_ATTEMPT",
2201 "name": "Get a workflow run attempt",
2147 - "description": "Retrieves detailed information for a specific attempt of a workflow run in a github repository, including its status, conclusion, and timings."
2202 + "description": "Retrieves detailed information for a specific attempt of a workflow run in a GitHub repository, including its status, conclusion, and timings."
2203 },
2204 {
2205 "slug": "GITHUB_GET_BRANCH_PROTECTION",
2206 "name": "Get branch protection",
2152 - "description": "Retrieves branch protection settings for a specific, existing, and accessible branch in a github repository; protection feature availability varies by github product plan."
2207 + "description": "Retrieves branch protection settings for a specific, existing, and accessible branch in a GitHub repository; protection feature availability varies by GitHub product plan."
2208 },
2209 {
2210 "slug": "GITHUB_GET_COMMIT_AUTHORS",
2211 "name": "Get commit authors",
2157 - "description": "Fetches commit authors identified during a repository import, used to map authors from an external vcs to github accounts."
2212 + "description": "Fetches commit authors identified during a repository import, used to map authors from an external VCS to GitHub accounts. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports."
2213 },
2214 {
2215 "slug": "GITHUB_GET_COMMIT_SIGNATURE_PROTECTION",
@@ -2164,27 +2219,27 @@
2219 {
2220 "slug": "GITHUB_GET_COMMUNITY_PROFILE_METRICS",
2221 "name": "Get community profile metrics",
2167 - "description": "Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., readme, license)."
2222 + "description": "Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., README, LICENSE)."
2223 },
2224 {
2225 "slug": "GITHUB_GET_CONTEXTUAL_INFORMATION_FOR_A_USER",
2226 "name": "Get contextual information for a user",
2172 - "description": "Gets contextual hovercard information for a github user; `subject type` and `subject id` can be jointly provided for more specific details."
2227 + "description": "Gets contextual hovercard information for a GitHub user; `subject_type` and `subject_id` can be jointly provided for more specific details."
2228 },
2229 {
2230 "slug": "GITHUB_GET_DEFAULT_ATTRIBUTES_FOR_A_CODESPACE",
2231 "name": "Get default attributes for a codespace",
2177 - "description": "Get pre-flight data (e.g., default location, devcontainer path) for creating a codespace in a given repository (must exist and be accessible), optionally for a specific git ref."
2232 + "description": "Get pre-flight data (e.g., default location, devcontainer path) for creating a Codespace in a given repository (must exist and be accessible), optionally for a specific Git ref."
2233 },
2234 {
2235 "slug": "GITHUB_GET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_AN_ORGANIZATION",
2236 "name": "Get default workflow permissions for an organization",
2182 - "description": "Gets the default github token workflow permissions and settings for a github organization."
2237 + "description": "Gets the default GITHUB_TOKEN workflow permissions and settings for a GitHub organization."
2238 },
2239 {
2240 "slug": "GITHUB_GET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_A_REPOSITORY",
2241 "name": "Get default workflow permissions for a repository",
2187 - "description": "Gets the default workflow permissions (`read` or `write`) for the github token and whether it can approve pull request reviews in an existing and accessible repository."
2242 + "description": "Gets the default workflow permissions (`read` or `write`) for the GITHUB_TOKEN and whether it can approve pull request reviews in an existing and accessible repository."
2243 },
2244 {
2245 "slug": "GITHUB_GET_DETAILS_ABOUT_A_CODESPACE_EXPORT",
@@ -2194,52 +2249,52 @@
2249 {
2250 "slug": "GITHUB_GET_EMOJIS",
2251 "name": "Get emojis",
2197 - "description": "Lists all emojis available for use on github, including custom and unicode emojis."
2252 + "description": "Lists all emojis available for use on GitHub, including custom and Unicode emojis."
2253 },
2254 {
2255 "slug": "GITHUB_GET_FEEDS",
2256 "name": "Get feeds",
2202 - "description": "Fetches a list of available github feed urls for the authenticated user."
2257 + "description": "Fetches a list of available GitHub feed URLs for the authenticated user."
2258 },
2259 {
2260 "slug": "GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_AN_ORGANIZATION",
2261 "name": "Get GitHub Actions cache usage for an organization",
2207 - "description": "Retrieves total github actions cache usage statistics for an organization, including active cache count and size across all repositories."
2262 + "description": "Retrieves total GitHub Actions cache usage statistics for an organization, including active cache count and size across all repositories."
2263 },
2264 {
2265 "slug": "GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_A_REPOSITORY",
2266 "name": "Get github actions cache usage for a repository",
2212 - "description": "Retrieves the total count of active github actions caches and their combined size in bytes for a specified repository."
2267 + "description": "Retrieves the total count of active GitHub Actions caches and their combined size in bytes for a specified repository."
2268 },
2269 {
2270 "slug": "GITHUB_GET_GITHUB_ACTIONS_PERMISSIONS_FOR_AN_ORGANIZATION",
2271 "name": "Get github actions permissions for an organization",
2217 - "description": "Gets the github actions permissions for a specified organization, detailing repository enablement and allowed actions policies."
2272 + "description": "Gets the GitHub Actions permissions for a specified organization, detailing repository enablement and allowed actions policies."
2273 },
2274 {
2275 "slug": "GITHUB_GET_GITHUB_ACTIONS_PERMISSIONS_FOR_A_REPOSITORY",
2276 "name": "Get GitHub Actions permissions for a repository",
2222 - "description": "Gets the github actions permissions policy for a repository, including its enabled status and the scope of allowed actions."
2277 + "description": "Gets the GitHub Actions permissions policy for a repository, including its enabled status and the scope of allowed actions."
2278 },
2279 {
2280 "slug": "GITHUB_GET_GITHUB_META_INFORMATION",
2281 "name": "Get github meta information",
2227 - "description": "Fetches github's publicly available metadata, useful for configuring network security policies or ip allow-listing."
2282 + "description": "Fetches GitHub's publicly available metadata, useful for configuring network security policies or IP allow-listing."
2283 },
2284 {
2285 "slug": "GITHUB_GET_GITHUB_PAGES_BUILD",
2286 "name": "Get github pages build",
2232 - "description": "Retrieves detailed information about a specific github pages build for a repository, which must have github pages enabled."
2287 + "description": "Retrieves detailed information about a specific GitHub Pages build for a repository, which must have GitHub Pages enabled."
2288 },
2289 {
2290 "slug": "GITHUB_GET_INFORMATION_ABOUT_A_SARIF_UPLOAD",
2291 "name": "Get information about a sarif upload",
2237 - "description": "Retrieves detailed information, including processing status and results url, about a specific sarif (static analysis results interchange format) upload for a repository, uniquely identified by its sarif id."
2292 + "description": "Retrieves detailed information, including processing status and results URL, about a specific SARIF (Static Analysis Results Interchange Format) upload for a repository, uniquely identified by its sarif_id."
2293 },
2294 {
2295 "slug": "GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATION",
2296 "name": "Get interaction restrictions for an organization",
2242 - "description": "Retrieves interaction restrictions for an organization, showing which github user types can interact with its public repositories and when restrictions expire; returns an empty response if no restrictions are set."
2297 + "description": "Retrieves interaction restrictions for an organization, showing which GitHub user types can interact with its public repositories and when restrictions expire; returns an empty response if no restrictions are set."
2298 },
2299 {
2300 "slug": "GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORY",
@@ -2254,27 +2309,32 @@
2309 {
2310 "slug": "GITHUB_GET_LARGE_FILES",
2311 "name": "Get large files",
2257 - "description": "Lists files larger than 100mb identified during a previous source import for the specified repository; this endpoint is deprecated and will be removed on april 12, 2024."
2312 + "description": "Lists files larger than 100MB identified during a previous source import for the specified repository. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports."
2313 },
2314 {
2315 "slug": "GITHUB_GET_LATEST_PAGES_BUILD",
2316 "name": "Get latest pages build",
2262 - "description": "Retrieves information about the most recent github pages build for a repository, which must exist, be accessible, have github pages enabled, and have at least one prior build."
2317 + "description": "Retrieves information about the most recent GitHub Pages build for a repository, which must exist, be accessible, have GitHub Pages enabled, and have at least one prior build."
2318 },
2319 {
2320 "slug": "GITHUB_GET_OCTOCAT",
2321 "name": "Get octocat",
2267 - "description": "Fetches an ascii art representation of github's octocat, suitable for text-based displays."
2322 + "description": "Fetches an ASCII art representation of GitHub's Octocat, suitable for text-based displays."
2323 },
2324 {
2325 "slug": "GITHUB_GET_ORG_ALLOWED_ACTIONS",
2326 "name": "Get allowed actions and workflows for an org",
2272 - "description": "Retrieves the github actions permissions policy, including allowed actions and reusable workflows, for a specified organization."
2327 + "description": "Gets the list of allowed actions and reusable workflows for an organization when the 'allowed_actions' policy is set to 'selected'."
2328 + },
2329 + {
2330 + "slug": "GITHUB_GET_ORGANIZATION_AUDIT_LOG",
2331 + "name": "Get organization audit log",
2332 + "description": "Tool to retrieve an organization's audit log events for security and compliance investigations. Use when tracking organizational changes, security audits, or compliance monitoring. Requires organization owner permissions and read:audit_log scope."
2333 },
2334 {
2335 "slug": "GITHUB_GET_ORG_DEV_ENVIRONMENT_SECRET_SAFELY",
2336 "name": "Get org dev environment secret safely",
2277 - "description": "Retrieves metadata for a specific secret available to an organization's github codespaces without exposing its encrypted value."
2337 + "description": "Retrieves metadata for a specific secret available to an organization's GitHub Codespaces without exposing its encrypted value."
2338 },
2339 {
2340 "slug": "GITHUB_GET_PAGE_VIEWS",
@@ -2289,32 +2349,42 @@
2349 {
2350 "slug": "GITHUB_GET_PROJECT_PERMISSION_FOR_A_USER",
2351 "name": "Get project permission for a user",
2292 - "description": "Retrieves a collaborator's permission level (admin, write, read, or none) for an existing github project."
2352 + "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."
2353 },
2354 {
2355 "slug": "GITHUB_GET_PUBLIC_KEY_FOR_SECRET_ENCRYPTION",
2356 "name": "Get public key for secret encryption",
2297 - "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."
2357 + "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."
2358 },
2359 {
2360 "slug": "GITHUB_GET_PUBLIC_KEY_FOR_THE_AUTHENTICATED_USER",
2361 "name": "Get public key for the authenticated user",
2302 - "description": "Retrieves the authenticated user's public github key, used to encrypt secrets for github codespaces."
2362 + "description": "Retrieves the authenticated user's public key for encrypting GitHub Codespaces secrets. The returned key must be used with libsodium sealed box encryption before creating or updating secrets via the API."
2363 },
2364 {
2365 "slug": "GITHUB_GET_PULL_REQUEST_REVIEW_PROTECTION",
2366 "name": "Get pull request review protection",
2307 - "description": "Retrieves the pull request review protection settings for a specific branch in a github repository, if such protection is configured."
2367 + "description": "Retrieves the pull request review protection settings for a specific branch in a GitHub repository, if such protection is configured."
2368 },
2369 {
2370 "slug": "GITHUB_GET_RATE_LIMIT_STATUS_FOR_THE_AUTHENTICATED_USER",
2371 "name": "Get rate limit status for the authenticated user",
2312 - "description": "Retrieves the authenticated user's current github api rate limit status, including usage and limits across different resource categories."
2372 + "description": "Retrieves the authenticated user's current GitHub API rate limit status, including usage and limits across different resource categories."
2373 + },
2374 + {
2375 + "slug": "GITHUB_GET_RAW_REPOSITORY_CONTENT",
2376 + "name": "Get Raw Repository Content",
2377 + "description": "Tool to fetch raw file content from a GitHub repository. Use when you need the raw bytes of a file in the repo."
2378 + },
2379 + {
2380 + "slug": "GITHUB_GET_REPO_ALLOWED_ACTIONS",
2381 + "name": "Get allowed actions and workflows for a repository",
2382 + "description": "Gets the settings for allowed actions and reusable workflows in a repository. Requires the repository's `allowed_actions` policy to be set to `selected` (returns 409 if set to `all` or `local_only`)."
2383 },
2384 {
2385 "slug": "GITHUB_GET_REPO_DEV_ENV_SECRET",
2386 "name": "Get repository development environment secret",
2317 - "description": "Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (codespaces secret) in a repository, without exposing its value."
2387 + "description": "Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (Codespaces secret) in a repository, without exposing its value."
2388 },
2389 {
2390 "slug": "GITHUB_GET_REPOSITORY_CLONES",
@@ -2324,7 +2394,7 @@
2394 {
2395 "slug": "GITHUB_GET_REPOSITORY_CONTENT",
2396 "name": "Get repository content",
2327 - "description": "Retrieves a file's base64 encoded content or a directory's metadata (but not a listing of its contents) from a github repository path."
2397 + "description": "Retrieves a file's Base64 encoded content or lists a directory's contents from a GitHub repository."
2398 },
2399 {
2400 "slug": "GITHUB_GET_REPOSITORY_PERMISSIONS_FOR_A_USER",
@@ -2334,27 +2404,27 @@
2404 {
2405 "slug": "GITHUB_GET_REPOSITORY_SECRET_SECURELY",
2406 "name": "Get repository secret securely",
2337 - "description": "Retrieves metadata for an existing dependabot secret in a repository, without exposing its encrypted value."
2407 + "description": "Retrieves metadata for an existing Dependabot secret in a repository, without exposing its encrypted value."
2408 },
2409 {
2410 "slug": "GITHUB_GET_RULES_FOR_A_BRANCH",
2411 "name": "Get rules for a branch",
2342 - "description": "Retrieves all active rules for a specific branch in a github repository, excluding rules in 'evaluate' or 'disabled' status."
2412 + "description": "Retrieves all active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status."
2413 },
2414 {
2415 "slug": "GITHUB_GET_SINGLE_ORG_SECRET_WITHOUT_DECRYPTION",
2346 - "name": "Get single org secret without decryption",
2347 - "description": "Retrieves metadata (e.g., name, creation/update timestamps, visibility) for an organization's dependabot secret, without its encrypted value."
2416 + "name": "Get Organization Dependabot Secret",
2417 + "description": "Gets a single organization Dependabot secret's metadata (name, timestamps, visibility) without revealing its encrypted value. Requires admin:org scope."
2418 },
2419 {
2420 "slug": "GITHUB_GET_STATUS_CHECKS_PROTECTION",
2421 "name": "Get status checks protection",
2352 - "description": "Retrieves the status check protection settings for a specific branch in a github repository, if status check protection is enabled for it."
2422 + "description": "Retrieves the status check protection settings for a specific branch in a GitHub repository, if status check protection is enabled for it."
2423 },
2424 {
2425 "slug": "GITHUB_GET_TEAM_MEMBERSHIP_FOR_A_USER",
2426 "name": "Get team membership for a user",
2357 - "description": "Retrieves a user's role and membership status within a specific team in an organization."
2427 + "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."
2428 },
2429 {
2430 "slug": "GITHUB_GET_TEAMS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
@@ -2364,12 +2434,12 @@
2434 {
2435 "slug": "GITHUB_GET_THE_AUTHENTICATED_USER",
2436 "name": "Get the authenticated user",
2367 - "description": "Gets the profile information for the currently authenticated github user, including potentially private details based on user settings."
2437 + "description": "Gets the profile information for the currently authenticated GitHub user, including potentially private details based on user settings."
2438 },
2439 {
2440 "slug": "GITHUB_GET_THE_COMBINED_STATUS_FOR_A_SPECIFIC_REFERENCE",
2441 "name": "Get the combined status for a specific reference",
2372 - "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."
2442 + "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."
2443 },
2444 {
2445 "slug": "GITHUB_GET_THE_HOURLY_COMMIT_COUNT_FOR_EACH_DAY",
@@ -2379,27 +2449,27 @@
2449 {
2450 "slug": "GITHUB_GET_THE_LAST_YEAR_OF_COMMIT_ACTIVITY",
2451 "name": "Get the last year of commit activity",
2382 - "description": "Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified github repository."
2452 + "description": "Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified GitHub repository."
2453 },
2454 {
2455 "slug": "GITHUB_GET_THE_LATEST_RELEASE",
2456 "name": "Get the latest release",
2387 - "description": "Fetches the latest official (non-prerelease, non-draft) release for a github repository; requires at least one such published release."
2457 + "description": "Fetches the latest official (non-prerelease, non-draft) release for a GitHub repository; requires at least one such published release."
2458 },
2459 {
2460 "slug": "GITHUB_GET_THE_LICENSE_FOR_A_REPOSITORY",
2461 "name": "Get the license for a repository",
2392 - "description": "Retrieves the license file and its details for a repository, optionally from a specific git reference (branch, tag, or commit sha)."
2462 + "description": "Retrieves the license file and its details for a repository, optionally from a specific Git reference (branch, tag, or commit SHA)."
2463 },
2464 {
2465 "slug": "GITHUB_GET_THE_REVIEW_HISTORY_FOR_A_WORKFLOW_RUN",
2466 "name": "Get the review history for a workflow run",
2397 - "description": "Retrieves the detailed approval history for a specific workflow run in a github repository, detailing each review's environment, state, reviewer, and comments, to track the approval process for workflows, particularly automated deployments."
2467 + "description": "Retrieves the detailed approval history for a specific workflow run in a GitHub repository, detailing each review's environment, state, reviewer, and comments, to track the approval process for workflows, particularly automated deployments."
2468 },
2469 {
2470 "slug": "GITHUB_GET_THE_STATUS_OF_A_GITHUB_PAGES_DEPLOYMENT",
2471 "name": "Get the status of a GitHub Pages deployment",
2402 - "description": "Retrieves the status of a specific github pages deployment for a repository, which must have github pages enabled."
2472 + "description": "Retrieves the status of a specific GitHub Pages deployment for a repository, which must have GitHub Pages enabled."
2473 },
2474 {
2475 "slug": "GITHUB_GET_THE_WEEKLY_COMMIT_ACTIVITY",
@@ -2409,12 +2479,12 @@
2479 {
2480 "slug": "GITHUB_GET_THE_WEEKLY_COMMIT_COUNT",
2481 "name": "Get the weekly commit count",
2412 - "description": "Retrieves the weekly commit count for a repository, detailing commits by the owner and all contributors over the last 52 weeks; github may return a 202 status or an empty response if statistics are being computed."
2482 + "description": "Retrieves the weekly commit count for a repository, detailing commits by the owner and all contributors over the last 52 weeks; GitHub may return a 202 status or an empty response if statistics are being computed."
2483 },
2484 {
2485 "slug": "GITHUB_GET_THE_ZEN_OF_GITHUB",
2416 - "name": "Get the zen of github",
2417 - "description": "Retrieves a random quote from github's 'zen of github' collection, reflecting github's design philosophies and offering humorous insights, useful for displaying github wisdom or a lighthearted message."
2486 + "name": "Get the Zen of GitHub",
2487 + "description": "Retrieves a random quote from GitHub's 'Zen of GitHub' collection, reflecting GitHub's design philosophies and offering humorous insights, useful for displaying GitHub wisdom or a lighthearted message."
2488 },
2489 {
2490 "slug": "GITHUB_GET_TOP_REFERRAL_PATHS",
@@ -2444,82 +2514,32 @@
2514 {
2515 "slug": "GITHUB_GET_WORKFLOW_USAGE",
2516 "name": "Get workflow usage",
2447 - "description": "Gets the billable time (in milliseconds, broken down by runner os) for a specific workflow within a repository for the current billing cycle."
2448 - },
2449 - {
2450 - "slug": "GITHUB_GIST_S_CREATE",
2451 - "name": "Create a gist",
2452 - "description": "Deprecated: use `create a gist` instead. creates a new github gist with specified files, content, an optional description, and public visibility."
2453 - },
2454 - {
2455 - "slug": "GITHUB_GIST_S_LIST_PUBLIC",
2456 - "name": "List public gists",
2457 - "description": "(deprecated: use `list public gists` instead) lists public gists from github, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first."
2458 - },
2459 - {
2460 - "slug": "GITHUB_GITHUB_API_ROOT",
2461 - "name": "Get GitHub API root",
2462 - "description": "Retrieves a map of all top-level github rest api resource urls and their templates."
2463 - },
2464 - {
2465 - "slug": "GITHUB_GITHUB_GET_REPO_ALLOWED_ACTIONS",
2466 - "name": "Get allowed actions and workflows for a repository",
2467 - "description": "Gets the settings for allowed actions and reusable workflows that can be run in the specified repository."
2468 - },
2469 - {
2470 - "slug": "GITHUB_GITHUB_SET_REPO_RUNNER_LABELS",
2471 - "name": "Set custom labels for repo runner",
2472 - "description": "Replaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels."
2473 - },
2474 - {
2475 - "slug": "GITHUB_ISSUES_CREATE",
2476 - "name": "Create an issue",
2477 - "description": "(deprecated: use `create an issue` instead) creates a new issue in a github repository, provided issues are enabled and the user has sufficient permissions."
2478 - },
2479 - {
2480 - "slug": "GITHUB_ISSUES_CREATE_COMMENT",
2481 - "name": "Create an issue comment",
2482 - "description": "Deprecated: use `create an issue comment` to create a comment on an existing github issue or pull request."
2483 - },
2484 - {
2485 - "slug": "GITHUB_ISSUES_GET",
2486 - "name": "Get an issue",
2487 - "description": "Deprecated: use the `get an issue` action instead to retrieve details for a specific issue in a repository."
2488 - },
2489 - {
2490 - "slug": "GITHUB_ISSUES_LIST_ASSIGN_EES",
2491 - "name": "List assignees",
2492 - "description": "Deprecated: use `list assignees`. lists users who can be assigned to issues in a repository, typically those with push access."
2493 - },
2494 - {
2495 - "slug": "GITHUB_ISSUES_LIST_EVENTS_FOR_REPO",
2496 - "name": "List issue events for a repository",
2497 - "description": "Lists all issue events for a specified repository. <<deprecated: this action is deprecated. use `list issue events for a repository` instead.>>"
2498 - },
2499 - {
2500 - "slug": "GITHUB_ISSUES_LIST_FOR_REPO",
2501 - "name": "List repository issues",
2502 - "description": "Lists all issues (including pull requests) in a github repository; deprecated: use list repository issues."
2517 + "description": "Gets the billable time (in milliseconds, broken down by runner OS) for a specific workflow within a repository for the current billing cycle."
2518 },
2519 {
2520 "slug": "GITHUB_LIST_ACCEPTED_ASSIGNMENTS_FOR_AN_ASSIGNMENT",
2521 "name": "List accepted assignments for an assignment",
2507 - "description": "Lists accepted assignments (student repositories created after acceptance) for an existing github classroom assignment, identified by its unique `assignment id`."
2522 + "description": "Lists accepted assignments (student repositories created after acceptance) for an existing GitHub Classroom assignment, identified by its unique `assignment_id`."
2523 + },
2524 + {
2525 + "slug": "GITHUB_LIST_ACCESSIBLE_REPOSITORIES",
2526 + "name": "List repositories accessible via GitHub App installation",
2527 + "description": "Lists repositories that the authenticated user can access through a specific GitHub App installation. Returns repositories where the user has explicit :read, :write, or :admin permission through the installation. The response includes permission details for each repository. Prerequisites: - Requires a GitHub App user access token (not a standard OAuth token) - Use GITHUB_LIST_APP_INSTALLATIONS first to get valid installation IDs"
2528 },
2529 {
2510 - "slug": "GITHUB_LIST_APP_INSTALLATIONS_ACCESSIBLE_TO_THE_USER_ACCESS_TOKEN",
2530 + "slug": "GITHUB_LIST_APP_INSTALLATIONS",
2531 "name": "List app installations for user token",
2512 - "description": "Lists github app installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access."
2532 + "description": "Lists GitHub App installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access."
2533 },
2534 {
2535 "slug": "GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY",
2536 "name": "List artifacts for a repository",
2517 - "description": "Lists github actions workflow artifacts for a specified repository, which must exist."
2537 + "description": "Lists GitHub Actions workflow artifacts for a specified repository, which must exist."
2538 },
2539 {
2540 "slug": "GITHUB_LIST_ASSIGNED_ISSUES",
2541 "name": "List assigned issues for authenticated user",
2522 - "description": "Lists github issues for the authenticated user, defaulting to 'assigned' but filterable by other interactions, state, labels, and time, with sorting and pagination."
2542 + "description": "Lists GitHub issues for the authenticated user, defaulting to 'assigned' but filterable by other interactions, state, labels, and time, with sorting and pagination."
2543 },
2544 {
2545 "slug": "GITHUB_LIST_ASSIGNEES",
@@ -2529,42 +2549,47 @@
2549 {
2550 "slug": "GITHUB_LIST_ASSIGNMENTS_FOR_A_CLASSROOM",
2551 "name": "List assignments for a classroom",
2532 - "description": "Lists all assignments for a given github classroom `classroom id`; the classroom must exist and be accessible."
2552 + "description": "Lists all assignments for a given GitHub Classroom `classroom_id`; the classroom must exist and be accessible."
2553 },
2554 {
2555 "slug": "GITHUB_LIST_AVAILABLE_MACHINE_TYPES_FOR_A_REPOSITORY",
2556 "name": "List available machine types for a repository",
2537 - "description": "Lists machine types available for github codespaces in a repository, optionally using a git ref to check compatibility based on prebuild availability and devcontainer configurations."
2557 + "description": "Lists machine types available for GitHub Codespaces in a repository, optionally using a Git ref to check compatibility based on prebuild availability and devcontainer configurations."
2558 },
2559 {
2560 "slug": "GITHUB_LIST_BRANCHES",
2561 "name": "List branches",
2542 - "description": "Lists branches for an existing github repository, with an option to filter by protection status."
2562 + "description": "Lists branches for an existing GitHub repository, with an option to filter by protection status."
2563 },
2564 {
2565 "slug": "GITHUB_LIST_BRANCHES_FOR_HEAD_COMMIT",
2566 "name": "List branches for head commit",
2547 - "description": "Lists branches in an accessible repository where the provided commit sha is the head, useful for identifying development lines based on that commit."
2567 + "description": "Lists branches in an accessible repository where the provided commit SHA is the head, useful for identifying development lines based on that commit."
2568 },
2569 {
2570 "slug": "GITHUB_LIST_CHECK_RUN_ANNOTATIONS",
2571 "name": "List check run annotations",
2552 - "description": "Lists annotations for a specific check run in a github repository, detailing issues like errors or warnings on particular code lines."
2572 + "description": "Lists annotations for a specific check run in a GitHub repository, detailing issues like errors or warnings on particular code lines."
2573 },
2574 {
2575 "slug": "GITHUB_LIST_CHECK_RUNS_FOR_A_GIT_REFERENCE",
2576 "name": "List check runs for a git reference",
2557 - "description": "Lists check runs for a given git reference within a repository; ensure the reference exists and the repository is accessible."
2577 + "description": "Lists check runs for a given Git reference within a repository; ensure the reference exists and the repository is accessible."
2578 + },
2579 + {
2580 + "slug": "GITHUB_LIST_CHECK_RUNS_FOR_A_REF",
2581 + "name": "List check runs for a git ref",
2582 + "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."
2583 },
2584 {
2585 "slug": "GITHUB_LIST_CHECK_RUNS_IN_A_CHECK_SUITE",
2586 "name": "List check runs in a check suite",
2562 - "description": "Lists check runs for a specific check suite in a github repository, optionally filtering by check name or status."
2587 + "description": "Lists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status."
2588 },
2589 {
2590 "slug": "GITHUB_LIST_CHECK_SUITES_FOR_A_GIT_REFERENCE",
2591 "name": "List check suites for a git reference",
2567 - "description": "Lists check suites for a git reference (commit sha, branch, or tag) in a repository, optionally filtering by github app id or check run name."
2592 + "description": "Lists check suites for a Git reference (commit SHA, branch, or tag) in a repository, optionally filtering by GitHub App ID or check run name."
2593 },
2594 {
2595 "slug": "GITHUB_LIST_CHILD_TEAMS",
@@ -2574,57 +2599,57 @@
2599 {
2600 "slug": "GITHUB_LIST_CLASSROOMS",
2601 "name": "List classrooms",
2577 - "description": "Lists github classrooms to which the authenticated user has administrative access."
2602 + "description": "Lists GitHub Classrooms to which the authenticated user has administrative access."
2603 },
2604 {
2605 "slug": "GITHUB_LIST_CODEOWNERS_ERRORS",
2606 "name": "List codeowners errors",
2582 - "description": "Lists syntax errors in a repository's codeowners file, which must be located at the root, `.github/`, or `docs/` directory for the specified ref."
2607 + "description": "Lists syntax errors in a repository's CODEOWNERS file, which must be located at the root, `.github/`, or `docs/` directory for the specified ref."
2608 },
2609 {
2610 "slug": "GITHUB_LIST_CODE_QL_DATABASES_FOR_A_REPOSITORY",
2611 "name": "List CodeQL databases for a repository",
2587 - "description": "Lists all codeql databases for a repository where codeql analysis has been previously run and completed."
2612 + "description": "Lists all CodeQL databases for a repository where CodeQL analysis has been previously run and completed."
2613 },
2614 {
2615 "slug": "GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_AN_ORGANIZATION",
2616 "name": "List code scanning alerts for an organization",
2592 - "description": "Lists code scanning alerts for a github organization; use either `tool name` or `tool guid` if filtering by tool, not both."
2617 + "description": "Lists code scanning alerts for a GitHub organization; use EITHER `tool_name` OR `tool_guid` if filtering by tool, not both."
2618 },
2619 {
2620 "slug": "GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_A_REPOSITORY",
2621 "name": "List code scanning alerts for a repository",
2597 - "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."
2622 + "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."
2623 },
2624 {
2625 "slug": "GITHUB_LIST_CODE_SCANNING_ANALYSES_FOR_A_REPOSITORY",
2626 "name": "List code scanning analyses for a repository",
2602 - "description": "Lists code scanning analyses for an existing repository, optionally filtering by tool (name or guid), git reference, or sarif id."
2627 + "description": "Lists code scanning analyses for an existing repository, optionally filtering by tool (name or GUID), Git reference, or SARIF ID."
2628 },
2629 {
2630 "slug": "GITHUB_LIST_CODESPACES_FOR_A_USER_IN_ORGANIZATION",
2631 "name": "List codespaces for a user in organization",
2607 - "description": "Lists all github codespaces owned by a specified member of a given organization."
2632 + "description": "Lists all GitHub Codespaces owned by a specified member of a given organization."
2633 },
2634 {
2635 "slug": "GITHUB_LIST_CODESPACES_FOR_THE_AUTHENTICATED_USER",
2636 "name": "List codespaces for the authenticated user",
2612 - "description": "Lists github codespaces for the authenticated user, optionally filtering by repository id and supporting pagination."
2637 + "description": "Lists GitHub Codespaces for the authenticated user, optionally filtering by repository ID and supporting pagination."
2638 },
2639 {
2640 "slug": "GITHUB_LIST_CODESPACES_FOR_THE_ORGANIZATION",
2641 "name": "List codespaces for the organization",
2617 - "description": "Lists active/pending github codespaces for an existing organization; admins list all, members list their own."
2642 + "description": "Lists active/pending GitHub Codespaces for an existing organization; admins list all, members list their own."
2643 },
2644 {
2645 "slug": "GITHUB_LIST_COMMENTS_FOR_A_PULL_REQUEST_REVIEW",
2646 "name": "List comments for a pull request review",
2622 - "description": "Lists all comments for a specific review on a github pull request."
2647 + "description": "Lists all comments for a specific review on a GitHub pull request."
2648 },
2649 {
2650 "slug": "GITHUB_LIST_COMMIT_COMMENTS",
2651 "name": "List commit comments",
2627 - "description": "Retrieves all comments for a specific commit in a github repository, supporting pagination."
2652 + "description": "Retrieves all comments for a specific commit in a GitHub repository, supporting pagination."
2653 },
2654 {
2655 "slug": "GITHUB_LIST_COMMIT_COMMENTS_FOR_A_REPOSITORY",
@@ -2634,7 +2659,7 @@
2659 {
2660 "slug": "GITHUB_LIST_COMMITS",
2661 "name": "List commits",
2637 - "description": "Retrieves commits for a repository, optionally filtering by sha (must be valid commit sha or existing branch), path, author, committer, or date range."
2662 + "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."
2663 },
2664 {
2665 "slug": "GITHUB_LIST_COMMITS_ON_A_PULL_REQUEST",
@@ -2644,12 +2669,12 @@
2669 {
2670 "slug": "GITHUB_LIST_COMMIT_STATUSES_FOR_A_REFERENCE",
2671 "name": "List commit statuses for a reference",
2647 - "description": "Lists commit statuses for a specific reference (commit sha, branch, or tag) in a repository, useful for tracking ci/test outcomes."
2672 + "description": "Lists commit statuses for a specific reference (commit SHA, branch, or tag) in a repository, useful for tracking CI/test outcomes."
2673 },
2674 {
2675 "slug": "GITHUB_LIST_CUSTOM_PROPERTY_VALUES_FOR_ORGANIZATION_REPOSITORIES",
2676 "name": "List custom property values for organization repositories",
2652 - "description": "Lists custom property values for repositories in a specified, existing organization, optionally filtered by a repository query."
2677 + "description": "Lists repositories in an organization with their custom property values. Requires 'Custom properties' organization permission (read)."
2678 },
2679 {
2680 "slug": "GITHUB_LIST_DELIVERIES_FOR_AN_ORGANIZATION_WEBHOOK",
@@ -2659,17 +2684,17 @@
2684 {
2685 "slug": "GITHUB_LIST_DELIVERIES_FOR_A_REPOSITORY_WEBHOOK",
2686 "name": "List deliveries for a repository webhook",
2662 - "description": "Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook id exists."
2687 + "description": "Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook ID exists."
2688 },
2689 {
2690 "slug": "GITHUB_LIST_DEPLOY_KEYS",
2691 "name": "List deploy keys",
2667 - "description": "Lists deploy ssh keys for a specified repository; the repository must exist."
2692 + "description": "Lists deploy SSH keys for a specified repository; the repository must exist."
2693 },
2694 {
2695 "slug": "GITHUB_LIST_DEPLOYMENT_BRANCH_POLICIES",
2696 "name": "List deployment branch policies",
2672 - "description": "Lists all deployment branch policies for a specified environment in a github repository."
2697 + "description": "Lists all deployment branch policies for a specified environment in a GitHub repository."
2698 },
2699 {
2700 "slug": "GITHUB_LIST_DEPLOYMENTS",
@@ -2684,22 +2709,22 @@
2709 {
2710 "slug": "GITHUB_LIST_DISCUSSION_COMMENTS",
2711 "name": "List discussion comments",
2687 - "description": "Lists all comments for a specific team discussion within an organization."
2712 + "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."
2713 },
2714 {
2715 "slug": "GITHUB_LIST_DISCUSSIONS",
2716 "name": "List discussions",
2692 - "description": "Lists discussions for a specific team within an organization, with options for sorting, pagination, and filtering by pinned status."
2717 + "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."
2718 },
2719 {
2720 "slug": "GITHUB_LIST_EMAIL_ADDRESSES_FOR_THE_AUTHENTICATED_USER",
2721 "name": "List email addresses for the authenticated user",
2697 - "description": "Lists all email addresses for the authenticated user, including their primary status, verification status, and visibility."
2722 + "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."
2723 },
2724 {
2725 "slug": "GITHUB_LIST_ENVIRONMENT_CUSTOM_DEPLOYMENT_RULES",
2726 "name": "List environment custom deployment rules",
2702 - "description": "Lists all custom deployment protection rule integrations for a repository environment; the `environment name` must be url-encoded."
2727 + "description": "Lists all custom deployment protection rule integrations for a repository environment; the `environment_name` must be URL-encoded."
2728 },
2729 {
2730 "slug": "GITHUB_LIST_ENVIRONMENTS",
@@ -2709,32 +2734,32 @@
2734 {
2735 "slug": "GITHUB_LIST_ENVIRONMENT_SECRETS",
2736 "name": "List environment secrets",
2712 - "description": "Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing github repository."
2737 + "description": "Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing GitHub repository."
2738 },
2739 {
2740 "slug": "GITHUB_LIST_ENVIRONMENT_VARIABLES",
2741 "name": "List environment variables",
2717 - "description": "Lists all environment variables, which are plaintext key-value pairs for github actions workflows, for a specified environment within a github repository."
2742 + "description": "Lists all environment variables, which are plaintext key-value pairs for GitHub Actions workflows, for a specified environment within a GitHub repository."
2743 },
2744 {
2745 "slug": "GITHUB_LIST_EVENTS_FOR_THE_AUTHENTICATED_USER",
2746 "name": "List events for the authenticated user",
2722 - "description": "Lists public events for the specified github user, or private events if authenticated as that user, in reverse chronological order."
2747 + "description": "Lists public events for the specified GitHub user, or private events if authenticated as that user, in reverse chronological order."
2748 },
2749 {
2750 "slug": "GITHUB_LIST_EVENTS_RECEIVED_BY_THE_AUTHENTICATED_USER",
2751 "name": "List events received by the authenticated user",
2727 - "description": "Lists events a specific github user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public."
2752 + "description": "Lists events a specific GitHub user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public."
2753 },
2754 {
2755 "slug": "GITHUB_LIST_FOLLOWERS_OF_A_USER",
2756 "name": "List followers of a user",
2732 - "description": "Lists followers for a specified, existing github user."
2757 + "description": "Lists followers for a specified, existing GitHub user."
2758 },
2759 {
2760 "slug": "GITHUB_LIST_FOLLOWERS_OF_THE_AUTHENTICATED_USER",
2761 "name": "List followers of the authenticated user",
2737 - "description": "Lists users following the authenticated github user, returning an empty list if the user has no followers."
2762 + "description": "Lists users following the authenticated GitHub user, returning an empty list if the user has no followers."
2763 },
2764 {
2765 "slug": "GITHUB_LIST_FORKS",
@@ -2744,7 +2769,7 @@
2769 {
2770 "slug": "GITHUB_LIST_GIST_COMMENTS",
2771 "name": "List gist comments",
2747 - "description": "Lists comments for a specified github gist."
2772 + "description": "Lists comments for a specified GitHub Gist."
2773 },
2774 {
2775 "slug": "GITHUB_LIST_GIST_COMMITS",
@@ -2754,12 +2779,12 @@
2779 {
2780 "slug": "GITHUB_LIST_GIST_FORKS",
2781 "name": "List gist forks",
2757 - "description": "Lists all forks for a given github gist id."
2782 + "description": "Lists all forks for a given GitHub gist ID."
2783 },
2784 {
2785 "slug": "GITHUB_LIST_GISTS_FOR_A_USER",
2786 "name": "List gists for a user",
2762 - "description": "Lists public gists for a specified github user."
2787 + "description": "_lists public gists for a specified GitHub user._"
2788 },
2789 {
2790 "slug": "GITHUB_LIST_GISTS_FOR_THE_AUTHENTICATED_USER",
@@ -2769,32 +2794,32 @@
2794 {
2795 "slug": "GITHUB_LIST_GITHUB_ACTIONS_CACHES_FOR_A_REPOSITORY",
2796 "name": "List github actions caches for a repository",
2772 - "description": "Lists github actions caches for a repository, with options to filter by git reference or cache key, and to sort and paginate results."
2797 + "description": "Lists GitHub Actions caches for a repository, with options to filter by Git reference or cache key, and to sort and paginate results."
2798 },
2799 {
2800 "slug": "GITHUB_LIST_GITHUB_PAGES_BUILDS",
2801 "name": "List GitHub Pages builds",
2777 - "description": "Lists github pages builds for a repository; github pages must be enabled on the repository for builds to be listed."
2802 + "description": "Lists GitHub Pages builds for a repository; GitHub Pages must be enabled on the repository for builds to be listed."
2803 },
2804 {
2805 "slug": "GITHUB_LIST_GLOBAL_SECURITY_ADVISORIES",
2806 "name": "List global security advisories",
2782 - "description": "Lists github's global security advisories, filterable by various attributes including id, type, ecosystem, severity, and dates."
2807 + "description": "Lists GitHub's global security advisories, filterable by various attributes including ID, type, ecosystem, severity, and dates."
2808 },
2809 {
2810 "slug": "GITHUB_LIST_INSTALLATION_REQUESTS_FOR_THE_AUTHENTICATED_APP",
2811 "name": "List installation requests for the authenticated app",
2787 - "description": "Lists pending installation requests made by users or organizations for the authenticated github app."
2812 + "description": "Lists pending installation requests made by users or organizations for the authenticated GitHub App."
2813 },
2814 {
2815 "slug": "GITHUB_LIST_INSTANCES_OF_A_CODE_SCANNING_ALERT",
2816 "name": "List instances of a code scanning alert",
2792 - "description": "Lists all instances of a specific code scanning alert, optionally filtered by git ref; requires code scanning to be enabled on the repository."
2817 + "description": "Lists all instances of a specific code scanning alert, optionally filtered by Git ref; requires code scanning to be enabled on the repository."
2818 },
2819 {
2820 "slug": "GITHUB_LIST_ISSUE_COMMENTS",
2821 "name": "List issue comments",
2797 - "description": "Lists comments for a specified issue in a github repository."
2822 + "description": "Lists comments for a specified issue in a GitHub repository."
2823 },
2824 {
2825 "slug": "GITHUB_LIST_ISSUE_COMMENTS_FOR_A_REPOSITORY",
@@ -2804,7 +2829,7 @@
2829 {
2830 "slug": "GITHUB_LIST_ISSUE_EVENTS",
2831 "name": "List issue events",
2807 - "description": "Retrieves a list of all events for a specific issue within a github repository."
2832 + "description": "Retrieves a list of all events for a specific issue within a GitHub repository."
2833 },
2834 {
2835 "slug": "GITHUB_LIST_ISSUE_EVENTS_FOR_A_REPOSITORY",
@@ -2814,32 +2839,32 @@
2839 {
2840 "slug": "GITHUB_LIST_ISSUES_ASSIGNED_TO_THE_AUTHENTICATED_USER",
2841 "name": "List issues for user",
2817 - "description": "Lists github issues for the authenticated user across visible repositories, with filtering by user relationship, state, labels, an iso 8601 `since` timestamp (yyyy-mm-ddthh:mm:ssz), and sorting options; pull requests are typically included."
2842 + "description": "Lists GitHub issues for the authenticated user across visible repositories, with filtering by user relationship, state, labels, an ISO 8601 `since` timestamp (YYYY-MM-DDTHH:MM:SSZ), and sorting options; pull requests are typically included."
2843 },
2844 {
2845 "slug": "GITHUB_LIST_JOBS_FOR_A_WORKFLOW_RUN",
2846 "name": "List jobs for a workflow run",
2822 - "description": "Lists jobs for a specific workflow run in a github repository."
2847 + "description": "Lists jobs for a specific workflow run in a GitHub repository."
2848 },
2849 {
2850 "slug": "GITHUB_LIST_JOBS_FOR_A_WORKFLOW_RUN_ATTEMPT",
2851 "name": "List jobs for a workflow run attempt",
2827 - "description": "Lists jobs, including details like id, status, and steps, for a specific attempt of a github actions workflow run."
2852 + "description": "Lists jobs, including details like ID, status, and steps, for a specific attempt of a GitHub Actions workflow run."
2853 },
2854 {
2855 "slug": "GITHUB_LIST_LABELS_FOR_AN_ISSUE",
2856 "name": "List labels for an issue",
2832 - "description": "Lists all labels for a specified issue in a github repository."
2857 + "description": "Lists all labels for a specified issue in a GitHub repository."
2858 },
2859 {
2860 "slug": "GITHUB_LIST_LABELS_FOR_A_REPOSITORY",
2861 "name": "List labels for a repository",
2837 - "description": "Retrieves all labels for a specified, existing github repository."
2862 + "description": "Retrieves all labels for a specified, existing GitHub repository."
2863 },
2864 {
2865 "slug": "GITHUB_LIST_LABELS_FOR_A_SELF_HOSTED_RUNNER_FOR_AN_ORGANIZATION",
2866 "name": "List labels for a self-hosted runner for an organization",
2842 - "description": "Lists all labels assigned to a specific self-hosted runner within a github organization, which are used to route workflows."
2867 + "description": "Lists all labels assigned to a specific self-hosted runner within a GitHub organization, which are used to route workflows."
2868 },
2869 {
2870 "slug": "GITHUB_LIST_LABELS_FOR_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORY",
@@ -2859,13 +2884,18 @@
2884 {
2885 "slug": "GITHUB_LIST_MATCHING_REFERENCES",
2886 "name": "List matching references",
2862 - "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`)."
2887 + "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`)."
2888 },
2889 {
2890 "slug": "GITHUB_LIST_MILESTONES",
2891 "name": "List milestones",
2892 "description": "Lists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting."
2893 },
2894 + {
2895 + "slug": "GITHUB_LIST_NOTIFICATIONS",
2896 + "name": "List notifications for authenticated user",
2897 + "description": "Tool to list notification threads for the authenticated user with efficient polling support. Use when you need to fetch the user's GitHub notification inbox with filters like unread/participating/since. Returns notification threads plus polling headers (Last-Modified, ETag, X-Poll-Interval) for efficient polling. IMPORTANT: This endpoint requires a Personal Access Token (classic) with 'notifications' or 'repo' scope. It does NOT work with GitHub App tokens or fine-grained personal access tokens. If the token type is incompatible, a clear error message will be returned."
2898 + },
2899 {
2900 "slug": "GITHUB_LIST_NOTIFICATIONS_FOR_THE_AUTHENTICATED_USER",
2901 "name": "List notifications for the authenticated user",
@@ -2874,97 +2904,97 @@
2904 {
2905 "slug": "GITHUB_LIST_ORGANIZATION_EVENTS_FOR_THE_AUTHENTICATED_USER",
2906 "name": "List organization events for the authenticated user",
2877 - "description": "Lists events within a specified organization that were performed by the authenticated user, whose `username` (path parameter) must match the api request credentials."
2907 + "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."
2908 },
2909 {
2910 "slug": "GITHUB_LIST_ORGANIZATION_MEMBERS",
2911 "name": "List organization members",
2882 - "description": "Lists public and concealed members of a github organization; viewing concealed members requires authenticated user to be an organization member."
2912 + "description": "Lists public and concealed members of a GitHub organization; viewing concealed members requires authenticated user to be an organization member."
2913 },
2914 {
2915 "slug": "GITHUB_LIST_ORGANIZATION_PROJECTS",
2916 "name": "List organization projects",
2887 - "description": "Lists projects for a specified github organization, optionally filtering by state and supporting pagination."
2917 + "description": "Lists projects (V2) for a specified GitHub organization, with optional search query and cursor-based pagination."
2918 },
2919 {
2920 "slug": "GITHUB_LIST_ORGANIZATION_REPOSITORIES",
2921 "name": "List organization repositories",
2892 - "description": "Retrieves a list of repositories for a specified github organization, allowing filtering by type and sorting."
2922 + "description": "Retrieves a list of repositories for a specified GitHub organization, allowing filtering by type and sorting."
2923 },
2924 {
2925 "slug": "GITHUB_LIST_ORGANIZATIONS",
2926 "name": "List organizations",
2897 - "description": "Lists github organizations for the authenticated user, sorted by id in ascending order."
2927 + "description": "Lists GitHub organizations for the authenticated user, sorted by ID in ascending order."
2928 },
2929 {
2930 "slug": "GITHUB_LIST_ORGANIZATION_SECRETS",
2931 "name": "List organization secrets",
2902 - "description": "Lists github actions secrets available for a specified organization."
2932 + "description": "Lists GitHub Actions secrets available for a specified organization."
2933 },
2934 {
2935 "slug": "GITHUB_LIST_ORGANIZATIONS_FOR_A_USER",
2936 "name": "List organizations for a user",
2907 - "description": "Lists public organizations for a specified github user; the `username` must be a valid github handle."
2937 + "description": "Lists public organizations for a specified GitHub user; the `username` must be a valid GitHub handle."
2938 },
2939 {
2940 "slug": "GITHUB_LIST_ORGANIZATIONS_FOR_THE_AUTHENTICATED_USER",
2941 "name": "List organizations for the authenticated user",
2912 - "description": "Lists organizations the authenticated github user is a member of, returning details for each organization."
2942 + "description": "Lists organizations the authenticated GitHub user is a member of, returning details for each organization."
2943 },
2944 {
2945 "slug": "GITHUB_LIST_ORGANIZATION_VARIABLES",
2946 "name": "List organization variables",
2917 - "description": "Lists all github actions variables for a specified organization."
2947 + "description": "Lists all GitHub Actions variables for a specified organization."
2948 },
2949 {
2950 "slug": "GITHUB_LIST_ORGANIZATION_WEBHOOKS",
2951 "name": "List organization webhooks",
2922 - "description": "Lists all webhooks for a specified github organization; the organization must exist."
2952 + "description": "Lists all webhooks for a specified GitHub organization; the organization must exist."
2953 },
2954 {
2955 "slug": "GITHUB_LIST_ORG_FINE_GRAINED_PERMISSIONS",
2956 "name": "List organization fine-grained permissions",
2927 - "description": "Retrieves all fine-grained permissions for a specified github organization, essential for creating or updating custom roles."
2957 + "description": "Lists all fine-grained permissions available in a GitHub organization for use in custom organization roles. These permissions define granular access controls that can be combined when creating custom roles. Note: This endpoint requires GitHub Enterprise Cloud with the custom organization roles feature enabled. The authenticated user must be an administrator or have the 'read_organization_custom_org_role' permission."
2958 },
2959 {
2960 "slug": "GITHUB_LIST_ORG_ISSUES_FOR_USER",
2961 "name": "List organization issues assigned to the authenticated user",
2932 - "description": "Lists issues for the authenticated user within a specified github organization, with options to filter by involvement type, state, labels, and to sort results."
2962 + "description": "Lists issues for the authenticated user within a specified GitHub organization, with options to filter by involvement type, state, labels, and to sort results."
2963 },
2964 {
2965 "slug": "GITHUB_LIST_ORG_LEVEL_CODESPACES_SECRETS",
2966 "name": "List org level codespaces secrets",
2937 - "description": "Lists all codespaces secrets available for a specified organization, which must exist."
2967 + "description": "Lists all Codespaces secrets available for a specified organization, which must exist."
2968 },
2969 {
2970 "slug": "GITHUB_LIST_ORG_PACKAGE_VERSIONS",
2971 "name": "List package versions for an organization package",
2942 - "description": "Lists all versions for a specified package, if it exists and is owned by the given github organization."
2972 + "description": "Lists all versions for a specified package, if it exists and is owned by the given GitHub organization."
2973 },
2974 {
2975 "slug": "GITHUB_LIST_ORG_REPOS_WITHGITHUB_ACTIONS_ENABLED",
2976 "name": "List organization repositories with Github Actions enabled",
2947 - "description": "Lists repositories in an organization with github actions enabled, for use when the organization's policy restricts actions to a specific list of repositories rather than enabling it for all."
2977 + "description": "Lists the selected repositories that are enabled for GitHub Actions in an organization. This endpoint only returns results when the organization's 'enabled_repositories' permission policy is configured to 'selected'. Requires admin:org scope and organization admin permissions."
2978 },
2979 {
2980 "slug": "GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENS",
2981 "name": "List org resource access tokens",
2952 - "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."
2982 + "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."
2983 },
2984 {
2985 "slug": "GITHUB_LIST_ORG_RESOURCES_WITH_PERSONAL_TOKENS",
2986 "name": "List org resources with personal tokens",
2957 - "description": "Retrieves a list of an organization's fine-grained personal access token requests (pending, approved, or denied), with options for filtering and sorting."
2987 + "description": "Lists requests from organization members to access organization resources with fine-grained personal access tokens (pending, approved, or denied). Note: This endpoint requires GitHub App authentication with 'organization_personal_access_token_requests:read' permissions; it cannot be used with personal access tokens."
2988 },
2989 {
2990 "slug": "GITHUB_LIST_ORG_SECRETS_WITHOUT_VALUES",
2991 "name": "List organization Dependabot secrets without values",
2962 - "description": "Lists all dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist."
2992 + "description": "Lists all Dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist."
2993 },
2994 {
2995 "slug": "GITHUB_LIST_OUTSIDE_COLLABORATORS_FOR_AN_ORGANIZATION",
2996 "name": "List outside collaborators for an organization",
2967 - "description": "Lists outside collaborators for a github organization, with options to filter (e.g., by 2fa status) and paginate results."
2997 + "description": "Lists outside collaborators for a GitHub organization, with options to filter (e.g., by 2FA status) and paginate results."
2998 },
2999 {
3000 "slug": "GITHUB_LIST_OWNED_PACKAGE_VERSIONS",
@@ -2974,42 +3004,42 @@
3004 {
3005 "slug": "GITHUB_LIST_PACKAGES_FOR_AN_ORGANIZATION",
3006 "name": "List packages for an organization",
2977 - "description": "Lists github packages for an organization, noting specific interpretations for package type and visibility parameters."
3007 + "description": "Lists GitHub Packages for an organization, noting specific interpretations for package_type and visibility parameters."
3008 },
3009 {
3010 "slug": "GITHUB_LIST_PACKAGES_FOR_A_USER",
3011 "name": "List packages for a user",
2982 - "description": "Lists packages for a specified github user, filterable by package type and visibility."
3012 + "description": "Lists packages for a specified GitHub user, filterable by package type and visibility."
3013 },
3014 {
3015 "slug": "GITHUB_LIST_PACKAGES_FOR_THE_AUTHENTICATED_USER_S_NAMESPACE",
3016 "name": "List packages for the authenticated user's namespace",
2987 - "description": "Lists packages of a specific type and visibility within the authenticated user's namespace on github."
3017 + "description": "Lists packages of a specific type and visibility within the authenticated user's namespace on GitHub."
3018 },
3019 {
3020 "slug": "GITHUB_LIST_PACKAGE_VERSIONS_FOR_A_PACKAGE_OWNED_BY_A_USER",
3021 "name": "List package versions for a package owned by a user",
2992 - "description": "Lists all versions of a public package owned by a specific github user, identified by package type, package name, and username."
3022 + "description": "Lists all versions of a public package owned by a specific GitHub user, identified by package type, package name, and username."
3023 },
3024 {
3025 "slug": "GITHUB_LIST_PENDING_TEAM_INVITATIONS",
3026 "name": "List pending team invitations",
2997 - "description": "Lists all pending membership invitations for a specified team within an organization."
3027 + "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."
3028 },
3029 {
3030 "slug": "GITHUB_LIST_PROJECT_CARDS",
3001 - "name": "List project cards",
3002 - "description": "Lists all project cards for a given `column id`, which must correspond to an existing project column."
3031 + "name": "List project cards (Classic - Deprecated)",
3032 + "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."
3033 },
3034 {
3035 "slug": "GITHUB_LIST_PROJECT_COLLABORATORS",
3006 - "name": "List project collaborators",
3007 - "description": "Fetches a list of collaborators for a specified, existing github project."
3036 + "name": "List project collaborators (classic)",
3037 + "description": "Lists collaborators for a GitHub Project (classic) by project ID. IMPORTANT: This action uses the Projects (classic) REST API which was sunset on April 1, 2025 for GitHub.com. The API may still be available on GitHub Enterprise Server versions before 3.17. For GitHub.com users: GitHub Projects (classic) has been replaced by the new Projects experience. The new Projects does not have a REST API for listing collaborators - use the GitHub web interface to manage project collaborators instead. You must be an organization owner or a project admin to list collaborators."
3038 },
3039 {
3040 "slug": "GITHUB_LIST_PROJECT_COLUMNS",
3041 "name": "List project columns",
3012 - "description": "Lists all of a github project's columns (e.g., 'to do', 'in progress'); project id must identify a valid, accessible project."
3042 + "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."
3043 },
3044 {
3045 "slug": "GITHUB_LIST_PUBLIC_EMAIL_ADDRESSES_FOR_THE_AUTHENTICATED_USER",
@@ -3019,62 +3049,62 @@
3049 {
3050 "slug": "GITHUB_LIST_PUBLIC_EVENTS",
3051 "name": "List public events",
3022 - "description": "Lists public github events, which may be delayed by up to 5 minutes, with support for pagination."
3052 + "description": "Lists public GitHub events, which may be delayed by up to 5 minutes, with support for pagination."
3053 },
3054 {
3055 "slug": "GITHUB_LIST_PUBLIC_EVENTS_FOR_A_NETWORK_OF_REPOSITORIES",
3056 "name": "List public events for a network of repositories",
3027 - "description": "Retrieves public events (up to 90 days old, newest first) for a github repository network, including the repository and its forks."
3057 + "description": "Retrieves public events (up to 90 days old, newest first) for a GitHub repository network, including the repository and its forks."
3058 },
3059 {
3060 "slug": "GITHUB_LIST_PUBLIC_EVENTS_FOR_A_USER",
3061 "name": "List public events for a user",
3032 - "description": "Retrieves a list of public events for a specified github user, in reverse chronological order."
3062 + "description": "Retrieves a list of public events for a specified GitHub user, in reverse chronological order."
3063 },
3064 {
3065 "slug": "GITHUB_LIST_PUBLIC_EVENTS_RECEIVED_BY_A_USER",
3066 "name": "List public events received by a user",
3037 - "description": "Lists public events for a specified github user (e.g., activities in repositories they watch or are involved in); the target user's profile must be public, and if blocked by the authenticated user, a 404 error is returned."
3067 + "description": "Lists public events for a specified GitHub user (e.g., activities in repositories they watch or are involved in); the target user's profile must be public, and if blocked by the authenticated user, a 404 error is returned."
3068 },
3069 {
3070 "slug": "GITHUB_LIST_PUBLIC_GISTS",
3071 "name": "List public gists",
3042 - "description": "Lists public gists from github, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first."
3072 + "description": "Lists public gists from GitHub, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first."
3073 },
3074 {
3075 "slug": "GITHUB_LIST_PUBLIC_KEYS_FOR_A_USER",
3076 "name": "List public keys for a user",
3047 - "description": "Lists the verified public ssh keys for a specified github user."
3077 + "description": "Lists the verified public SSH keys for a specified GitHub user."
3078 },
3079 {
3080 "slug": "GITHUB_LIST_PUBLIC_ORGANIZATION_EVENTS",
3081 "name": "List public organization events",
3052 - "description": "Lists public events for a specified github organization, which must exist."
3082 + "description": "Lists public events for a specified GitHub organization, which must exist. This action retrieves the events that are publicly accessible for the organization specified. It returns a paginated list of events with details about each event."
3083 },
3084 {
3085 "slug": "GITHUB_LIST_PUBLIC_ORGANIZATION_MEMBERS",
3086 "name": "List public organization members",
3057 - "description": "Lists users who have publicly declared their membership in a specified, existing github organization."
3087 + "description": "Lists users who have publicly declared their membership in a specified, existing GitHub organization."
3088 },
3089 {
3090 "slug": "GITHUB_LIST_PUBLIC_REPOSITORIES",
3091 "name": "List public repositories",
3062 - "description": "Lists all public repositories on github; use the `since` parameter with a repository id from a previous result for pagination."
3092 + "description": "Lists all public repositories on GitHub; use the `since` parameter with a repository ID from a previous result for pagination."
3093 },
3094 {
3095 "slug": "GITHUB_LIST_PULL_REQUESTS",
3096 "name": "List pull requests",
3067 - "description": "Lists pull requests for a specified github repository with ai-friendly filtering."
3097 + "description": "Lists pull requests for a GitHub repository. REQUIRES 'owner' AND 'repo' parameters - both are MANDATORY and must be provided in every call. Does NOT support filtering by assignee or date range - use GITHUB_FIND_PULL_REQUESTS instead for searching PRs by assignee, author, or across multiple repositories."
3098 },
3099 {
3100 "slug": "GITHUB_LIST_PULL_REQUESTS_ASSOCIATED_WITH_A_COMMIT",
3101 "name": "List pull requests associated with a commit",
3072 - "description": "Lists pull requests for a commit; returns merged prs that introduced the commit if on the default branch, or open prs including the commit if on other branches."
3102 + "description": "Lists pull requests for a commit; returns merged PRs that introduced the commit if on the default branch, or open PRs including the commit if on other branches."
3103 },
3104 {
3105 "slug": "GITHUB_LIST_PULL_REQUESTS_FILES",
3106 "name": "List pull requests files",
3077 - "description": "Lists all files (including additions, modifications, and removals) associated with a specific pull request in a github repository."
3107 + "description": "Lists all files (including additions, modifications, and removals) associated with a specific pull request in a GitHub repository."
3108 },
3109 {
3110 "slug": "GITHUB_LIST_REACTIONS_FOR_A_COMMIT_COMMENT",
@@ -3084,12 +3114,12 @@
3114 {
3115 "slug": "GITHUB_LIST_REACTIONS_FOR_AN_ISSUE",
3116 "name": "List reactions for an issue",
3087 - "description": "Lists reactions for a specific, existing issue within an accessible github repository, optionally filtering by content type."
3117 + "description": "Lists reactions for a specific, existing issue within an accessible GitHub repository, optionally filtering by content type."
3118 },
3119 {
3120 "slug": "GITHUB_LIST_REACTIONS_FOR_AN_ISSUE_COMMENT",
3121 "name": "List reactions for an issue comment",
3092 - "description": "Lists reactions for a specific issue comment in a github repository, optionally filtering by content type."
3122 + "description": "Lists reactions for a specific issue comment in a GitHub repository, optionally filtering by content type."
3123 },
3124 {
3125 "slug": "GITHUB_LIST_REACTIONS_FOR_A_PULL_REQUEST_REVIEW_COMMENT",
@@ -3099,12 +3129,12 @@
3129 {
3130 "slug": "GITHUB_LIST_REACTIONS_FOR_A_RELEASE",
3131 "name": "List reactions for a release",
3102 - "description": "Lists all reactions, or optionally filters reactions by a specific content type, for a given github release."
3132 + "description": "Lists all reactions, or optionally filters reactions by a specific content type, for a given GitHub release."
3133 },
3134 {
3135 "slug": "GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSION",
3136 "name": "List reactions for a team discussion",
3107 - "description": "Lists reactions for an existing team discussion within an organization."
3137 + "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."
3138 },
3139 {
3140 "slug": "GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSION_COMMENT",
@@ -3114,7 +3144,7 @@
3144 {
3145 "slug": "GITHUB_LIST_RELEASE_ASSETS",
3146 "name": "List release assets",
3117 - "description": "Lists assets (e.g., compiled binaries, source code archives) for a specific github release, identified by `release id` which must be valid for an existing release in the repository."
3147 + "description": "Lists assets (e.g., compiled binaries, source code archives) for a specific GitHub release, identified by `release_id` which must be valid for an existing release in the repository."
3148 },
3149 {
3150 "slug": "GITHUB_LIST_RELEASES",
@@ -3124,47 +3154,42 @@
3154 {
3155 "slug": "GITHUB_LIST_REPO_ACCESS_BY_TOKEN",
3156 "name": "List repo access by token",
3127 - "description": "Lists repositories in an organization that a fine-grained personal access token (`pat request id`) has requested access to; must be performed by a github app."
3157 + "description": "Lists repositories in an organization that a fine-grained personal access token has requested access to. Only GitHub Apps can use this endpoint. Requires 'Personal access token requests' organization permissions (read)."
3158 },
3159 {
3160 "slug": "GITHUB_LIST_REPO_CODESPACES",
3161 "name": "List repo codespaces for authenticated user",
3132 - "description": "Lists codespaces the authenticated user can access within a specified, existing repository."
3162 + "description": "Lists Codespaces the authenticated user can access within a specified, existing repository."
3163 },
3164 {
3165 "slug": "GITHUB_LIST_REPO_DEV_CONTAINER_CONFIGS_FOR_USER",
3166 "name": "List repo dev container configs for user",
3137 - "description": "Lists the `devcontainer.json` configurations available in a specified repository for use with github codespaces."
3167 + "description": "Lists the `devcontainer.json` configurations available in a specified repository for use with GitHub Codespaces."
3168 },
3169 {
3170 "slug": "GITHUB_LIST_REPO_SECRETS_WITHOUT_VALUES",
3171 "name": "List repo secrets without values",
3142 - "description": "Lists all codespaces secrets available in a specific repository, without their encrypted values."
3172 + "description": "Lists all Codespaces secrets available in a specific repository, without their encrypted values."
3173 },
3174 {
3175 "slug": "GITHUB_LIST_REPOSITORIES_ACCESSIBLE_TO_THE_APP_INSTALLATION",
3176 "name": "List repos accessible to app installation",
3147 - "description": "Lists repositories an app installation can access; 'total count' in response is zero if none are accessible."
3148 - },
3149 - {
3150 - "slug": "GITHUB_LIST_REPOSITORIES_ACCESSIBLE_TO_THE_USER_ACCESS_TOKEN",
3151 - "name": "List repositories accessible to the user access token",
3152 - "description": "Lists repositories accessible to the authenticated user through a specific github app installation (identified by `installation id`)."
3177 + "description": "Lists repositories a GitHub App installation can access. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth/user access tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. Returns 'total_count' and 'repositories' array with pagination support."
3178 },
3179 {
3180 "slug": "GITHUB_LIST_REPOSITORIES_FOR_A_USER",
3181 "name": "List repositories for a user",
3157 - "description": "Lists public repositories for a specified github user, who must have an existing account."
3182 + "description": "Lists public repositories for a specified GitHub user, who must have an existing account."
3183 },
3184 {
3185 "slug": "GITHUB_LIST_REPOSITORIES_FOR_THE_AUTHENTICATED_USER",
3186 "name": "List repositories for the authenticated user",
3162 - "description": "Lists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' api parameters (not in this model) can cause a 422 error."
3187 + "description": "Lists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' API parameters (not in this model) can cause a 422 error."
3188 },
3189 {
3190 "slug": "GITHUB_LIST_REPOSITORIES_STARRED_BY_A_USER",
3191 "name": "List repositories starred by a user",
3167 - "description": "Lists repositories a valid and existing github user has starred."
3192 + "description": "Lists repositories a valid and existing GitHub user has starred."
3193 },
3194 {
3195 "slug": "GITHUB_LIST_REPOSITORIES_STARRED_BY_THE_AUTHENTICATED_USER",
@@ -3174,17 +3199,17 @@
3199 {
3200 "slug": "GITHUB_LIST_REPOSITORIES_WATCHED_BY_A_USER",
3201 "name": "List repositories watched by a user",
3177 - "description": "Lists repositories a given github user is watching; the username must be a valid and existing github user handle."
3202 + "description": "Lists repositories a given GitHub user is watching; the username must be a valid and existing GitHub user handle."
3203 },
3204 {
3205 "slug": "GITHUB_LIST_REPOSITORIES_WATCHED_BY_THE_AUTHENTICATED_USER",
3206 "name": "List repositories watched by the authenticated user",
3182 - "description": "Lists repositories the authenticated user is watching (subscribed to for notifications)."
3207 + "description": "Lists repositories the authenticated user is watching (subscribed to for notifications). This action retrieves a list of repositories that the authenticated user is currently watching. It allows the user to manage their watched repositories effectively."
3208 },
3209 {
3210 "slug": "GITHUB_LIST_REPOSITORY_ACTIVITIES",
3211 "name": "List repository activities",
3187 - "description": "Lists activities for a github repository, ensuring the repository exists and is accessible."
3212 + "description": "Lists activities for a GitHub repository, ensuring the repository exists and is accessible."
3213 },
3214 {
3215 "slug": "GITHUB_LIST_REPOSITORY_COLLABORATORS",
@@ -3199,12 +3224,12 @@
3224 {
3225 "slug": "GITHUB_LIST_REPOSITORY_EVENTS",
3226 "name": "List repository events",
3202 - "description": "Lists chronological events (e.g., code pushes, issue activities, pr actions, forks) for a specified, existing github repository."
3227 + "description": "Lists chronological events (e.g., code pushes, issue activities, PR actions, forks) for a specified, existing GitHub repository."
3228 },
3229 {
3230 "slug": "GITHUB_LIST_REPOSITORY_INVITATIONS",
3231 "name": "List repository invitations",
3207 - "description": "Retrieves all pending (unaccepted or undeclined) collaboration invitations for a specified github repository."
3232 + "description": "Retrieves all pending (unaccepted or undeclined) collaboration invitations for a specified GitHub repository."
3233 },
3234 {
3235 "slug": "GITHUB_LIST_REPOSITORY_INVITATIONS_FOR_THE_AUTHENTICATED_USER",
@@ -3214,12 +3239,12 @@
3239 {
3240 "slug": "GITHUB_LIST_REPOSITORY_ISSUES",
3241 "name": "List repository issues",
3217 - "description": "Lists issues (which include pull requests) for a specified, existing github repository, with options for filtering, sorting, and pagination."
3242 + "description": "Lists issues (including pull requests) from a GitHub repository. Requires BOTH 'owner' AND 'repo' parameters (e.g., owner='octocat', repo='Hello-World' for github.com/octocat/Hello-World)."
3243 },
3244 {
3245 "slug": "GITHUB_LIST_REPOSITORY_LANGUAGES",
3246 "name": "List repository languages",
3222 - "description": "Lists the programming languages used in a github repository, returning a byte count for each language."
3247 + "description": "Lists the programming languages used in a GitHub repository, returning a byte count for each language."
3248 },
3249 {
3250 "slug": "GITHUB_LIST_REPOSITORY_NOTIFICATIONS_FOR_THE_AUTHENTICATED_USER",
@@ -3234,12 +3259,12 @@
3259 {
3260 "slug": "GITHUB_LIST_REPOSITORY_ORGANIZATION_VARIABLES",
3261 "name": "List repository organization variables",
3237 - "description": "Lists organization variables accessible to a specific repository; the repository must exist."
3262 + "description": "Lists organization-level variables that are shared with a specific repository. The repository must belong to an organization (not a personal account)."
3263 },
3264 {
3265 "slug": "GITHUB_LIST_REPOSITORY_PROJECTS",
3266 "name": "List repository projects",
3242 - "description": "Lists projects associated with a specific repository."
3267 + "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)."
3268 },
3269 {
3270 "slug": "GITHUB_LIST_REPOSITORY_RULE_SUITES",
@@ -3249,17 +3274,17 @@
3274 {
3275 "slug": "GITHUB_LIST_REPOSITORY_SECRETS",
3276 "name": "List repository secrets",
3252 - "description": "Lists metadata for all secrets in a github repository, excluding their encrypted values."
3277 + "description": "Lists metadata for all secrets in a GitHub repository, excluding their encrypted values."
3278 },
3279 {
3280 "slug": "GITHUB_LIST_REPOSITORY_SECRETS_WITHOUT_DECRYPTING",
3281 "name": "List repository secrets without decrypting",
3257 - "description": "Lists metadata (e.g., name, creation/update dates) for all dependabot secrets in a repository; secret values are not included."
3282 + "description": "Lists metadata (e.g., name, creation/update dates) for all Dependabot secrets in a repository; secret values are not included."
3283 },
3284 {
3285 "slug": "GITHUB_LIST_REPOSITORY_TAGS",
3286 "name": "List repository tags",
3262 - "description": "Lists tags for a specified github repository."
3287 + "description": "Lists tags for a specified GitHub repository."
3288 },
3289 {
3290 "slug": "GITHUB_LIST_REPOSITORY_TEAMS",
@@ -3269,7 +3294,7 @@
3294 {
3295 "slug": "GITHUB_LIST_REPOSITORY_VARIABLES",
3296 "name": "List repository variables",
3272 - "description": "Lists plain text key-value variables for github actions workflows within a specific, accessible repository."
3297 + "description": "Lists plain text key-value variables for GitHub Actions workflows within a specific, accessible repository."
3298 },
3299 {
3300 "slug": "GITHUB_LIST_REPOSITORY_WEBHOOKS",
@@ -3279,12 +3304,12 @@
3304 {
3305 "slug": "GITHUB_LIST_REPOSITORY_WORKFLOWS",
3306 "name": "List repository workflows",
3282 - "description": "Lists all github actions workflows for a specified repository, which must exist and be accessible."
3307 + "description": "Lists all GitHub Actions workflows for a specified repository, which must exist and be accessible."
3308 },
3309 {
3310 "slug": "GITHUB_LIST_REPOS_WITH_GHACTIONS_CACHE_USAGE",
3311 "name": "List repos with ghactions cache usage",
3287 - "description": "Retrieves a paginated list of github actions cache usage statistics for repositories within an existing github organization."
3312 + "description": "Retrieves a paginated list of GitHub Actions cache usage statistics for repositories within an existing GitHub organization."
3313 },
3314 {
3315 "slug": "GITHUB_LIST_REVIEW_COMMENTS_IN_A_REPOSITORY",
@@ -3294,52 +3319,57 @@
3319 {
3320 "slug": "GITHUB_LIST_REVIEW_COMMENTS_ON_A_PULL_REQUEST",
3321 "name": "List review comments on a pull request",
3297 - "description": "Lists all review comments on a specific pull request within a github repository."
3322 + "description": "Lists all review comments on a specific pull request within a GitHub repository."
3323 },
3324 {
3325 "slug": "GITHUB_LIST_REVIEWS_FOR_A_PULL_REQUEST",
3326 "name": "List reviews for a pull request",
3302 - "description": "Lists submitted reviews chronologically for a specific pull request within a github repository."
3327 + "description": "Lists submitted reviews chronologically for a specific pull request within a GitHub repository."
3328 },
3329 {
3330 "slug": "GITHUB_LIST_RUNNER_APPLICATIONS_FOR_AN_ORGANIZATION",
3331 "name": "List runner applications for an organization",
3307 - "description": "Lists downloadable github actions runner application binaries, used for setting up self-hosted runners, for an existing github organization."
3332 + "description": "Lists downloadable GitHub Actions runner application binaries for setting up self-hosted runners in a GitHub organization. Returns download URLs and checksums for various OS/architecture combinations (linux/win/osx on x64/arm/arm64). Requires admin:org scope or fine-grained 'Self-hosted runners' read permission."
3333 },
3334 {
3335 "slug": "GITHUB_LIST_RUNNER_APPLICATIONS_FOR_A_REPOSITORY",
3336 "name": "List runner applications for a repository",
3312 - "description": "Lists available self-hosted runner application binaries for a specific repository, including their os, architecture, and download url."
3337 + "description": "Lists available self-hosted runner application binaries for a specific repository, including their OS, architecture, and download URL."
3338 + },
3339 + {
3340 + "slug": "GITHUB_LIST_SECRET_SCANNING_ALERTS_FOR_A_REPOSITORY",
3341 + "name": "List secret scanning alerts for a repository",
3342 + "description": "List secret scanning alerts for a GitHub repository using first-party detections. Use this to retrieve detected secrets with filtering by state, type, resolution, and validity. Supports optional hiding of secret literals for security."
3343 },
3344 {
3345 "slug": "GITHUB_LIST_SECRETS_FOR_THE_AUTHENTICATED_USER",
3346 "name": "List secrets for the authenticated user",
3317 - "description": "Lists all codespaces secrets accessible to the authenticated user for use within github codespaces."
3347 + "description": "Lists all Codespaces secrets accessible to the authenticated user for use within GitHub Codespaces."
3348 },
3349 {
3350 "slug": "GITHUB_LIST_SELECTED_REPOS_FOR_SECRET_ACCESS",
3351 "name": "List selected repos for secret access",
3322 - "description": "Lists repositories within a specified organization that have been granted access to a particular dependabot secret."
3352 + "description": "Lists repositories within a specified organization that have been granted access to a particular Dependabot secret. 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. Requires 'admin:org' scope and the user must have admin access to the organization."
3353 },
3354 {
3355 "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRET",
3326 - "name": "List selected repositories for an organization secret",
3327 - "description": "Lists repositories within an organization that have explicit access to a specific organization secret, which must have its visibility set to 'selected'."
3356 + "name": "List selected repositories for a Codespaces organization secret",
3357 + "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."
3358 },
3359 {
3360 "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_VARIABLE",
3361 "name": "List selected repositories for an organization variable",
3332 - "description": "Lists repositories in an organization that can access a specific organization variable; supports pagination and returns an empty list if no repositories have been granted access."
3362 + "description": "Lists repositories in an organization that can access a specific organization variable; supports pagination and returns an empty list if no repositories have been granted access. Note: This endpoint only works for variables with visibility set to 'selected' - attempting to use it on variables with 'all' or 'private' visibility will result in a 409 Conflict error."
3363 },
3364 {
3365 "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_A_USER_SECRET",
3366 "name": "List selected repositories for a user secret",
3337 - "description": "Lists repositories that have access to the specified user secret for the authenticated user's codespaces, provided the user has codespaces access."
3367 + "description": "Lists repositories that have access to the specified user Codespaces secret. This endpoint retrieves all repositories that the authenticated user has granted access to for a specific user-level Codespaces secret. The secret must already exist for this endpoint to work. Use 'list_secrets_for_the_authenticated_user' to discover available secrets first. Note: The authenticated user must have Codespaces access enabled. OAuth tokens and personal access tokens require the 'codespace' or 'codespace:secrets' scope."
3368 },
3369 {
3370 "slug": "GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_AN_ORGANIZATION",
3371 "name": "List self hosted runners for an organization",
3342 - "description": "Lists self-hosted runners for a github organization, optionally filtering by name and paginating results, providing details for each runner such as os, status, and labels."
3372 + "description": "Lists self-hosted runners for a GitHub organization, optionally filtering by name and paginating results, providing details for each runner such as OS, status, and labels."
3373 },
3374 {
3375 "slug": "GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_A_REPOSITORY",
@@ -3349,17 +3379,17 @@
3379 {
3380 "slug": "GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_A_USER",
3381 "name": "List social accounts for a user",
3352 - "description": "Lists social media accounts publicly linked to an existing github user's profile."
3382 + "description": "Lists social media accounts publicly linked to an existing GitHub user's profile."
3383 },
3384 {
3385 "slug": "GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER",
3386 "name": "List social accounts for the authenticated user",
3357 - "description": "Lists all social media accounts linked to the authenticated user's github profile."
3387 + "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."
3388 },
3389 {
3390 "slug": "GITHUB_LIST_STARGAZERS",
3391 "name": "List stargazers",
3362 - "description": "Lists users who have starred the specified github repository, which must exist."
3392 + "description": "Lists users who have starred the specified GitHub repository, which must exist."
3393 },
3394 {
3395 "slug": "GITHUB_LIST_STARRED_GISTS",
@@ -3369,17 +3399,17 @@
3399 {
3400 "slug": "GITHUB_LIST_SUBSCRIPTIONS_FOR_THE_AUTHENTICATED_USER",
3401 "name": "List subscriptions for the authenticated user",
3372 - "description": "Lists the authenticated user's active github marketplace subscriptions."
3402 + "description": "Lists the authenticated user's active GitHub Marketplace subscriptions."
3403 },
3404 {
3405 "slug": "GITHUB_LIST_SUBSCRIPTIONS_FOR_THE_AUTHENTICATED_USER_STUBBED",
3406 "name": "List stubbed subscriptions for the authenticated user",
3377 - "description": "Lists the authenticated user's stubbed (test/example data, not live) github marketplace subscriptions, useful for development or testing."
3407 + "description": "Lists the authenticated user's stubbed (test/example data, not live) GitHub Marketplace subscriptions, useful for development or testing."
3408 },
3409 {
3410 "slug": "GITHUB_LIST_TAG_PROTECTION_STATES_FOR_A_REPOSITORY",
3411 "name": "List tag protection states for a repository",
3382 - "description": "Lists all active tag protection rules for a repository, defining patterns to prevent matching tags from being created or deleted; requires repository admin permissions."
3412 + "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."
3413 },
3414 {
3415 "slug": "GITHUB_LIST_TEAM_MEMBERS",
@@ -3389,17 +3419,17 @@
3419 {
3420 "slug": "GITHUB_LIST_TEAM_PROJECTS",
3421 "name": "List team projects",
3392 - "description": "Lists github projects accessible to a specific team within an organization."
3422 + "description": "Lists GitHub projects accessible to a specific team within an organization."
3423 },
3424 {
3425 "slug": "GITHUB_LIST_TEAM_REPOSITORIES",
3426 "name": "List team repositories",
3397 - "description": "Lists repositories accessible to a specific team within a github organization."
3427 + "description": "Lists repositories accessible to a specific team within a GitHub organization. Returns a list of repositories that the specified team has access to, including the team's permission level (admin, maintain, push, triage, pull) for each repository. Requires read:org scope and membership in the organization to access team data."
3428 },
3429 {
3430 "slug": "GITHUB_LIST_TEAMS",
3431 "name": "List teams",
3402 - "description": "Lists teams for a specified github organization."
3432 + "description": "Lists teams for a specified GitHub organization."
3433 },
3434 {
3435 "slug": "GITHUB_LIST_TEAMS_FOR_THE_AUTHENTICATED_USER",
@@ -3409,12 +3439,12 @@
3439 {
3440 "slug": "GITHUB_LIST_TEAMS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLE",
3441 "name": "List teams assigned to an organization role",
3412 - "description": "Lists teams assigned to a specific role within a github organization."
3442 + "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."
3443 },
3444 {
3445 "slug": "GITHUB_LIST_THE_PEOPLE_A_USER_FOLLOWS",
3446 "name": "List the people a user follows",
3417 - "description": "Lists github users that a valid github `username` is following, supporting pagination."
3447 + "description": "Lists GitHub users that a valid GitHub `username` is following, supporting pagination."
3448 },
3449 {
3450 "slug": "GITHUB_LIST_THE_PEOPLE_THE_AUTHENTICATED_USER_FOLLOWS",
@@ -3424,27 +3454,27 @@
3454 {
3455 "slug": "GITHUB_LIST_TIMELINE_EVENTS_FOR_AN_ISSUE",
3456 "name": "List timeline events for an issue",
3427 - "description": "Lists chronological events (e.g., comments, commits, label changes) for a specific issue in a github repository."
3457 + "description": "Lists chronological events (e.g., comments, commits, label changes) for a specific issue in a GitHub repository."
3458 },
3459 {
3460 "slug": "GITHUB_LIST_TOKEN_ACCESS_REPOSITORIES",
3461 "name": "List token access repositories",
3432 - "description": "Lists repositories in an organization accessible by a specific fine-grained personal access token; this action is for github apps."
3462 + "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."
3463 },
3464 {
3465 "slug": "GITHUB_LIST_USER_PROJECTS",
3466 "name": "List user projects",
3437 - "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."
3467 + "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."
3468 },
3469 {
3470 "slug": "GITHUB_LIST_USERS",
3471 "name": "List users",
3442 - "description": "Retrieves all github users (individuals and organizations) in chronological order of their sign-up date."
3472 + "description": "Retrieves all GitHub users (individuals and organizations) in chronological order of their sign-up date."
3473 },
3474 {
3475 "slug": "GITHUB_LIST_USERS_BLOCKED_BY_AN_ORGANIZATION",
3476 "name": "List users blocked by an organization",
3447 - "description": "Lists users blocked by a specified github organization."
3477 + "description": "Lists users blocked by a specified GitHub organization."
3478 },
3479 {
3480 "slug": "GITHUB_LIST_USERS_BLOCKED_BY_THE_AUTHENTICATED_USER",
@@ -3454,7 +3484,7 @@
3484 {
3485 "slug": "GITHUB_LIST_USERS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLE",
3486 "name": "List users assigned org role",
3457 - "description": "Lists users assigned to a specific role within a github organization."
3487 + "description": "Lists users assigned to a specific role within a GitHub organization."
3488 },
3489 {
3490 "slug": "GITHUB_LIST_WATCHERS",
@@ -3464,27 +3494,27 @@
3494 {
3495 "slug": "GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS",
3496 "name": "List workflow run artifacts",
3467 - "description": "Lists artifacts (e.g., build outputs, test results) for a specific workflow run in a github repository."
3497 + "description": "Lists artifacts (e.g., build outputs, test results) for a specific workflow run in a GitHub repository."
3498 },
3499 {
3500 "slug": "GITHUB_LIST_WORKFLOW_RUNS_FOR_A_REPOSITORY",
3501 "name": "List workflow runs for a repository",
3472 - "description": "Lists workflow runs for a repository, allowing filtering by actor, branch, event, status, creation date, check suite id, or head sha; the repository must exist and be accessible."
3502 + "description": "Lists workflow runs for a repository, allowing filtering by actor, branch, event, status, creation date, check suite ID, or head SHA; the repository must exist and be accessible."
3503 },
3504 {
3505 "slug": "GITHUB_LIST_WORKFLOW_RUNS_FOR_A_WORKFLOW",
3506 "name": "List workflow runs for a workflow",
3477 - "description": "Lists runs for a specified, existing workflow (identified by id or filename like `main.yml`) in a github repository, with filtering options."
3507 + "description": "Lists runs for a specified, existing workflow (identified by ID or filename like `main.yml`) in a GitHub repository, with filtering options."
3508 },
3509 {
3510 "slug": "GITHUB_LOCK_AN_ISSUE",
3511 "name": "Lock an issue",
3482 - "description": "Locks an existing github issue's conversation, preventing further comments; an optional reason can be specified."
3512 + "description": "Locks an existing GitHub issue's conversation, preventing further comments; an optional reason can be specified."
3513 },
3514 {
3515 "slug": "GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES",
3516 "name": "Manage access control for organization codespaces",
3487 - "description": "Sets the codespaces access control policy for a github organization, determining which members can use them."
3517 + "description": "Sets the Codespaces access control policy for a GitHub organization, determining which members can use them. This endpoint requires admin permissions on the organization. The API returns HTTP 204 No Content on success."
3518 },
3519 {
3520 "slug": "GITHUB_MANAGE_CUSTOM_PROPERTIES_FOR_ORG_REPOS",
@@ -3492,59 +3522,54 @@
3522 "description": "Creates or updates values for an organization's predefined custom properties across multiple repositories (up to 30)."
3523 },
3524 {
3495 - "slug": "GITHUB_MANAGE_SECRETS_IN_SELECTED_REPOSITORIES_WITH_PROPER_ACCESS",
3496 - "name": "Manage secrets in selected repositories with proper access",
3497 - "description": "Lists repositories within an organization that have been explicitly granted access to a specific organization secret."
3525 + "slug": "GITHUB_MANAGE_SECRETS_IN_SELECTED_REPOSITORIES",
3526 + "name": "List selected repositories for a GitHub Actions organization secret",
3527 + "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."
3528 },
3529 {
3530 "slug": "GITHUB_MAP_A_COMMIT_AUTHOR",
3531 "name": "Map a commit author",
3502 - "description": "Updates git author information (name and/or email) for an `author id` obtained during a repository import, to correctly attribute commits."
3532 + "description": "Updates Git author information (name and/or email) for an `author_id` obtained during a repository import, to correctly attribute commits. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports."
3533 },
3534 {
3535 "slug": "GITHUB_MARK_A_THREAD_AS_DONE",
3536 "name": "Mark a thread as done",
3507 - "description": "Marks the github notification thread (identified by `thread id`) as done or read for the authenticated user, effectively archiving it."
3537 + "description": "Marks the GitHub notification thread (identified by `thread_id`) as done or read for the authenticated user, effectively archiving it."
3538 },
3539 {
3540 "slug": "GITHUB_MARK_A_THREAD_AS_READ",
3541 "name": "Mark a thread as read",
3512 - "description": "Marks an existing github notification thread, identified by its `thread id`, as read."
3542 + "description": "Marks an existing GitHub notification thread, identified by its `thread_id`, as read."
3543 },
3544 {
3545 "slug": "GITHUB_MARK_NOTIFICATIONS_AS_READ",
3546 "name": "Mark notifications as read",
3517 - "description": "Marks notifications as read or unread, optionally for those updated at or before a `last read at` timestamp."
3547 + "description": "Marks notifications as read or unread, optionally for those updated at or before a `last_read_at` timestamp."
3548 },
3549 {
3550 "slug": "GITHUB_MARK_REPOSITORY_NOTIFICATIONS_AS_READ",
3551 "name": "Mark repository notifications as read",
3522 - "description": "Marks notifications in a repository as read; if 'last read at' is specified, notifications updated after this timestamp are not marked as read."
3552 + "description": "Marks notifications in a repository as read; if 'last_read_at' is specified, notifications updated after this timestamp are not marked as read."
3553 },
3554 {
3555 "slug": "GITHUB_MERGE_A_BRANCH",
3556 "name": "Merge a branch",
3527 - "description": "Merges a head branch or commit sha into a base branch in a repository; fails if there are merge conflicts requiring manual resolution."
3557 + "description": "Merges a head branch or commit SHA into a base branch in a repository; fails if there are merge conflicts requiring manual resolution."
3558 },
3559 {
3560 "slug": "GITHUB_MERGE_A_PULL_REQUEST",
3561 "name": "Merge a pull request",
3532 - "description": "Merges an open and mergeable pull request in a repository, optionally specifying merge commit details, a merge method, and a required head sha for safety."
3533 - },
3534 - {
3535 - "slug": "GITHUB_META_ROOT",
3536 - "name": "Get GitHub API root",
3537 - "description": "Deprecated: retrieves github rest api root endpoint details; use `github api root` instead."
3562 + "description": "Merges an open and mergeable pull request in a repository. A 405 error can occur for multiple reasons: (1) The PR is still in draft mode - convert it to ready-for-review first using GITHUB_UPDATE_A_PULL_REQUEST. (2) Branch protection rules are not satisfied - check for required approving reviews, status checks, or other repository rules that must be met before merging. (3) The base branch has been modified since the PR was last synced - update the PR branch first using GITHUB_UPDATE_A_PULL_REQUEST_BRANCH."
3563 },
3564 {
3565 "slug": "GITHUB_MOVE_A_PROJECT_CARD",
3541 - "name": "Move a project card",
3542 - "description": "Moves a project card to a specified position, optionally into a new column."
3566 + "name": "Move a project card (Classic - Deprecated)",
3567 + "description": "Moves a project card to a specified position within a column (GitHub Classic Projects). 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. It may still work on GitHub Enterprise Server instances where classic projects remain 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/ On success, the API returns HTTP 201 with an empty body, indicating the card was moved."
3568 },
3569 {
3570 "slug": "GITHUB_MOVE_A_PROJECT_COLUMN",
3546 - "name": "Move a project column",
3547 - "description": "Moves a column within a github project (classic) to a new position; `position` can be 'first', 'last', or 'after:<target column id>', where `target column id` must reference an existing column in the same project."
3571 + "name": "Move a project column (Classic - Deprecated)",
3572 + "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/"
3573 },
3574 {
3575 "slug": "GITHUB_PING_AN_ORGANIZATION_WEBHOOK",
@@ -3554,42 +3579,12 @@
3579 {
3580 "slug": "GITHUB_PING_A_REPOSITORY_WEBHOOK",
3581 "name": "Ping a repository webhook",
3557 - "description": "Pings an existing webhook on a repository to test its configuration and reachability by github."
3582 + "description": "Pings an existing webhook on a repository to test its configuration and reachability by GitHub."
3583 },
3584 {
3585 "slug": "GITHUB_PRIVATELY_REPORT_A_SECURITY_VULNERABILITY",
3586 "name": "Privately report a security vulnerability",
3562 - "description": "Privately reports a security vulnerability for a repository; specify either `severity` or `cvss vector string`, but not both."
3563 - },
3564 - {
3565 - "slug": "GITHUB_PULLS_CHECK_IF_MERGED",
3566 - "name": "Pulls check if merged",
3567 - "description": "Deprecated: use `check if a pull request has been merged` instead. checks if a github pull request has been merged, indicated by a 204 http status (merged) or 404 (not merged/found)."
3568 - },
3569 - {
3570 - "slug": "GITHUB_PULLS_CREATE",
3571 - "name": "Create a pull request",
3572 - "description": "Deprecated: use `create a pull request` instead. creates a pull request, requiring existing `base` and `head` branches."
3573 - },
3574 - {
3575 - "slug": "GITHUB_PULLS_CREATE_REVIEW",
3576 - "name": "Create a review for a pull request",
3577 - "description": "Deprecated: use `create a review for a pull request` for creating pull request reviews; supports `pending` for drafts and comment positioning."
3578 - },
3579 - {
3580 - "slug": "GITHUB_PULLS_CREATE_REVIEW_COMMENT",
3581 - "name": "Create a review comment for a pull request",
3582 - "description": "Deprecated: creates a review comment on a pull request's diff. use `create a review comment for a pull request` instead."
3583 - },
3584 - {
3585 - "slug": "GITHUB_PULLS_GET",
3586 - "name": "Get a pull request",
3587 - "description": "Deprecated: retrieves details of a specific pull request; prefer using the `get a pull request` action."
3588 - },
3589 - {
3590 - "slug": "GITHUB_PULLS_LIST",
3591 - "name": "List pull requests",
3592 - "description": "(deprecated: use `list pull requests`) lists pull requests for a specified github repository with ai-friendly filtering."
3587 + "description": "Privately reports a security vulnerability to a repository's maintainers. IMPORTANT: You cannot report vulnerabilities to repositories you own - this API is for third-party security researchers to report to other repositories. The target repository must have private vulnerability reporting enabled. Specify EITHER `severity` OR `cvss_vector_string`, but not both."
3588 },
3589 {
3590 "slug": "GITHUB_REDELIVER_A_DELIVERY_FOR_AN_ORGANIZATION_WEBHOOK",
@@ -3599,12 +3594,12 @@
3594 {
3595 "slug": "GITHUB_REDELIVER_A_DELIVERY_FOR_A_REPOSITORY_WEBHOOK",
3596 "name": "Redeliver a delivery for a repository webhook",
3602 - "description": "Redelivers a specific, previously made webhook delivery (`delivery id`) for a repository's webhook (`hook id`)."
3597 + "description": "Redelivers a specific, previously made webhook delivery (`delivery_id`) for a repository's webhook (`hook_id`)."
3598 },
3599 {
3600 "slug": "GITHUB_REMOVE_A_CUSTOM_PROPERTY_FOR_AN_ORGANIZATION",
3601 "name": "Remove a custom property for an organization",
3607 - "description": "Deletes a custom property, specified by `custom property name`, from an existing organization (`org`) for which the property is currently defined, preventing its future assignment to repositories."
3602 + "description": "Deletes a custom property, specified by `custom_property_name`, from an existing organization (`org`) for which the property is currently defined, preventing its future assignment to repositories."
3603 },
3604 {
3605 "slug": "GITHUB_REMOVE_A_LABEL_FROM_AN_ISSUE",
@@ -3614,7 +3609,7 @@
3609 {
3610 "slug": "GITHUB_REMOVE_ALL_LABELS_FROM_AN_ISSUE",
3611 "name": "Remove all labels from an issue",
3617 - "description": "Removes all labels from a specified issue in a github repository; this operation is idempotent."
3612 + "description": "Removes all labels from a specified issue in a GitHub repository; this operation is idempotent."
3613 },
3614 {
3615 "slug": "GITHUB_REMOVE_ALL_ORGANIZATION_ROLES_FOR_A_TEAM",
@@ -3624,12 +3619,12 @@
3619 {
3620 "slug": "GITHUB_REMOVE_ALL_ORGANIZATION_ROLES_FOR_A_USER",
3621 "name": "Remove all organization roles for a user",
3627 - "description": "Revokes all assigned organization-level roles from a specified user (who must be a member of the organization) within a github organization, without removing the user from the organization or affecting repository-specific roles."
3622 + "description": "Revokes all assigned organization-level roles from a specified user (who must be a member of the organization) within a GitHub organization, without removing the user from the organization or affecting repository-specific roles."
3623 },
3624 {
3625 "slug": "GITHUB_REMOVE_AN_ORGANIZATION_MEMBER",
3626 "name": "Remove an organization member",
3632 - "description": "Removes a user, who must currently be a member, from a github organization, revoking their membership and access rights."
3627 + "description": "Removes a member from a GitHub organization. This action permanently removes a user's membership from the specified organization, revoking their access to all organization resources, repositories, and teams. Requirements: - The authenticated user must be an organization owner - The target user must currently be a member of the organization Note: This action cannot be used to remove the last owner of an organization."
3628 },
3629 {
3630 "slug": "GITHUB_REMOVE_AN_ORGANIZATION_ROLE_FROM_A_TEAM",
@@ -3639,12 +3634,12 @@
3634 {
3635 "slug": "GITHUB_REMOVE_AN_ORGANIZATION_ROLE_FROM_A_USER",
3636 "name": "Remove an organization role from a user",
3642 - "description": "Removes a custom organization role from a user within a github organization, provided the organization exists, the user is a member, and the role id corresponds to a valid custom role in that organization."
3637 + "description": "Removes a custom organization role from a user within a GitHub organization, provided the organization exists, the user is a member, and the role_id corresponds to a valid custom role in that organization."
3638 },
3639 {
3640 "slug": "GITHUB_REMOVE_APP_ACCESS_RESTRICTIONS",
3641 "name": "Remove app access restrictions",
3647 - "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."
3642 + "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."
3643 },
3644 {
3645 "slug": "GITHUB_REMOVE_A_PROJECT_FROM_A_TEAM",
@@ -3654,12 +3649,12 @@
3649 {
3650 "slug": "GITHUB_REMOVE_A_REPOSITORY_COLLABORATOR",
3651 "name": "Remove a repository collaborator",
3657 - "description": "Removes a collaborator from a specified github repository, provided the repository exists and the user is an existing collaborator."
3652 + "description": "Removes a collaborator from a specified GitHub repository, provided the repository exists and the user is an existing collaborator."
3653 },
3654 {
3655 "slug": "GITHUB_REMOVE_A_REPOSITORY_FROM_AN_APP_INSTALLATION",
3656 "name": "Remove a repository from an app installation",
3662 - "description": "Removes a repository from a github app installation for the authenticated user, given a valid `installation id` and the `repository id` of a repository currently linked to that installation; this operation is idempotent."
3657 + "description": "Removes a repository from a GitHub App installation for the authenticated user, given a valid `installation_id` and the `repository_id` of a repository currently linked to that installation; this operation is idempotent."
3658 },
3659 {
3660 "slug": "GITHUB_REMOVE_A_REPOSITORY_FROM_A_TEAM",
@@ -3669,12 +3664,12 @@
3664 {
3665 "slug": "GITHUB_REMOVE_A_SELECTED_REPOSITORY_FROM_A_USER_SECRET",
3666 "name": "Remove a selected repository from a user secret",
3672 - "description": "Removes a selected repository's access to a user's codespaces secret; the secret must exist and the repository must have previously been granted access."
3667 + "description": "Removes a selected repository's access to a user's Codespaces secret; the secret must exist and the repository must have previously been granted access."
3668 },
3669 {
3670 "slug": "GITHUB_REMOVE_ASSIGNEES_FROM_AN_ISSUE",
3671 "name": "Remove assignees from an issue",
3677 - "description": "Removes specified assignees from a github issue; requires push access, and invalid removal attempts are silently ignored."
3672 + "description": "Removes specified assignees from a GitHub issue; requires push access, and invalid removal attempts are silently ignored."
3673 },
3674 {
3675 "slug": "GITHUB_REMOVE_CUSTOM_LABEL_FROM_REPO_RUNNER",
@@ -3684,7 +3679,7 @@
3679 {
3680 "slug": "GITHUB_REMOVE_CUSTOM_LABEL_FROM_SELF_HOSTED_RUNNER",
3681 "name": "Remove custom label from self hosted runner",
3687 - "description": "Removes a currently assigned custom label (`name`) from a self-hosted runner (`runner id`) in an organization (`org`)."
3682 + "description": "Removes a currently assigned custom label (`name`) from a self-hosted runner (`runner_id`) in an organization (`org`). This action allows the organization to manage the labels associated with their runners effectively."
3683 },
3684 {
3685 "slug": "GITHUB_REMOVE_CUSTOM_LABELS_FROM_SELF_HOSTED_REPOSITORY_RUNNER",
@@ -3694,7 +3689,7 @@
3689 {
3690 "slug": "GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATION",
3691 "name": "Remove interaction restrictions for an organization",
3697 - "description": "Removes all interaction restrictions from public repositories in the specified github organization, allowing all users to resume interactions."
3692 + "description": "Removes all interaction restrictions from public repositories in the specified GitHub organization, allowing all users to resume interactions."
3693 },
3694 {
3695 "slug": "GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORY",
@@ -3704,42 +3699,42 @@
3699 {
3700 "slug": "GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FROM_YOUR_PUBLIC_REPOSITORIES",
3701 "name": "Remove user public repo interaction restrictions",
3707 - "description": "Removes all interaction restrictions (limitations on comments, issues, or pull requests) from all public repositories owned by the authenticated user."
3702 + "description": "DEPRECATED: Use `GITHUB_REMOVE_PUBLIC_REPO_INTERACTION_RESTRICTIONS` instead."
3703 },
3704 {
3705 "slug": "GITHUB_REMOVE_ORG_DEV_ENV_SECRET_BY_NAME",
3706 "name": "Remove org dev env secret by name",
3712 - "description": "Deletes a github codespaces secret from an organization by its name; this operation is idempotent."
3707 + "description": "Deletes a GitHub Codespaces secret from an organization by its name; this operation is idempotent."
3708 },
3709 {
3710 "slug": "GITHUB_REMOVE_ORG_SECRET_BY_NAME",
3711 "name": "Remove org secret by name",
3717 - "description": "Permanently removes a specific dependabot secret, by its `secret name`, from the github `org`, making it unavailable to dependabot for that organization."
3712 + "description": "Permanently removes a specific Dependabot secret, by its `secret_name`, from the GitHub `org`, making it unavailable to Dependabot for that organization."
3713 },
3714 {
3715 "slug": "GITHUB_REMOVE_OUTSIDE_COLLABORATOR_FROM_AN_ORGANIZATION",
3716 "name": "Remove outside collaborator from an organization",
3722 - "description": "Removes a user, who must be an outside collaborator, from the specified github organization, revoking their access to all its repositories."
3717 + "description": "Removes a user, who must be an outside collaborator, from the specified GitHub organization, revoking their access to all its repositories."
3718 },
3719 {
3720 "slug": "GITHUB_REMOVE_PUBLIC_ORG_MEMBERSHIP",
3721 "name": "Remove public org membership",
3727 - "description": "Makes an authenticated user's public membership in an organization private (without removing them from the organization); the user must currently be a public member of that organization."
3722 + "description": "Removes the authenticated user's public organization membership, making it private. The user remains a member of the organization but their membership is no longer publicly visible. This operation is idempotent - calling it when the membership is already private will succeed."
3723 },
3724 {
3725 "slug": "GITHUB_REMOVE_REPO_FROM_ORG_DEV_ENV_SECRET",
3731 - "name": "Removerepofromorgdevenvsecret",
3732 - "description": "Removes a repository's access to an organization-level codespaces secret, if it was previously granted."
3726 + "name": "Remove repository from organization dev environment secret",
3727 + "description": "Removes a repository's access to an organization-level Codespaces secret, if it was previously granted."
3728 },
3729 {
3730 "slug": "GITHUB_REMOVE_REPO_FROM_ORG_SECRET_WITH_SELECTED_VISIBILITY",
3731 "name": "Remove selected repo from org secret",
3737 - "description": "Revokes a specific repository's access to an organization-level dependabot secret, applicable only when the secret has 'selected' visibility and the specified repository currently has access."
3732 + "description": "Revokes a specific repository's access to an organization-level Dependabot secret, applicable only when the secret has 'selected' visibility and the specified repository currently has access."
3733 },
3734 {
3735 "slug": "GITHUB_REMOVE_REQUESTED_REVIEWERS_FROM_A_PULL_REQUEST",
3736 "name": "Remove requested reviewers from a pull request",
3742 - "description": "Removes currently assigned user logins and/or team slugs from a github pull request's list of requested reviewers."
3737 + "description": "Removes currently assigned user logins and/or team slugs from a GitHub pull request's list of requested reviewers."
3738 },
3739 {
3740 "slug": "GITHUB_REMOVE_SELECTED_REPOSITORY_FROM_AN_ORGANIZATION_SECRET",
@@ -3749,12 +3744,12 @@
3744 {
3745 "slug": "GITHUB_REMOVE_SELECTED_REPOSITORY_FROM_AN_ORGANIZATION_VARIABLE",
3746 "name": "Remove selected repository from an organization variable",
3752 - "description": "Removes a repository's access to an organization variable, if the variable's visibility is 'selected' and the repository is in its access list."
3747 + "description": "Removes a repository's access to an organization variable that has 'selected' visibility. This endpoint removes a specific repository from an organization variable's access list. The variable must have its visibility set to 'selected' for this operation to work. Returns a 409 Conflict error if the variable visibility is not 'selected'."
3748 },
3749 {
3750 "slug": "GITHUB_REMOVE_STATUS_CHECK_CONTEXTS",
3751 "name": "Remove status check contexts",
3757 - "description": "Removes specified status check contexts (passed in the request body as an array of strings) from a protected branch in a repository."
3752 + "description": "Removes specified status check contexts from a protected branch's required status checks. This action removes the specified status check contexts from the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead."
3753 },
3754 {
3755 "slug": "GITHUB_REMOVE_STATUS_CHECK_PROTECTION",
@@ -3764,37 +3759,37 @@
3759 {
3760 "slug": "GITHUB_REMOVE_TEAM_ACCESS_RESTRICTIONS",
3761 "name": "Remove team access restrictions",
3767 - "description": "Removes all team-based access restrictions from a specified protected branch; the branch must be protected and have existing team restrictions for this action to change settings."
3762 + "description": "Removes specified teams from push access to a protected branch. This action removes teams from the list of teams with push access to a protected branch. Removing a team will also remove push access for any child teams. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must currently have push access to the branch"
3763 },
3764 {
3765 "slug": "GITHUB_REMOVE_TEAM_MEMBERSHIP_FOR_A_USER",
3766 "name": "Remove team membership for a user",
3772 - "description": "Removes a user from a specific team within an organization; this action fails if team synchronization with an identity provider (idp) is enabled, and may delete the team if the user is its last member and the team is not nested."
3767 + "description": "Removes a user from a specific team within an organization. This action requires admin:org scope permissions. It will fail if: - Team synchronization with an Identity Provider (IdP) is enabled (403 Forbidden) - The organization, team, or user membership doesn't exist (404 Not Found) - You don't have sufficient permissions to manage team memberships (403 Forbidden) Note: If the removed user was the last member and the team is not nested, the team may be deleted automatically."
3768 },
3769 {
3770 "slug": "GITHUB_REMOVE_USER_ACCESS_RESTRICTIONS",
3771 "name": "Remove user access restrictions",
3777 - "description": "Removes active user-level access restrictions from a specified protected branch, enabling users with repository write access to push or merge if no other team or app restrictions apply."
3772 + "description": "Removes specified users from the list of people allowed to push to a protected branch. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must have protection rules with push restrictions enabled - Users being removed must currently have push access to the branch - The combined total of users, apps, and teams is limited to 100 items"
3773 },
3774 {
3775 "slug": "GITHUB_REMOVE_USER_AS_A_COLLABORATOR",
3781 - "name": "Remove user as a collaborator",
3782 - "description": "Removes a user as a collaborator from an organization project; the user must already be a collaborator on the specified project."
3776 + "name": "Remove user as a collaborator (classic project)",
3777 + "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."
3778 },
3779 {
3780 "slug": "GITHUB_REMOVE_USERS_FROM_CODESPACES_ACCESS_FOR_AN_ORGANIZATION",
3781 "name": "Remove users from codespaces access for an organization",
3787 - "description": "Removes selected users from github codespaces billing access for an existing organization."
3782 + "description": "Removes selected users from GitHub Codespaces billing access for an existing organization."
3783 },
3784 {
3785 "slug": "GITHUB_RENAME_A_BRANCH",
3786 "name": "Rename a branch",
3792 - "description": "Renames an existing branch in a github repository; the new name must be unique and adhere to github's naming conventions, and the current branch name cannot contain wildcard characters."
3787 + "description": "Renames an existing branch in a GitHub repository; the new name must be unique and adhere to GitHub's naming conventions, and the current branch name cannot contain wildcard characters."
3788 },
3789 {
3790 "slug": "GITHUB_RENDER_A_MARKDOWN_DOCUMENT",
3791 "name": "Render a markdown document",
3797 - "description": "Renders markdown to html; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions."
3792 + "description": "Renders Markdown to HTML; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions."
3793 },
3794 {
3795 "slug": "GITHUB_REPLACE_ALL_REPOSITORY_TOPICS",
@@ -3804,117 +3799,42 @@
3799 {
3800 "slug": "GITHUB_REPLACE_ORG_SECRET_VISIBILITY_TO_SELECTED",
3801 "name": "Replace org secret visibility to selected",
3807 - "description": "Sets an existing dependabot organization secret's visibility to 'selected' and replaces the full list of repositories that can access it with the ids provided."
3802 + "description": "Replaces the list of repositories that can access a Dependabot organization secret when the secret's visibility is already set to 'selected'."
3803 },
3804 {
3805 "slug": "GITHUB_REPLACE_REPO_ACCESS_ON_ORG_DEV_ENV_SECRET_SET",
3806 "name": "Replace repository access for an org Codespaces secret",
3812 - "description": "Replaces the list of repositories that can access an existing organization-level codespaces secret with the provided valid repository ids owned by the organization."
3813 - },
3814 - {
3815 - "slug": "GITHUB_REPO_S_CREATE_FOR_AUTHENTICATED_USER",
3816 - "name": "Create a repository for the authenticated user",
3817 - "description": "Deprecated: use 'create a repository for the authenticated user' instead. creates a new repository for the authenticated user."
3818 - },
3819 - {
3820 - "slug": "GITHUB_REPO_S_CREATE_FORK",
3821 - "name": "Create a fork",
3822 - "description": "(deprecated: use `create a fork` instead) creates a fork of a specified repository."
3823 - },
3824 - {
3825 - "slug": "GITHUB_REPO_S_CREATE_IN_ORG",
3826 - "name": "Create an organization repository",
3827 - "description": "Deprecated: use `create an organization repository` instead. creates a new repository in the specified organization."
3828 - },
3829 - {
3830 - "slug": "GITHUB_REPO_S_CREATE_OR_UPDATE_FILE_CONTENTS",
3831 - "name": "Create or update file contents",
3832 - "description": "Deprecated: use `create or update file contents` instead; creates or replaces a file in a repository."
3833 - },
3834 - {
3835 - "slug": "GITHUB_REPO_S_GET_CODE_FREQUENCY_STATS",
3836 - "name": "Get the weekly commit activity",
3837 - "description": "Deprecated: use `get the weekly commit activity` instead. fetches weekly commit statistics (additions/deletions) for a repository; less reliable for over 10,000 commits."
3838 - },
3839 - {
3840 - "slug": "GITHUB_REPO_S_GET_COMMIT",
3841 - "name": "Get a commit",
3842 - "description": "Deprecated: use `get a commit`. retrieves a specific commit from a repository by its owner, name, and a valid commit reference (sha, branch, or tag), supporting pagination for large diffs."
3843 - },
3844 - {
3845 - "slug": "GITHUB_REPO_S_GET_CONTENT",
3846 - "name": "Get repository content",
3847 - "description": "Deprecated: gets repository file content or directory metadata; use `get repository content` instead."
3848 - },
3849 - {
3850 - "slug": "GITHUB_REPO_S_GET_CONTRIBUTORS_STATS",
3851 - "name": "Get all contributor commit activity",
3852 - "description": "(deprecated: use `getallcontributorcommitactivity`) fetches commit activity (total commits, weekly additions/deletions/commits) for all repository contributors; retry if github returns 202."
3853 - },
3854 - {
3855 - "slug": "GITHUB_REPO_S_LIST_BRANCHES",
3856 - "name": "List branches",
3857 - "description": "(deprecated: use 'list branches' instead) lists branches for an existing github repository, with an option to filter by protection status."
3858 - },
3859 - {
3860 - "slug": "GITHUB_REPO_S_LIST_COLLABORATORS",
3861 - "name": "List repository collaborators (deprecated)",
3862 - "description": "(deprecated: use `listrepositorycollaborators`) lists repository collaborators, especially for organization-owned repositories including team members from child teams; requires repository access and potentially `read:org`/`repo` scopes for organization repos."
3863 - },
3864 - {
3865 - "slug": "GITHUB_REPO_S_LIST_COMMITS",
3866 - "name": "List commits",
3867 - "description": "Deprecated: use `list commits` instead; lists repository commits, including gpg/s/mime signature verification details if available."
3868 - },
3869 - {
3870 - "slug": "GITHUB_REPO_S_LIST_CONTRIBUTORS",
3871 - "name": "List repository contributors",
3872 - "description": "Deprecated: use `list repository contributors`. lists repository contributors, sorted by contributions; repository must exist and be accessible."
3873 - },
3874 - {
3875 - "slug": "GITHUB_REPO_S_LIST_FOR_AUTHENTICATED_USER",
3876 - "name": "List repositories for the authenticated user",
3877 - "description": "Deprecated: use `list repositories for the authenticated user` to list the authenticated user's repositories."
3878 - },
3879 - {
3880 - "slug": "GITHUB_REPO_S_LIST_FOR_ORG",
3881 - "name": "List organization repositories",
3882 - "description": "Deprecated: lists repositories for a github organization; use `list organization repositories` instead."
3883 - },
3884 - {
3885 - "slug": "GITHUB_REPO_S_LIST_FOR_USER",
3886 - "name": "List repositories for a user",
3887 - "description": "Deprecated: lists public repositories for the specified github user; use `list repositories for a user` instead."
3807 + "description": "Replaces the list of repositories that can access an organization-level Codespaces secret. This operation completely replaces the existing list of repositories with the provided list. The secret must already have its visibility set to 'selected' for this operation to succeed. Use this when you want to set an exact list of repositories that should have access. Prerequisites: - The organization must exist and you must have admin:org scope - The Codespaces secret must already exist in the organization - The secret's visibility must be set to 'selected' (not 'all' or 'private') Returns HTTP 204 No Content on success, 404 if secret/org not found, 409 if visibility is not 'selected'."
3808 },
3809 {
3810 "slug": "GITHUB_REQUEST_A_GITHUB_PAGES_BUILD",
3811 "name": "Request a github pages build",
3892 - "description": "Manually triggers a github pages build for a repository if github pages is enabled, useful for deployments not automatically built or for retrying failed builds."
3812 + "description": "Manually triggers a GitHub Pages build for a repository if GitHub Pages is enabled, useful for deployments not automatically built or for retrying failed builds."
3813 },
3814 {
3815 "slug": "GITHUB_REQUEST_REVIEWERS_FOR_A_PULL_REQUEST",
3896 - "name": "Request reviewers for a pull request",
3897 - "description": "Requests user and/or team reviewers for an open pull request in a repository; requires `owner`, `repo`, `pull number`, and at least one of `reviewers` or `team reviewers`."
3816 + "name": "Add reviewers to a specific pull request",
3817 + "description": "Adds reviewers to a specific pull request identified by owner, repo, and pull_number. This is NOT a search action - it operates on an already-known PR number. Requires `owner`, `repo`, `pull_number`, and at least one of `reviewers` or `team_reviewers`."
3818 },
3819 {
3820 "slug": "GITHUB_REREQUEST_A_CHECK_RUN",
3821 "name": "Rerequest a check run",
3902 - "description": "Triggers a re-run of a specific check run in a github repository, which resets its status to 'queued', clears its conclusion, and triggers the `check run` webhook with `rerequested`."
3822 + "description": "Triggers a re-run of a specific check run in a GitHub repository, resetting its status to 'queued', clearing its conclusion, and triggering the `check_run` webhook with `rerequested` action. IMPORTANT: This endpoint requires GitHub App authentication with 'checks:write' permission. The check run can ONLY be re-requested by the same GitHub App that originally created it. OAuth tokens and personal access tokens (PAT) cannot use this endpoint."
3823 },
3824 {
3825 "slug": "GITHUB_REREQUEST_A_CHECK_SUITE",
3826 "name": "Rerequest a check suite",
3907 - "description": "Triggers a new run of an existing check suite within a repository, useful for re-running checks without new code."
3827 + "description": "Triggers a new run of an existing check suite within a repository, resetting its status to 'queued', clearing its conclusion, and triggering the `check_suite` webhook with `rerequested` action. IMPORTANT: This endpoint requires GitHub App authentication with 'checks:write' permission. OAuth tokens and classic personal access tokens (PAT) cannot use this endpoint. Only GitHub App user access tokens, GitHub App installation access tokens, or fine-grained personal access tokens with checks:write permission are supported."
3828 },
3829 {
3830 "slug": "GITHUB_RE_RUN_A_JOB_FROM_A_WORKFLOW_RUN",
3831 "name": "Re-run a job from a workflow run",
3912 - "description": "Re-runs a specific job and any dependent jobs from a github actions workflow run in the specified repository, optionally enabling debug logging."
3832 + "description": "Re-runs a specific job and any dependent jobs from a GitHub Actions workflow run in the specified repository, optionally enabling debug logging."
3833 },
3834 {
3835 "slug": "GITHUB_RE_RUN_A_WORKFLOW",
3836 "name": "Rerun a workflow",
3917 - "description": "Re-runs a specific github actions workflow run identified by its owner, repository, and run id, optionally enabling debug logging."
3837 + "description": "Re-runs a specific GitHub Actions workflow run identified by its owner, repository, and run ID, optionally enabling debug logging."
3838 },
3839 {
3840 "slug": "GITHUB_RE_RUN_FAILED_JOBS_FROM_A_WORKFLOW_RUN",
@@ -3924,7 +3844,7 @@
3844 {
3845 "slug": "GITHUB_RESET_A_TOKEN",
3846 "name": "Reset a token",
3927 - "description": "Invalidates the provided oauth `access token` and generates a new one for the github oauth app identified by `client id`, used for token compromise or security rotation."
3847 + "description": "Invalidates the provided OAuth `access_token` and generates a new one for the GitHub OAuth App identified by `client_id`. Used for token rotation when a token may be compromised or for regular security maintenance. Note: This endpoint requires the OAuth App owner's credentials (client_id/client_secret for Basic Auth)."
3848 },
3849 {
3850 "slug": "GITHUB_RESTORE_A_PACKAGE_FOR_AN_ORGANIZATION",
@@ -3934,7 +3854,7 @@
3854 {
3855 "slug": "GITHUB_RESTORE_A_PACKAGE_FOR_A_USER",
3856 "name": "Restore a package for a user",
3937 - "description": "Restores a user-owned package previously deleted from github packages, if restorable under github's data retention policy (typically within 30 days of deletion)."
3857 + "description": "Restores a user-owned package previously deleted from GitHub Packages, if restorable under GitHub's data retention policy (typically within 30 days of deletion)."
3858 },
3859 {
3860 "slug": "GITHUB_RESTORE_A_PACKAGE_FOR_THE_AUTHENTICATED_USER",
@@ -3959,17 +3879,17 @@
3879 {
3880 "slug": "GITHUB_RETRIEVE_REPO_PUBLIC_KEY_FOR_ENCRYPTION",
3881 "name": "Retrieve repo public key for encryption",
3962 - "description": "Gets a repository's public key, used to encrypt secrets for dependabot."
3882 + "description": "Gets a repository's public key, used to encrypt secrets for Dependabot."
3883 },
3884 {
3885 "slug": "GITHUB_REVIEW_ACCESS_WITH_PERSONAL_TOKEN",
3886 "name": "Review access with personal token",
3967 - "description": "Approves or denies a pending fine-grained personal access token request for organization resources; must be performed by a github app."
3887 + "description": "Approves or denies a pending fine-grained personal access token request for organization resources; must be performed by a GitHub App."
3888 },
3889 {
3890 "slug": "GITHUB_REVIEW_DEPLOYMENT_PROTECTION_RULES",
3891 "name": "Review Custom Deployment Rules For Workflow Run",
3972 - "description": "Approves or rejects pending custom deployment protection rules for a workflow run by posting a review with `environment name` (str), `state` (str: 'approved'/'rejected'), and optional `comment` (str) in the request body, targeting a run with rules awaiting review."
3892 + "description": "Approves or rejects pending custom deployment protection rules for a workflow run. This endpoint allows GitHub Apps to review their own pending custom deployment protection rules for a specific workflow run. The review can either approve (allowing the deployment to proceed) or reject (blocking the deployment). **Important notes:** - GitHub Apps can only review their own custom deployment protection rules - This endpoint requires GitHub App installation access tokens with Deployments permission (write) - Custom deployment protection rules are available in public repos for all plans; for private/internal repos, GitHub Enterprise is required - Returns 204 No Content on success"
3893 },
3894 {
3895 "slug": "GITHUB_REVIEW_PENDING_DEPLOYMENTS_FOR_A_WORKFLOW_RUN",
@@ -3978,58 +3898,63 @@
3898 },
3899 {
3900 "slug": "GITHUB_REVIEW_RESOURCE_REQUESTS_WITH_FINE_GRAINED_TOKENS",
3981 - "name": "Review resource requests with fine grained tokens",
3982 - "description": "Approves or denies fine-grained personal access token requests for an organization; any specified `pat request ids` must refer to currently pending requests."
3901 + "name": "Review PAT Requests in Bulk",
3902 + "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."
3903 },
3904 {
3905 "slug": "GITHUB_REVOKE_AN_INSTALLATION_ACCESS_TOKEN",
3906 "name": "Revoke an installation access token",
3987 - "description": "Revokes the github app's current installation access token, immediately invalidating it for api authentication."
3907 + "description": "Revokes the GitHub App's current installation access token, immediately invalidating it for API authentication. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. After successful revocation, the token becomes permanently invalid and cannot be used for any subsequent API calls. To continue API operations, a new installation access token must be generated."
3908 + },
3909 + {
3910 + "slug": "GITHUB_RUN_GRAPH_QL_QUERY",
3911 + "name": "Run GraphQL Query",
3912 + "description": "Tool to run an arbitrary GitHub GraphQL v4 query. Use when you need to fetch multiple datasets in one batch."
3913 },
3914 {
3915 "slug": "GITHUB_SEARCH_CODE",
3916 "name": "Search code",
3992 - "description": "Searches code file contents and paths on the default branch of github repositories using a query string; searches only files under 384kb, returns max 1000 results by best match, and is optimized for precision."
3917 + "description": "Searches code file contents and paths on the default branch of GitHub repositories using a query string; searches only files under 384KB, returns max 1000 results by best match, and is optimized for precision."
3918 + },
3919 + {
3920 + "slug": "GITHUB_SEARCH_CODE_ALL_PAGES",
3921 + "name": "Search code (all pages)",
3922 + "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."
3923 },
3924 {
3925 "slug": "GITHUB_SEARCH_COMMITS",
3926 "name": "Search commits",
3997 - "description": "Finds commits on github using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination."
3927 + "description": "Finds commits on GitHub using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination."
3928 + },
3929 + {
3930 + "slug": "GITHUB_SEARCH_COMMITS_BY_AUTHOR",
3931 + "name": "Search commits by author across repos",
3932 + "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."
3933 },
3934 {
3935 "slug": "GITHUB_SEARCH_ISSUES_AND_PULL_REQUESTS",
3936 "name": "Search issues and pull requests",
4002 - "description": "Searches github for issues and pull requests. use qualifiers to scope searches: `repo:owner/name` for specific repos, `org:orgname` for organizations, `user:username` for personal repos, `assignee:@me` for your assignments. combine with `is:issue`, `is:pr`, `state:open`, `label:\"name\"` filters."
3937 + "description": "Searches GitHub for issues and pull requests. Use qualifiers to scope searches: `repo:owner/name` for specific repos, `org:orgname` for organizations, `user:username` for personal repos, `assignee:@me` for your assignments (automatically resolved to your username), `mentions:@me` for mentions. Combine with `is:issue`, `is:pr`, `state:open`, `label:\"name\"` filters."
3938 },
3939 {
3940 "slug": "GITHUB_SEARCH_LABELS",
3941 "name": "Search labels",
4007 - "description": "Searches for labels within a github repository by keywords in their names or descriptions."
4008 - },
4009 - {
4010 - "slug": "GITHUB_SEARCH_REPO_S",
4011 - "name": "Search repositories",
4012 - "description": "Deprecated: use `search repositories`; this version finds repositories by criteria, including text match metadata and pagination. example: `q=\"tetris language:assembly\", sort=\"stars\"`"
3942 + "description": "Searches for labels within a GitHub repository by keywords in their names or descriptions."
3943 },
3944 {
3945 "slug": "GITHUB_SEARCH_REPOSITORIES",
3946 "name": "Search repositories",
4017 - "description": "Searches github repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination."
3947 + "description": "Searches GitHub repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination. IMPORTANT: The 'q' parameter (search query) is REQUIRED and must always be provided."
3948 },
3949 {
3950 "slug": "GITHUB_SEARCH_TOPICS",
3951 "name": "Search topics",
4022 - "description": "Finds topics on github using keywords and qualifiers with github's search syntax, supporting pagination."
3952 + "description": "Finds topics on GitHub using keywords and qualifiers with GitHub's search syntax, supporting pagination."
3953 },
3954 {
3955 "slug": "GITHUB_SEARCH_USERS",
3956 "name": "Search users",
4027 - "description": "Searches for users on github by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`."
4028 - },
4029 - {
4030 - "slug": "GITHUB_SECURITY_ADVISORIES_LIST_GLOBAL_ADVISORIES",
4031 - "name": "List global security advisories",
4032 - "description": " tags = [\"openworldhint\", \"readonlyhint\", \"mcpignore\"] the text describes how to find global security advisories with specific parameters. by default, it excludes malware advisories, which can be included by setting the `type` parameter to `malware`. more on advisory types at github docs.<<DEPRECATED use list_global_security_advisories>>"
3957 + "description": "Searches for users on GitHub by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`."
3958 },
3959 {
3960 "slug": "GITHUB_SET_ADMIN_BRANCH_PROTECTION",
@@ -4039,7 +3964,7 @@
3964 {
3965 "slug": "GITHUB_SET_APP_ACCESS_RESTRICTIONS",
3966 "name": "Set app access restrictions",
4042 - "description": "Replaces the list of github apps permitted to push to a protected branch; the branch must already be protected and apps must be installed with 'contents' permission."
3967 + "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"
3968 },
3969 {
3970 "slug": "GITHUB_SET_A_REPOSITORY_SUBSCRIPTION",
@@ -4049,37 +3974,37 @@
3974 {
3975 "slug": "GITHUB_SET_A_THREAD_SUBSCRIPTION",
3976 "name": "Set a thread subscription",
4052 - "description": "Sets whether a github notification thread is ignored (muted) or unignored (unmuted), for a `thread id` that must identify an existing notification thread."
3977 + "description": "Sets whether a GitHub notification thread is ignored (muted) or unignored (unmuted), for a `thread_id` that must identify an existing notification thread."
3978 },
3979 {
3980 "slug": "GITHUB_SET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_AN_ORGANIZATION",
3981 "name": "Set default workflow permissions for an organization",
4057 - "description": "Updates an organization's default github token permissions for workflows and whether github actions can approve pull requests; note that allowing actions to approve pull requests (`can approve pull request reviews: true`) is a security risk."
3982 + "description": "Updates an organization's default GITHUB_TOKEN permissions for workflows and whether GitHub Actions can approve pull requests; note that allowing Actions to approve pull requests (`can_approve_pull_request_reviews: true`) is a security risk."
3983 },
3984 {
3985 "slug": "GITHUB_SET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_A_REPOSITORY",
3986 "name": "Set default workflow permissions for a repository",
4062 - "description": "Sets the default permissions for the github token within a repository and configures whether github actions can approve pull requests."
3987 + "description": "Sets the default permissions for the GITHUB_TOKEN within a repository and configures whether GitHub Actions can approve pull requests."
3988 },
3989 {
3990 "slug": "GITHUB_SET_GITHUB_ACTIONS_PERMISSIONS_FOR_AN_ORGANIZATION",
3991 "name": "Set GitHub Actions permissions for an organization",
4067 - "description": "Sets the github actions permissions policy for an organization, specifying which repositories can run actions and which actions/workflows are allowed; if 'selected' is chosen for either, manage the specific lists via other endpoints."
3992 + "description": "Sets the GitHub Actions permissions policy for an organization, specifying which repositories can run Actions and which actions/workflows are allowed; if 'selected' is chosen for either, manage the specific lists via other endpoints."
3993 },
3994 {
3995 "slug": "GITHUB_SET_GITHUB_ACTIONS_PERMISSIONS_FOR_A_REPOSITORY",
3996 "name": "Set github actions permissions for a repository",
4072 - "description": "Sets github actions permissions for a repository, enabling/disabling actions and defining the policy for allowed actions and reusable workflows."
3997 + "description": "Sets GitHub Actions permissions for a repository, enabling/disabling Actions and defining the policy for allowed actions and reusable workflows."
3998 },
3999 {
4000 "slug": "GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATION",
4001 "name": "Set interaction restrictions for an organization",
4077 - "description": "Limits interactions (comments, new issues, prs) in an organization's public repositories by user type and duration, typically to mitigate high traffic or unwanted activity."
4002 + "description": "Limits interactions (comments, new issues, PRs) in an organization's public repositories by user type and duration, typically to mitigate high traffic or unwanted activity."
4003 },
4004 {
4005 "slug": "GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORY",
4006 "name": "Set interaction restrictions for a repository",
4082 - "description": "Temporarily limits which github users (e.g., existing users, contributors only) can interact (comment, open issues, create pull requests) in a repository for a specified duration."
4007 + "description": "Temporarily limits which GitHub users (e.g., existing_users, contributors_only) can interact (comment, open issues, create pull requests) in a repository for a specified duration."
4008 },
4009 {
4010 "slug": "GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_YOUR_PUBLIC_REPOSITORIES",
@@ -4089,12 +4014,12 @@
4014 {
4015 "slug": "GITHUB_SET_LABELS_FOR_AN_ISSUE",
4016 "name": "Set labels for an issue",
4092 - "description": "Replaces all existing labels on a github issue with a new set of labels."
4017 + "description": "Replaces all existing labels on a GitHub issue with a new set of labels."
4018 },
4019 {
4020 "slug": "GITHUB_SET_ORG_ALLOWED_ACTIONS",
4021 "name": "Set allowed actions and workflows for an organization",
4097 - "description": "Sets the github actions permissions for an existing organization, specifying allowed github-owned actions, verified creator actions, and action/workflow patterns from public repositories."
4022 + "description": "Sets the GitHub Actions permissions for an existing organization, specifying allowed GitHub-owned actions, verified creator actions, and action/workflow patterns from public repositories."
4023 },
4024 {
4025 "slug": "GITHUB_SET_ORG_RUNNER_LABELS",
@@ -4104,17 +4029,22 @@
4029 {
4030 "slug": "GITHUB_SET_PRIMARY_EMAIL_VISIBILITY_FOR_THE_AUTHENTICATED_USER",
4031 "name": "Set primary email visibility",
4107 - "description": "Sets the visibility ('public' or 'private') of the authenticated user's primary email address on github, if one is configured."
4032 + "description": "Sets the visibility ('public' or 'private') of the authenticated user's primary email address on GitHub, if one is configured."
4033 },
4034 {
4035 "slug": "GITHUB_SET_REPO_ALLOWED_ACTIONS",
4036 "name": "Set repo allowed actions",
4112 - "description": "Sets allowed github actions and reusable workflows for a repository, managing permissions for github-owned, verified creator, or specific pattern-matched actions/workflows (note: `patterns allowed` applies only to public repositories)."
4037 + "description": "Sets allowed GitHub Actions and reusable workflows for a repository, managing permissions for GitHub-owned, verified creator, or specific pattern-matched actions/workflows (note: `patterns_allowed` applies only to public repositories)."
4038 + },
4039 + {
4040 + "slug": "GITHUB_SET_REPO_RUNNER_LABELS",
4041 + "name": "Set custom labels for repo runner",
4042 + "description": "Replaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels."
4043 },
4044 {
4045 "slug": "GITHUB_SET_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRET",
4046 "name": "Set selected repositories for an organization secret",
4117 - "description": "Replaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'."
4047 + "description": "Replaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'. Prerequisites: - The organization secret must already exist - The secret's visibility must be set to 'selected' (not 'all' or 'private') - Requires admin:org scope or actions secrets fine-grained permission This action completely replaces the repository access list. To add or remove individual repositories without affecting others, use the dedicated add/remove repository actions instead."
4048 },
4049 {
4050 "slug": "GITHUB_SET_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_VARIABLE",
@@ -4124,7 +4054,7 @@
4054 {
4055 "slug": "GITHUB_SET_SELECTED_REPOSITORIES_FOR_A_USER_SECRET",
4056 "name": "Set selected repositories for a user secret",
4127 - "description": "Defines the list of repositories permitted to access a specific codespaces secret for the authenticated user."
4057 + "description": "Defines the list of repositories permitted to access a specific Codespaces secret for the authenticated user."
4058 },
4059 {
4060 "slug": "GITHUB_SET_STATUS_CHECK_CONTEXTS",
@@ -4134,12 +4064,12 @@
4064 {
4065 "slug": "GITHUB_SET_TEAM_ACCESS_RESTRICTIONS",
4066 "name": "Set team access restrictions",
4137 - "description": "Sets team push access for a protected branch by replacing all current teams with a new list of valid team slugs (provided in the request body); an empty list of slugs removes all team restrictions."
4067 + "description": "Replaces the list of teams with push access to a protected branch. This action sets (replaces) the teams that have push access to a protected branch. Unlike 'Add team access restrictions' (POST), this action replaces the entire list rather than adding to it. Use an empty list to remove all team restrictions. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access"
4068 },
4069 {
4070 "slug": "GITHUB_SET_USER_ACCESS_RESTRICTIONS",
4071 "name": "Set user access restrictions",
4142 - "description": "Replaces the list of users with push access to a protected branch using a request body (not in this schema) containing an array of github usernames; this enables branch protection if not already active."
4072 + "description": "Replaces the list of users with push access to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - This REPLACES (not adds to) the existing list of users with push access - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items - To add users without replacing, use the 'add_user_access_restrictions' action instead"
4073 },
4074 {
4075 "slug": "GITHUB_SET_WORKFLOW_EXTERNAL_ACCESS",
@@ -4149,42 +4079,42 @@
4079 {
4080 "slug": "GITHUB_STAR_A_GIST",
4081 "name": "Star a gist",
4152 - "description": "Stars a github gist identified by `gist id`; this action is idempotent and returns a 204 no content status upon success, even if the gist is already starred."
4082 + "description": "Stars a GitHub gist identified by `gist_id`; this action is idempotent and returns a 204 No Content status upon success, even if the gist is already starred."
4083 },
4084 {
4085 "slug": "GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER",
4156 - "name": "Star a repository for the authenticated user",
4157 - "description": "Stars an existing and accessible repository for the authenticated user; this action is idempotent and succeeds even if the repository is already starred."
4086 + "name": "Star a specified repository (requires owner and repo)",
4087 + "description": "Stars a specified repository (identified by owner and repo name) for the authenticated user; this action is idempotent and succeeds even if the repository is already starred. Requires explicit repository identification via owner and repo parameters."
4088 },
4089 {
4090 "slug": "GITHUB_START_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
4091 "name": "Start a codespace for the authenticated user",
4162 - "description": "Initiates the startup process for an existing github codespace (identified by `codespace name`) if it's in a startable state like 'available' or 'stopped'."
4092 + "description": "Initiates the startup process for an existing GitHub Codespace (identified by `codespace_name`) if it's in a startable state like 'Available' or 'Stopped'."
4093 },
4094 {
4095 "slug": "GITHUB_STOP_A_CODESPACE_FOR_AN_ORGANIZATION_USER",
4096 "name": "Stop a codespace for an organization user",
4167 - "description": "Stops a codespace, which must be currently running, for a specified member of an organization."
4097 + "description": "Stops a running codespace for an organization member. This action allows organization administrators to stop a codespace that belongs to a member of their organization. The codespace must be in a running state (e.g., 'Available') to be stopped. Required permissions: - OAuth/PAT: admin:org scope - Fine-grained tokens: 'Organization codespaces' (write) or 'Codespaces lifecycle admin' (write) Common HTTP responses: - 200: Codespace successfully stopped, returns codespace object - 304: Not modified (codespace already stopped) - 401: Authentication required - 403: Insufficient permissions (need admin:org) - 404: Organization, user, or codespace not found"
4098 },
4099 {
4100 "slug": "GITHUB_STOP_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
4101 "name": "Stop a codespace for the authenticated user",
4172 - "description": "Stops a running or available codespace for the authenticated user, pausing its execution and billing."
4102 + "description": "Stops a running or available Codespace for the authenticated user, pausing its execution and billing."
4103 },
4104 {
4105 "slug": "GITHUB_SUBMIT_A_REVIEW_FOR_A_PULL_REQUEST",
4106 "name": "Submit a review for a pull request",
4177 - "description": "Finalizes a pending pull request review (identified by `review id`) with a required `event` (approve, request changes, comment) and an optional `body`."
4107 + "description": "Finalizes a pending pull request review (identified by `review_id`) with a required `event` (APPROVE, REQUEST_CHANGES, COMMENT) and an optional `body`."
4108 },
4109 {
4110 "slug": "GITHUB_SYNC_A_FORK_BRANCH_WITH_THE_UPSTREAM_REPOSITORY",
4111 "name": "Sync a fork branch with the upstream repository",
4182 - "description": "Synchronizes a branch in a forked github repository with its upstream counterpart, assuming the repository is a fork, the branch exists, an upstream is configured, and the merge is conflict-free."
4112 + "description": "Synchronizes a branch in a forked GitHub repository with its upstream counterpart, assuming the repository is a fork, the branch exists, an upstream is configured, and the merge is conflict-free."
4113 },
4114 {
4115 "slug": "GITHUB_TEST_THE_PUSH_REPOSITORY_WEBHOOK",
4116 "name": "Test the push repository webhook",
4187 - "description": "Triggers a simulated push event to test a repository's push webhook; a test event is only delivered if the webhook is subscribed to 'push' events, otherwise, it returns 204 no content without sending a post."
4117 + "description": "Triggers a simulated push event to test a repository's push webhook; a test event is only delivered if the webhook is subscribed to 'push' events, otherwise, it returns 204 No Content without sending a POST."
4118 },
4119 {
4120 "slug": "GITHUB_TRANSFER_A_REPOSITORY",
@@ -4194,7 +4124,7 @@
4124 {
4125 "slug": "GITHUB_UNBLOCK_A_USER",
4126 "name": "Unblock a user",
4197 - "description": "Unblocks a github user, provided they are currently blocked by the authenticated user."
4127 + "description": "Unblocks a GitHub user, provided they are currently blocked by the authenticated user."
4128 },
4129 {
4130 "slug": "GITHUB_UNBLOCK_A_USER_FROM_AN_ORGANIZATION",
@@ -4204,22 +4134,22 @@
4134 {
4135 "slug": "GITHUB_UNFOLLOW_A_USER",
4136 "name": "Unfollow a user",
4207 - "description": "Unfollows an existing github user; this action is idempotent, succeeding even if the authenticated user is not currently following them."
4137 + "description": "Unfollows an existing GitHub user; this action is idempotent, succeeding even if the authenticated user is not currently following them."
4138 },
4139 {
4140 "slug": "GITHUB_UNLOCK_AN_ISSUE",
4141 "name": "Unlock an issue",
4212 - "description": "Unlocks a currently locked github issue in the specified repository, allowing new comments and interactions."
4142 + "description": "Unlocks a currently locked GitHub issue in the specified repository, allowing new comments and interactions."
4143 },
4144 {
4145 "slug": "GITHUB_UNLOCK_AN_ORGANIZATION_REPOSITORY",
4146 "name": "Unlock an organization repository",
4217 - "description": "Unlocks an organization repository previously locked by a github migration."
4147 + "description": "Unlocks a repository that was locked for migration within a GitHub organization. This action is part of the organization migrations workflow. When you start a migration with `lock_repositories=true`, the source repositories are locked to prevent changes during export. After the migration is complete and applied to the target instance, use this action to unlock the repositories so they can be accessed or deleted. Requirements: - You must be an organization owner to unlock repositories - The repository must be currently locked as part of the specified migration - This endpoint does not work with GitHub App tokens or fine-grained personal access tokens Typical workflow: 1. Start an organization migration with POST /orgs/{org}/migrations 2. Wait for the migration to complete (state: \"exported\") 3. Apply the migration to your target instance 4. Unlock each migrated repository using this action 5. Delete the source repositories if no longer needed"
4148 },
4149 {
4150 "slug": "GITHUB_UNLOCK_A_USER_REPOSITORY",
4151 "name": "Unlock a user repository",
4222 - "description": "Unlocks a repository (`repo name`) that was locked as part of a user migration (`migration id`), making it usable or deletable; this action requires the repository to be currently locked."
4152 + "description": "Unlocks a repository (`repo_name`) that was locked as part of a user migration (`migration_id`), making it usable or deletable; this action requires the repository to be currently locked."
4153 },
4154 {
4155 "slug": "GITHUB_UNSTAR_A_GIST",
@@ -4234,22 +4164,22 @@
4164 {
4165 "slug": "GITHUB_UPDATE_A_CHECK_RUN",
4166 "name": "Update a check run",
4237 - "description": "Updates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details."
4167 + "description": "Updates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details. NOTE: This endpoint requires GitHub App authentication with 'checks:write' permission - OAuth tokens and personal access tokens cannot update check runs."
4168 },
4169 {
4170 "slug": "GITHUB_UPDATE_A_CODE_SCANNING_ALERT",
4171 "name": "Update a code scanning alert",
4242 - "description": "Updates a specific code scanning alert in a github repository, primarily to change its state (e.g., 'open' or 'dismissed')."
4172 + "description": "Updates a specific code scanning alert in a GitHub repository, primarily to change its state (e.g., 'open' or 'dismissed')."
4173 },
4174 {
4175 "slug": "GITHUB_UPDATE_A_CODE_SCANNING_DEFAULT_SETUP_CONFIGURATION",
4176 "name": "Update a code scanning default setup configuration",
4247 - "description": "Updates the default setup configuration for code scanning in a repository; github advanced security must be enabled for the repository."
4177 + "description": "Updates the default setup configuration for code scanning in a repository; GitHub Advanced Security must be enabled for the repository."
4178 },
4179 {
4180 "slug": "GITHUB_UPDATE_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
4181 "name": "Update a codespace for the authenticated user",
4252 - "description": "Updates an existing github codespace's machine type, display name, or recent folders for the authenticated user; machine type changes take effect on the next start."
4182 + "description": "Updates an existing GitHub Codespace's machine type, display name, or recent folders for the authenticated user; machine type changes take effect on the next start."
4183 },
4184 {
4185 "slug": "GITHUB_UPDATE_A_COMMIT_COMMENT",
@@ -4294,32 +4224,32 @@
4224 {
4225 "slug": "GITHUB_UPDATE_A_MILESTONE",
4226 "name": "Update a milestone",
4297 - "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."
4227 + "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."
4228 },
4229 {
4230 "slug": "GITHUB_UPDATE_AN_ENVIRONMENT_VARIABLE",
4231 "name": "Update an environment variable",
4302 - "description": "Updates an existing environment variable's name and/or value in a specific github repository environment; requires providing either a new name or a new value."
4232 + "description": "Updates an existing environment variable's name and/or value in a specific GitHub repository environment; requires providing either a new name or a new value."
4233 },
4234 {
4235 "slug": "GITHUB_UPDATE_AN_EXISTING_PROJECT_CARD",
4306 - "name": "Update an existing project card",
4307 - "description": "Updates an existing project card's note and/or archived status, identified by its `card id`."
4236 + "name": "Update an existing project card (Classic - Deprecated)",
4237 + "description": "Updates an existing project card's note and/or archived status (GitHub Classic Projects). 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/"
4238 },
4239 {
4240 "slug": "GITHUB_UPDATE_AN_EXISTING_PROJECT_COLUMN",
4311 - "name": "Update an existing project column",
4312 - "description": "Updates the name of an existing column, identified by `column id`, in a github project (classic)."
4241 + "name": "Update an existing project column (Classic - Deprecated)",
4242 + "description": "Updates the name of an existing column, identified by `column_id`, 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/"
4243 },
4244 {
4245 "slug": "GITHUB_UPDATE_AN_ISSUE",
4246 "name": "Update an issue",
4317 - "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."
4247 + "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."
4248 },
4249 {
4250 "slug": "GITHUB_UPDATE_AN_ISSUE_COMMENT",
4251 "name": "Update an issue comment",
4322 - "description": "Updates an existing comment on an issue or pull request within a specified repository."
4252 + "description": "Updates an existing comment on an issue or pull request within a specified repository. You can only update comments that the authenticated user has permission to edit. The comment_id can be obtained from the list_issue_comments or get_an_issue_comment actions."
4253 },
4254 {
4255 "slug": "GITHUB_UPDATE_AN_ORGANIZATION",
@@ -4329,17 +4259,17 @@
4259 {
4260 "slug": "GITHUB_UPDATE_AN_ORGANIZATION_VARIABLE",
4261 "name": "Update an organization variable",
4332 - "description": "Updates an existing github actions organization variable's name, value, or visibility (`all`, `private`, `selected`), requiring `selected repository ids` with valid repository ids if visibility is `selected`."
4262 + "description": "Updates an existing GitHub Actions organization variable's name, value, or visibility (`all`, `private`, `selected`), requiring `selected_repository_ids` with valid repository IDs if visibility is `selected`."
4263 },
4264 {
4265 "slug": "GITHUB_UPDATE_AN_ORGANIZATION_WEBHOOK",
4266 "name": "Update an organization webhook",
4337 - "description": "Updates the configuration (url, content type, secret, ssl verification), subscribed events, active status, or name of an existing webhook for a specified organization."
4267 + "description": "Updates the configuration (URL, content type, secret, SSL verification), subscribed events, active status, or name of an existing webhook for a specified organization."
4268 },
4269 {
4270 "slug": "GITHUB_UPDATE_A_PROJECT",
4271 "name": "Update a project",
4342 - "description": "Updates an existing github project's attributes if the github projects feature is enabled and at least one modifiable field is provided."
4272 + "description": "Updates an existing GitHub project (V2) attributes like title, description, visibility, and state. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed. At least one field to update must be provided."
4273 },
4274 {
4275 "slug": "GITHUB_UPDATE_A_PULL_REQUEST",
@@ -4354,22 +4284,22 @@
4284 {
4285 "slug": "GITHUB_UPDATE_A_REFERENCE",
4286 "name": "Update a reference",
4357 - "description": "Updates a git reference (e.g., a branch or tag) to a specific commit sha, creating the reference if it doesn't exist; use `force` for non-fast-forward updates."
4287 + "description": "Updates an existing Git reference (e.g., a branch or tag) to point to a specific commit SHA. By default, only allows fast-forward updates (where the new commit is a descendant of the current one). Set `force=true` to allow non-fast-forward updates that rewrite history. IMPORTANT: The reference must already exist - use 'Create a reference' action to create new refs."
4288 },
4289 {
4290 "slug": "GITHUB_UPDATE_A_RELEASE",
4291 "name": "Update a release",
4362 - "description": "Updates an existing release in a github repository, allowing modification of its attributes; if linking a discussion, the `discussion category name` must refer to an existing category in the repository."
4292 + "description": "Updates an existing release in a GitHub repository, allowing modification of its attributes; if linking a discussion, the `discussion_category_name` must refer to an existing category in the repository."
4293 },
4294 {
4295 "slug": "GITHUB_UPDATE_A_RELEASE_ASSET",
4296 "name": "Update a release asset",
4367 - "description": "Updates the name, label, or state of a release asset in a github repository, requiring at least one of these properties to be provided for modification."
4297 + "description": "Updates the name, label, or state of a release asset in a GitHub repository, requiring at least one of these properties to be provided for modification."
4298 },
4299 {
4300 "slug": "GITHUB_UPDATE_A_REPOSITORY",
4301 "name": "Update a repository",
4372 - "description": "Updates settings for an existing github repository, such as name, description, visibility, merge strategies, and security configurations."
4302 + "description": "Updates settings for an existing GitHub repository, such as name, description, visibility, merge strategies, and security configurations."
4303 },
4304 {
4305 "slug": "GITHUB_UPDATE_A_REPOSITORY_INVITATION",
@@ -4379,17 +4309,17 @@
4309 {
4310 "slug": "GITHUB_UPDATE_A_REPOSITORY_RULESET",
4311 "name": "Update a repository ruleset",
4382 - "description": "Updates an existing repository ruleset, identified by `ruleset id` for a given repository, allowing partial updates to its configuration such as name, target, enforcement, bypass actors, conditions, and rules."
4312 + "description": "Updates an existing repository ruleset, identified by `ruleset_id` for a given repository, allowing partial updates to its configuration such as name, target, enforcement, bypass actors, conditions, and rules."
4313 },
4314 {
4315 "slug": "GITHUB_UPDATE_A_REPOSITORY_VARIABLE",
4316 "name": "Update a repository variable",
4387 - "description": "Updates the name and/or value of an existing github actions variable in a repository."
4317 + "description": "Updates the name and/or value of an existing GitHub Actions variable in a repository."
4318 },
4319 {
4320 "slug": "GITHUB_UPDATE_A_REPOSITORY_WEBHOOK",
4321 "name": "Update a repository webhook",
4392 - "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`."
4322 + "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`."
4323 },
4324 {
4325 "slug": "GITHUB_UPDATE_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
@@ -4404,17 +4334,17 @@
4334 {
4335 "slug": "GITHUB_UPDATE_A_TEAM",
4336 "name": "Update a team",
4407 - "description": "Updates a team's settings (e.g., name, description, privacy, parent team) within a github organization, identified by its slug and organization name."
4337 + "description": "Updates a team's settings (e.g., name, description, privacy, parent team) within a GitHub organization, identified by its slug and organization name."
4338 },
4339 {
4340 "slug": "GITHUB_UPDATE_A_WEBHOOK_CONFIGURATION_FOR_AN_ORGANIZATION",
4341 "name": "Update a webhook configuration for an organization",
4412 - "description": "Updates the configuration (url, content type, secret, ssl verification) for an existing webhook within a specified organization."
4342 + "description": "Updates the configuration (URL, content type, secret, SSL verification) for an existing webhook within a specified organization."
4343 },
4344 {
4345 "slug": "GITHUB_UPDATE_A_WEBHOOK_CONFIGURATION_FOR_A_REPOSITORY",
4346 "name": "Update a webhook configuration for a repository",
4417 - "description": "Updates the configuration (e.g., payload url, content type, secret, ssl verification) for an existing webhook in a specified repository."
4347 + "description": "Updates the configuration (e.g., payload URL, content type, secret, SSL verification) for an existing webhook in a specified repository."
4348 },
4349 {
4350 "slug": "GITHUB_UPDATE_BRANCH_PROTECTION",
@@ -4423,13 +4353,13 @@
4353 },
4354 {
4355 "slug": "GITHUB_UPDATE_GIT_LFS_PREFERENCE",
4426 - "name": "Update git lfs preference",
4427 - "description": "Sets the git large file storage (lfs) preference for a repository, typically before initiating a source import."
4356 + "name": "Update Git LFS Preference",
4357 + "description": "Sets the Git Large File Storage (LFS) preference for a repository during a source import. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports."
4358 },
4359 {
4360 "slug": "GITHUB_UPDATE_INFORMATION_ABOUT_A_GITHUB_PAGES_SITE",
4361 "name": "Update information about a github pages site",
4432 - "description": "Updates the configuration for a github pages site (e.g., custom domain, https, build type, source); requires github pages to be enabled for the repository, and if `build type` is 'workflow', a corresponding github actions workflow must be configured."
4362 + "description": "Updates the configuration for a GitHub Pages site (e.g., custom domain, HTTPS, build type, source); requires GitHub Pages to be enabled for the repository, and if `build_type` is 'workflow', a corresponding GitHub Actions workflow must be configured."
4363 },
4364 {
4365 "slug": "GITHUB_UPDATE_PULL_REQUEST_REVIEW_PROTECTION",
@@ -4439,12 +4369,12 @@
4369 {
4370 "slug": "GITHUB_UPDATE_REPOSITORY_PREFERENCES_FOR_CHECK_SUITES",
4371 "name": "Update repository preferences for check suites",
4442 - "description": "Updates repository preferences for automatic check suite creation on code pushes, allowing configuration for specific github apps that must be installed on the repository with `checks:write` permission."
4372 + "description": "Updates repository preferences for automatic Check Suite creation on code pushes, allowing configuration for specific GitHub Apps that must be installed on the repository with `checks:write` permission."
4373 },
4374 {
4375 "slug": "GITHUB_UPDATE_RESOURCE_ACCESS_WITH_TOKENS",
4376 "name": "Update resource access with tokens",
4447 - "description": "Revokes organization access for the personal access tokens identified by `pat ids`; this action must be performed by a github app, and `pat ids` must be valid and associated with the organization."
4377 + "description": "Revokes organization access for the personal access tokens identified by `pat_ids`; this action must be performed by a GitHub App, and `pat_ids` must be valid and associated with the organization. AUTHENTICATION REQUIREMENT: This endpoint requires GitHub App authentication with 'Personal access tokens' organization permissions (write). Standard personal access tokens CANNOT use this endpoint. The GitHub App must also have access to the organization."
4378 },
4379 {
4380 "slug": "GITHUB_UPDATE_STATUS_CHECK_PROTECTION",
@@ -4454,47 +4384,22 @@
4384 {
4385 "slug": "GITHUB_UPDATE_THE_AUTHENTICATED_USER",
4386 "name": "Update the authenticated user",
4457 - "description": "Updates the authenticated user's github profile; a new public email must be verified, and existing private emails remain private even if specified."
4387 + "description": "Updates the authenticated user's GitHub profile; a new public email must be verified, and existing private emails remain private even if specified."
4388 },
4389 {
4390 "slug": "GITHUB_UPDATE_TOKEN_ORG_ACCESS",
4461 - "name": "Update token org access",
4462 - "description": "Revokes a fine-grained personal access token's access to an organization, usable only by github apps when the token has existing access to that organization."
4391 + "name": "Revoke Token Organization Access",
4392 + "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."
4393 },
4394 {
4395 "slug": "GITHUB_UPLOAD_AN_ANALYSIS_AS_SARIF_DATA",
4396 "name": "Upload an analysis as sarif data",
4467 - "description": "Uploads a gzipped and base64 encoded sarif file to a github repository for a specific commit and reference; use `checkout uri` if sarif paths are absolute."
4468 - },
4469 - {
4470 - "slug": "GITHUB_USERS_GET_AUTHENTICATED",
4471 - "name": "Get the authenticated user",
4472 - "description": "[deprecated] retrieves the authenticated user's information; use `get the authenticated user` instead."
4473 - },
4474 - {
4475 - "slug": "GITHUB_USERS_GET_BY_USERNAME",
4476 - "name": "Get a user",
4477 - "description": "Deprecated: use the `getauser` action to retrieve a github user's public profile by username."
4478 - },
4479 - {
4480 - "slug": "GITHUB_USERS_GET_CONTEXT_FOR_USER",
4481 - "name": "Get contextual information for a user",
4482 - "description": "Retrieves contextual hovercard information for a github user. (deprecated: please use the `get contextual information for a user` action instead)."
4483 - },
4484 - {
4485 - "slug": "GITHUB_USERS_LIST_FOLLOWERS_FOR_AUTHENTICATED_USER",
4486 - "name": "List followers of the authenticated user",
4487 - "description": "Deprecated: lists users following the authenticated github user; use `list followers of the authenticated user` instead."
4488 - },
4489 - {
4490 - "slug": "GITHUB_USERS_LIST_PUBLIC_EMAILS_FOR_AUTHENTICATED_USER",
4491 - "name": "List public email addresses for the authenticated user",
4492 - "description": "Deprecated: use `listpublicemailaddressesfortheauthenticateduser` instead; lists public email addresses for the authenticated user."
4397 + "description": "Uploads a gzipped and Base64 encoded SARIF file to a GitHub repository for a specific commit and reference; use `checkout_uri` if SARIF paths are absolute."
4398 },
4399 {
4495 - "slug": "GITHUB_USERS_LIST_SOCIAL_ACCOUNTS_FOR_USER",
4496 - "name": "List social accounts for a user",
4497 - "description": "Deprecated: lists social media accounts for an existing github user; use 'list social accounts for a user' instead."
4400 + "slug": "GITHUB_UPLOAD_RELEASE_ASSET",
4401 + "name": "Upload a release asset",
4402 + "description": "Tool to upload a binary asset to an existing GitHub release. Use when you need to attach files like installers or backups to a release programmatically."
4403 },
4404 {
4405 "slug": "GITHUB_VERIFY_DEV_CONTAINER_PERMISSIONS_ACCEPTED",
@@ -4594,49 +4499,119 @@
4499 "authSchemes": [
4500 "OAUTH2"
4501 ],
4597 - "toolCount": 28,
4502 + "toolCount": 46,
4503 "triggerCount": 7,
4504 "version": "20260211_00",
4505 "tools": [
4506 + {
4507 + "slug": "GOOGLECALENDAR_ACL_DELETE",
4508 + "name": "Delete ACL Rule",
4509 + "description": "Deletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain."
4510 + },
4511 + {
4512 + "slug": "GOOGLECALENDAR_ACL_GET",
4513 + "name": "Get ACL Rule",
4514 + "description": "Retrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain."
4515 + },
4516 + {
4517 + "slug": "GOOGLECALENDAR_ACL_INSERT",
4518 + "name": "Create ACL Rule",
4519 + "description": "Creates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain."
4520 + },
4521 + {
4522 + "slug": "GOOGLECALENDAR_ACL_PATCH",
4523 + "name": "Patch ACL Rule",
4524 + "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."
4525 + },
4526 + {
4527 + "slug": "GOOGLECALENDAR_ACL_WATCH",
4528 + "name": "Watch ACL Changes",
4529 + "description": "Tool to watch for changes to ACL resources. Use when you need to set up real-time notifications for access control list modifications on a calendar."
4530 + },
4531 + {
4532 + "slug": "GOOGLECALENDAR_BATCH_EVENTS",
4533 + "name": "Batch Events",
4534 + "description": "Execute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results. Use this to materially reduce round-trips for bulk operations like migrations, cleanup, or large-scale updates."
4535 + },
4536 + {
4537 + "slug": "GOOGLECALENDAR_CALENDAR_LIST_DELETE",
4538 + "name": "Remove Calendar from List",
4539 + "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."
4540 + },
4541 + {
4542 + "slug": "GOOGLECALENDAR_CALENDAR_LIST_GET",
4543 + "name": "Get Single Calendar by ID",
4544 + "description": "Retrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID. This action requires a calendarId parameter and returns details about that one calendar only. NOTE: This does NOT list all calendars. To list all calendars in the user's calendar list, use GOOGLECALENDAR_CALENDAR_LIST_LIST instead."
4545 + },
4546 {
4547 "slug": "GOOGLECALENDAR_CALENDAR_LIST_INSERT",
4548 "name": "Insert Calendar into List",
4549 "description": "Inserts an existing calendar into the user's calendar list."
4550 },
4551 + {
4552 + "slug": "GOOGLECALENDAR_CALENDAR_LIST_PATCH",
4553 + "name": "Patch Calendar List Entry",
4554 + "description": "Updates an existing calendar on the user's calendar list using patch semantics. This method allows partial updates, modifying only the specified fields."
4555 + },
4556 {
4557 "slug": "GOOGLECALENDAR_CALENDAR_LIST_UPDATE",
4558 "name": "Update Calendar List Entry",
4559 "description": "Updates an existing entry on the user\\'s calendar list."
4560 },
4561 + {
4562 + "slug": "GOOGLECALENDAR_CALENDAR_LIST_WATCH",
4563 + "name": "Watch Calendar List",
4564 + "description": "Watch for changes to CalendarList resources using push notifications. Use this to receive real-time updates when calendar list entries are modified."
4565 + },
4566 {
4567 "slug": "GOOGLECALENDAR_CALENDARS_DELETE",
4568 "name": "Delete Calendar",
4614 - "description": "Deletes a secondary calendar. use calendars.clear for clearing all events on primary calendars."
4569 + "description": "Deletes a secondary calendar that you own or have delete permissions on. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead."
4570 },
4571 {
4572 "slug": "GOOGLECALENDAR_CALENDARS_UPDATE",
4573 "name": "Update Calendar",
4574 "description": "Updates metadata for a calendar."
4575 },
4576 + {
4577 + "slug": "GOOGLECALENDAR_CHANNELS_STOP",
4578 + "name": "Stop Channel",
4579 + "description": "Tool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription."
4580 + },
4581 {
4582 "slug": "GOOGLECALENDAR_CLEAR_CALENDAR",
4583 "name": "Clear Calendar",
4624 - "description": "Clears a primary calendar. this operation deletes all events associated with the primary calendar of an account."
4584 + "description": "Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account."
4585 + },
4586 + {
4587 + "slug": "GOOGLECALENDAR_COLORS_GET",
4588 + "name": "Get Color Definitions",
4589 + "description": "Returns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events."
4590 },
4591 {
4592 "slug": "GOOGLECALENDAR_CREATE_EVENT",
4593 "name": "Create Event",
4629 - "description": "Creates an event on a google calendar, needing rfc3339 utc start/end times (end after start) and write access to the calendar. by default, adds the organizer as an attendee unless exclude organizer is set to true."
4594 + "description": "Create a Google Calendar event using `start_datetime` plus `event_duration_hour` and `event_duration_minutes` fields to derive the end time. Requires calendar write access. The organizer is added as an attendee unless `exclude_organizer` is True. By default, attempts to create a Google Meet link for the event (create_meeting_room defaults to True). Workspace accounts will receive a Meet link, while personal Gmail accounts will gracefully fallback to creating an event without a Meet link when conference creation fails. Set create_meeting_room to False to explicitly skip Meet link creation. Example request to create event for 1 hour 30 minutes: { \"calendar_id\": \"primary\", \"start_datetime\": \"2025-01-16T13:00:00\", \"timezone\": \"America/New_York\", \"event_duration_hour\": 1, \"event_duration_minutes\": 30, \"summary\": \"Client sync\", \"attendees\": [\"guest@example.com\", \"test@example.com\"] }"
4595 },
4596 {
4597 "slug": "GOOGLECALENDAR_DELETE_EVENT",
4598 "name": "Delete event",
4634 - "description": "Deletes a specified event by `event id` from a google calendar (`calendar id`); this action is idempotent and raises a 404 error if the event is not found."
4599 + "description": "Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); this action is idempotent and raises a 404 error if the event is not found."
4600 },
4601 {
4602 "slug": "GOOGLECALENDAR_DUPLICATE_CALENDAR",
4603 "name": "Create a calendar",
4639 - "description": "Creates a new, empty google calendar with the specified title (summary)."
4604 + "description": "Creates a new, empty Google Calendar with the specified title (summary)."
4605 + },
4606 + {
4607 + "slug": "GOOGLECALENDAR_EVENTS_GET",
4608 + "name": "Get Event",
4609 + "description": "Retrieves a SINGLE event by its unique event_id (REQUIRED). This action does NOT list or search events - it fetches ONE specific event when you already know its ID. If you want to list events within a time range, search for events, or filter by criteria like time_min/time_max, use GOOGLECALENDAR_EVENTS_LIST instead."
4610 + },
4611 + {
4612 + "slug": "GOOGLECALENDAR_EVENTS_IMPORT",
4613 + "name": "Import Event",
4614 + "description": "Tool to import an event as a private copy to a calendar. Use when you need to add an existing event to a calendar using its iCalUID. Only events with eventType='default' can be imported."
4615 },
4616 {
4617 "slug": "GOOGLECALENDAR_EVENTS_INSTANCES",
@@ -4646,7 +4621,12 @@
4621 {
4622 "slug": "GOOGLECALENDAR_EVENTS_LIST",
4623 "name": "List Events",
4649 - "description": "Returns events on the specified calendar."
4624 + "description": "Returns events on the specified calendar. TIMEZONE WARNING: When using timeMin/timeMax with UTC timestamps (ending in 'Z'), the time window is interpreted in UTC regardless of the calendar's timezone. For example, querying '2026-01-19T00:00:00Z' to '2026-01-20T00:00:00Z' on a calendar in America/Los_Angeles (UTC-8) covers 2026-01-18 4pm to 2026-01-19 4pm local time, potentially missing events on the intended local date. To query for a specific local date, use timestamps with the appropriate timezone offset in timeMin/timeMax (e.g., '2026-01-19T00:00:00-08:00' for PST)."
4625 + },
4626 + {
4627 + "slug": "GOOGLECALENDAR_EVENTS_LIST_ALL_CALENDARS",
4628 + "name": "List Events from All Calendars",
4629 + "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."
4630 },
4631 {
4632 "slug": "GOOGLECALENDAR_EVENTS_MOVE",
@@ -4656,17 +4636,17 @@
4636 {
4637 "slug": "GOOGLECALENDAR_EVENTS_WATCH",
4638 "name": "Watch Events",
4659 - "description": "Watch for changes to events resources."
4639 + "description": "Watch for changes to Events resources."
4640 },
4641 {
4642 "slug": "GOOGLECALENDAR_FIND_EVENT",
4643 "name": "Find event",
4664 - "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."
4644 + "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."
4645 },
4646 {
4647 "slug": "GOOGLECALENDAR_FIND_FREE_SLOTS",
4648 "name": "Find free slots",
4669 - "description": "Finds free/busy time slots in google calendars for specified calendars within a defined time range (defaults to the current day utc if `time min`/`time max` are omitted), enhancing busy intervals with event details; `time min` must precede `time max` if both are provided."
4649 + "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."
4650 },
4651 {
4652 "slug": "GOOGLECALENDAR_FREE_BUSY_QUERY",
@@ -4676,7 +4656,12 @@
4656 {
4657 "slug": "GOOGLECALENDAR_GET_CALENDAR",
4658 "name": "Get Google Calendar",
4679 - "description": "Retrieves a specific google calendar, identified by `calendar id`, to which the authenticated user has access."
4659 + "description": "Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access."
4660 + },
4661 + {
4662 + "slug": "GOOGLECALENDAR_GET_CALENDAR_PROFILE",
4663 + "name": "Get Calendar Profile",
4664 + "description": "Tool to retrieve the authenticated user's primary calendar profile. Use when you need to get information about the user's main calendar, including timezone, settings, and preferences."
4665 },
4666 {
4667 "slug": "GOOGLECALENDAR_GET_CURRENT_DATE_TIME",
@@ -4686,32 +4671,42 @@
4671 {
4672 "slug": "GOOGLECALENDAR_LIST_ACL_RULES",
4673 "name": "List ACL Rules",
4689 - "description": "Retrieves the list of access control rules (acls) for a specified calendar, providing the necessary 'rule id' values required for updating specific acl rules."
4674 + "description": "Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules."
4675 },
4676 {
4677 "slug": "GOOGLECALENDAR_LIST_CALENDARS",
4678 "name": "List Google Calendars",
4694 - "description": "Retrieves calendars from the user's google calendar list, with options for pagination and filtering."
4679 + "description": "Retrieves calendars from the user's Google Calendar list, with options for pagination and filtering."
4680 + },
4681 + {
4682 + "slug": "GOOGLECALENDAR_LIST_SETTINGS",
4683 + "name": "List Calendar Settings",
4684 + "description": "Tool to return all user settings for the authenticated user. Use when you need to retrieve calendar settings."
4685 },
4686 {
4687 "slug": "GOOGLECALENDAR_PATCH_CALENDAR",
4688 "name": "Patch Calendar",
4699 - "description": "Partially updates (patches) an existing google calendar, modifying only the fields provided; `summary` is mandatory and cannot be an empty string, and an empty string for `description` or `location` clears them."
4689 + "description": "Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided; `summary` is mandatory and cannot be an empty string, and an empty string for `description` or `location` clears them."
4690 },
4691 {
4692 "slug": "GOOGLECALENDAR_PATCH_EVENT",
4693 "name": "Patch Event",
4704 - "description": "Updates specified fields of an existing event in a google calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar id` and `event id` are valid and the user has write access to the calendar."
4694 + "description": "Update specified fields of an existing event in a Google Calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar_id` and `event_id` are valid and the user has write access to the calendar."
4695 },
4696 {
4697 "slug": "GOOGLECALENDAR_QUICK_ADD",
4698 "name": "Quick Add Event",
4709 - "description": "Parses natural language text to quickly create a basic google calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring events, and `calendar id` must be valid if not 'primary'."
4699 + "description": "Parses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring events, and `calendar_id` must be valid if not 'primary'."
4700 },
4701 {
4702 "slug": "GOOGLECALENDAR_REMOVE_ATTENDEE",
4703 "name": "Remove attendee from event",
4714 - "description": "Removes an attendee from a specified event in a google calendar; the calendar and event must exist."
4704 + "description": "Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist."
4705 + },
4706 + {
4707 + "slug": "GOOGLECALENDAR_SETTINGS_GET",
4708 + "name": "Get Calendar Setting",
4709 + "description": "Tool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value."
4710 },
4711 {
4712 "slug": "GOOGLECALENDAR_SETTINGS_LIST",
@@ -4721,12 +4716,12 @@
4716 {
4717 "slug": "GOOGLECALENDAR_SETTINGS_WATCH",
4718 "name": "Watch Settings",
4724 - "description": "Watch for changes to settings resources."
4719 + "description": "Watch for changes to Settings resources."
4720 },
4721 {
4722 "slug": "GOOGLECALENDAR_SYNC_EVENTS",
4723 "name": "Sync Events",
4729 - "description": "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."
4724 + "description": "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."
4725 },
4726 {
4727 "slug": "GOOGLECALENDAR_UPDATE_ACL_RULE",
@@ -4736,7 +4731,7 @@
4731 {
4732 "slug": "GOOGLECALENDAR_UPDATE_EVENT",
4733 "name": "Update Google event",
4739 - "description": "Updates an existing event by `event id` in a google calendar; this is a full put replacement, so provide all desired fields as unspecified ones may be cleared or reset."
4734 + "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, so provide all desired fields as unspecified ones may be cleared or reset."
4735 }
4736 ],
4737 "triggers": [
@@ -4837,149 +4832,239 @@
4832 "OAUTH2",
4833 "API_KEY"
4834 ],
4840 - "toolCount": 28,
4835 + "toolCount": 46,
4836 "triggerCount": 5,
4837 "version": "20260211_00",
4838 "tools": [
4839 {
4840 "slug": "NOTION_ADD_MULTIPLE_PAGE_CONTENT",
4841 "name": "Add multiple content blocks (bulk, user-friendly)",
4847 - "description": "Efficiently adds multiple standard content blocks to a notion page in a single api call with automatic markdown parsing. the 'content' field in notionrichtext blocks now automatically detects and parses markdown formatting including headers (# ## ###), bold (**text**), italic (*text*), strikethrough (~~text~~), inline code (`code`), links ([text](url)), and more. ideal for bulk content creation, ai agents, and replacing multiple individual add page content calls. supports automatic text formatting, content splitting, and up to 100 blocks per request."
4842 + "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"
4843 },
4844 {
4845 "slug": "NOTION_ADD_PAGE_CONTENT",
4851 - "name": "Add content to Notion page",
4852 - "description": "Deprecated: appends a single content block to a notion page or a parent block (must be page, toggle, to-do, bulleted/numbered list, callout, or quote); invoke repeatedly to add multiple blocks."
4846 + "name": "Add single content block to Notion page (Deprecated)",
4847 + "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."
4848 },
4849 {
4850 "slug": "NOTION_APPEND_BLOCK_CHILDREN",
4856 - "name": "Append complex blocks (advanced, full control)",
4857 - "description": "Appends complex blocks with full notion block structure to a parent block or page. use for advanced scenarios requiring precise control: code blocks, tables, embeds, nested children within blocks, or when working with pre-built notion block objects. requires full notion api block schema - use add multiple page content for simpler content creation."
4851 + "name": "Append raw Notion blocks (advanced API)",
4852 + "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."
4853 + },
4854 + {
4855 + "slug": "NOTION_APPEND_CODE_BLOCKS",
4856 + "name": "Append code blocks (code, quote, equation)",
4857 + "description": "Append code and technical blocks (code, quote, equation) to a Notion page. Use for: - Code snippets and programming examples (code) - Citations and highlighted quotes (quote) - Mathematical formulas and equations (equation) Supported block types: - code: Code with syntax highlighting (70+ languages including Python, JavaScript, Go, Rust, etc.) - quote: Block quotes for citations - equation: LaTeX/KaTeX mathematical expressions ⚠️ Code content is limited to 2000 characters per text.content field. For longer code, split into multiple code blocks. For other block types, use specialized actions: - append_text_blocks: paragraphs, headings, lists - append_task_blocks: to-do, toggle, callout - append_media_blocks: image, video, audio, files - append_layout_blocks: divider, columns, TOC - append_table_blocks: tables"
4858 + },
4859 + {
4860 + "slug": "NOTION_APPEND_LAYOUT_BLOCKS",
4861 + "name": "Append layout blocks (divider, TOC, columns)",
4862 + "description": "Append layout blocks (divider, TOC, breadcrumb, columns) to a Notion page. Supported types: - divider: Horizontal line separator - table_of_contents: Auto-generated from headings - breadcrumb: Page hierarchy navigation - column_list: Multi-column layout (requires 2+ columns, each with 1+ child block) For multi-column layouts, create column_list with column children in one request. Each column must contain at least 1 child block. For other blocks, use: append_text_blocks, append_task_blocks, append_code_blocks, append_media_blocks, or append_table_blocks."
4863 + },
4864 + {
4865 + "slug": "NOTION_APPEND_MEDIA_BLOCKS",
4866 + "name": "Append media blocks (image, video, audio, files)",
4867 + "description": "Append media blocks (image, video, audio, file, pdf, embed, bookmark) to a Notion page. Use for: - Images and screenshots (image) - YouTube/Vimeo videos or direct video URLs (video) - Audio files and podcasts (audio) - File downloads (file) - PDF documents (pdf) - Embedded content from Twitter, Figma, CodePen, etc. (embed) - Link previews with metadata (bookmark) All media blocks require external URLs. For other block types, use specialized actions: - append_text_blocks: paragraphs, headings, lists - append_task_blocks: to-do, toggle, callout - append_code_blocks: code, quote, equation - append_layout_blocks: divider, columns, TOC - append_table_blocks: tables"
4868 + },
4869 + {
4870 + "slug": "NOTION_APPEND_TABLE_BLOCKS",
4871 + "name": "Append table blocks",
4872 + "description": "Append table blocks to a Notion page. Use for structured tabular data like spreadsheets, comparison charts, and status trackers. Example: { \"table_width\": 3, \"has_column_header\": true, \"rows\": [ {\"cells\": [[{\"type\": \"text\", \"text\": {\"content\": \"Col1\"}}], [...], [...]]} ] } ⚠️ Cell content limited to 2000 chars per text.content field."
4873 + },
4874 + {
4875 + "slug": "NOTION_APPEND_TASK_BLOCKS",
4876 + "name": "Append task blocks (to-do, toggle, callout)",
4877 + "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."
4878 + },
4879 + {
4880 + "slug": "NOTION_APPEND_TEXT_BLOCKS",
4881 + "name": "Append text blocks (paragraphs, headings, lists)",
4882 + "description": "Append text blocks (paragraphs, headings, lists) to a Notion page. This is the most commonly used action for adding content to Notion. Use for: documentation, notes, articles, outlines, lists. Supported block types: - paragraph: Regular text - heading_1, heading_2, heading_3: Section headers - bulleted_list_item: Bullet points - numbered_list_item: Numbered lists ⚠️ Text content is limited to 2000 characters per text.content field. For other block types, use specialized actions: - append_task_blocks: to-do, toggle, callout - append_code_blocks: code, quote, equation - append_media_blocks: image, video, audio, files - append_layout_blocks: divider, columns, TOC - append_table_blocks: tables"
4883 },
4884 {
4885 "slug": "NOTION_ARCHIVE_NOTION_PAGE",
4886 "name": "Archive Notion Page",
4862 - "description": "Archives (moves to trash) or unarchives (restores from trash) a specified notion page."
4887 + "description": "Archives (moves to trash) or unarchives (restores from trash) a specified Notion page. Limitation: Workspace-level pages (top-level pages with no parent page or database) cannot be archived via the API and must be archived manually in the Notion UI."
4888 },
4889 {
4890 "slug": "NOTION_CREATE_COMMENT",
4891 "name": "Create comment",
4867 - "description": "Adds a comment to a notion page (via `parent page id`) or to an existing discussion thread (via `discussion id`); cannot create new discussion threads on specific blocks (inline comments)."
4892 + "description": "Adds a comment to a Notion page (via `parent_page_id`) OR to an existing discussion thread (via `discussion_id`); cannot create new discussion threads on specific blocks (inline comments)."
4893 },
4894 {
4895 "slug": "NOTION_CREATE_DATABASE",
4896 "name": "Create Notion Database",
4872 - "description": "Creates a new notion database as a subpage under a specified parent page with a defined properties schema; use this action exclusively for creating new databases."
4897 + "description": "Creates a new Notion database as a subpage under a specified parent page with a defined properties schema. IMPORTANT NOTES: - The parent page MUST be shared with your integration, otherwise you'll get a 404 error - If you encounter conflict errors (409), retry the request as Notion may experience temporary save conflicts - For relation properties, you MUST provide the database_id of the related database - Parent ID must be a valid UUID format (with or without hyphens), not a template variable Use this action exclusively for creating new databases."
4898 + },
4899 + {
4900 + "slug": "NOTION_CREATE_FILE_UPLOAD",
4901 + "name": "Create Notion file upload",
4902 + "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."
4903 },
4904 {
4905 "slug": "NOTION_CREATE_NOTION_PAGE",
4906 "name": "Create Notion page",
4877 - "description": "Creates a new empty page in a notion workspace."
4907 + "description": "Creates a new empty page in a Notion workspace under a specified parent page or database. PREREQUISITES: - Parent page/database must exist and be accessible in your Notion workspace - Use search_pages or list_databases first to obtain valid parent IDs LIMITATIONS: - Cannot create root-level pages (must have a parent) - May encounter conflicts if creating pages too quickly - Title-based parent search is less reliable than using UUIDs"
4908 },
4909 {
4910 "slug": "NOTION_DELETE_BLOCK",
4911 "name": "Delete a block",
4882 - "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."
4912 + "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."
4913 },
4914 {
4915 "slug": "NOTION_DUPLICATE_PAGE",
4916 "name": "Duplicate page",
4887 - "description": "Duplicates a notion page, including all its content, properties, and nested blocks, under a specified parent page or workspace."
4917 + "description": "Duplicates a Notion page, including all its content, properties, and nested blocks, under a specified parent page or workspace."
4918 + },
4919 + {
4920 + "slug": "NOTION_FETCH_ALL_BLOCK_CONTENTS",
4921 + "name": "Fetch All Notion Block Contents",
4922 + "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."
4923 },
4924 {
4925 "slug": "NOTION_FETCH_BLOCK_CONTENTS",
4926 "name": "Fetch Notion Block Children",
4892 - "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."
4927 + "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."
4928 },
4929 {
4930 "slug": "NOTION_FETCH_BLOCK_METADATA",
4931 "name": "Fetch Notion block metadata",
4897 - "description": "Fetches metadata for a notion block (or page, as pages are blocks) using its valid uuid; if the block has children, use fetch block contents to fetch their contents."
4932 + "description": "Fetches metadata for a Notion block (including pages, which are special blocks) using its UUID. Returns block type, properties, and basic info but not child content. Prerequisites: 1) Block/page must be shared with your integration, 2) Use valid block_id from API responses (not URLs). For child blocks, use fetch_block_contents instead. Common 404 errors mean the block isn't accessible to your integration."
4933 },
4934 {
4935 "slug": "NOTION_FETCH_COMMENTS",
4936 "name": "Fetch comments",
4902 - "description": "Fetches unresolved comments for a specified notion block or page id."
4937 + "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."
4938 },
4939 {
4940 "slug": "NOTION_FETCH_DATA",
4941 "name": "Fetch Notion Data",
4907 - "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"
4942 + "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"
4943 },
4944 {
4945 "slug": "NOTION_FETCH_DATABASE",
4946 "name": "Fetch Database",
4912 - "description": "Fetches a notion database's structural metadata (properties, title, etc.) via its `database id`, not the data entries; `database id` must reference an existing database."
4947 + "description": "Fetches a Notion database's structural metadata (properties, title, etc.) via its `database_id`, not the data entries; `database_id` must reference an existing database."
4948 },
4949 {
4950 "slug": "NOTION_FETCH_ROW",
4951 "name": "Fetch database row",
4917 - "description": "Retrieves a notion database row's properties and metadata; use fetch block contents for page content blocks."
4952 + "description": "Retrieves a Notion database row's properties and metadata; use fetch_block_contents for page content blocks."
4953 },
4954 {
4955 "slug": "NOTION_GET_ABOUT_ME",
4956 "name": "Get About Me",
4922 - "description": "Retrieves the user object for the bot associated with the current notion integration token, typically to obtain the bot's user id for other api operations."
4957 + "description": "Retrieves the User object for the bot associated with the current Notion integration token, typically to obtain the bot's user ID for other API operations."
4958 },
4959 {
4960 "slug": "NOTION_GET_ABOUT_USER",
4961 "name": "Get about user",
4927 - "description": "Retrieves detailed information about a specific notion user, such as their name, avatar, and email, based on their unique user id."
4962 + "description": "Retrieves detailed information about a specific Notion user, such as their name, avatar, and email, based on their unique user ID."
4963 },
4964 {
4965 "slug": "NOTION_GET_PAGE_PROPERTY_ACTION",

This file is too large to show in full.

docs/scripts/generate-toolkits.ts
+2 -2
@@ -123,7 +123,7 @@ async function fetchToolkitChangelog(): Promise<Map<string, string>> {
123 }
124
125 async function fetchToolsForToolkit(slug: string): Promise<Tool[]> {
126 - const response = await fetch(`${API_BASE}/tools?toolkit_slug=${slug}&limit=1000`, {
126 + const response = await fetch(`${API_BASE}/tools?toolkit_slug=${slug}&toolkit_versions=latest&limit=1000`, {
127 headers: {
128 'Content-Type': 'application/json',
129 'x-api-key': API_KEY!,
@@ -144,7 +144,7 @@ async function fetchToolsForToolkit(slug: string): Promise<Tool[]> {
144 }
145
146 async function fetchTriggersForToolkit(slug: string): Promise<Trigger[]> {
147 - const response = await fetch(`${API_BASE}/triggers_types?toolkit_slugs=${slug}`, {
147 + const response = await fetch(`${API_BASE}/triggers_types?toolkit_slugs=${slug}&toolkit_versions=latest`, {
148 headers: {
149 'Content-Type': 'application/json',
150 'x-api-key': API_KEY!,