Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Add toolkits section with static data architecture
- Create landing page with search, category filters, and alphabetical grouping - Add toolkit detail page with tools/triggers list and copy functionality - Implement static JSON architecture (single toolkits.json file) - Add generator script for fetching toolkit data from API - Create premium tools info page - Extract shared Toolkit types to types/toolkit.ts 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sushmithamallesh committed
Jan 2, 2026 at 17:11 UTC
ef6e45480fa914580fd58f1700e72bbfa158ef0a
16 files changed
+100559
-41
fumadocs/.claude/TOOLKITS_PLAN.md
new
+198
@@ -0,0 +1,198 @@
1
+# Toolkits Page - Implementation Plan
2
+
3
+## Decisions Made
4
+
5
+### No Sidebar
6
+- Toolkits section has no sidebar navigation
7
+- Only breadcrumb navigation (`← Back to Toolkits`)
8
+- Keeps UI clean, avoids 855 items in sidebar
9
+
10
+### No Input Parameters on Toolkit Pages
11
+- Users don't need param schemas in docs
12
+- LLMs read schemas automatically
13
+- Platform playground is better for exploring params
14
+
15
+### No Scopes Display
16
+- We only have scope names, not descriptions
17
+- Raw scope strings aren't useful to users
18
+- Just show auth method badge (OAuth2, API_KEY, etc.)
19
+
20
+### Search-First Experience
21
+- Landing page shows search + category filter + cards
22
+- Don't render all 855 cards upfront
23
+- Filter client-side from pre-generated JSON
24
+
25
+### Build-Time Generation
26
+- `bun run generate:toolkits` - separate command
27
+- Not run on `bun run dev` (too slow)
28
+- Run on CI push
29
+- JSON files committed to git (works offline)
30
+
31
+---
32
+
33
+## URL Structure
34
+
35
+```
36
+/toolkits → Landing page (search + filter + cards)
37
+/toolkits/premium-tools → Premium tools pricing/limits info
38
+/toolkits/{slug} → Individual toolkit page
39
+```
40
+
41
+---
42
+
43
+## Landing Page (`/toolkits`)
44
+
45
+```
46
+┌─────────────────────────────────────────────────────────────┐
47
+│ Toolkits [Request Tools →] │
48
+│ All the toolkits that we support. │
49
+│ │
50
+│ 🔍 Search toolkits... │
51
+│ │
52
+│ [All] [Communication] [Developer Tools] [CRM] [Storage]... │
53
+│ │
54
+│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
55
+│ │ Gmail │ │ Slack │ │ GitHub │ │
56
+│ │ GMAIL │ │ SLACK │ │ GITHUB │ │
57
+│ │ desc... │ │ desc... │ │ desc... │ │
58
+│ │[OAUTH2] │ │[OAUTH2] │ │[OAUTH2] │ │
59
+│ │ 🔧37 ⚡2 │ │ 🔧130 ⚡9│ │ 🔧829 ⚡6│ │
60
+│ └─────────┘ └─────────┘ └─────────┘ │
61
+│ │
62
+│ ⭐ Some tools are premium. [Learn about pricing →] │
63
+└─────────────────────────────────────────────────────────────┘
64
+```
65
+
66
+---
67
+
68
+## Individual Toolkit Page (`/toolkits/{slug}`)
69
+
70
+```
71
+┌─────────────────────────────────────────────────────────────┐
72
+│ ← Back to Toolkits │
73
+│ │
74
+│ [Logo] Gmail [Open in Platform →] │
75
+│ GMAIL (copy) │
76
+│ Gmail is Google's email service... │
77
+│ │
78
+│ [OAuth2] 37 Tools 2 Triggers Communication │
79
+├─────────────────────────────────────────────────────────────┤
80
+│ ## Authentication │
81
+│ This toolkit uses OAuth2. │
82
+│ [Create Auth Config →] [How authentication works →] │
83
+├─────────────────────────────────────────────────────────────┤
84
+│ ## Tools │
85
+│ 🔍 Search tools... │
86
+│ │
87
+│ | Name | Description │
88
+│ |-------------------|---------------------------------------|
89
+│ | Send email | Sends an email message to... │
90
+│ | Create draft | Creates a draft email... │
91
+├─────────────────────────────────────────────────────────────┤
92
+│ ## Triggers (only if count > 0) │
93
+│ | Name | Description │
94
+│ |-------------------|---------------------------------------|
95
+│ | New email | Fires when a new email arrives... │
96
+└─────────────────────────────────────────────────────────────┘
97
+```
98
+
99
+---
100
+
101
+## Data & Generation
102
+
103
+### Single File Architecture
104
+
105
+All toolkit data (including tools and triggers) is stored in a **single JSON file**:
106
+
107
+```
108
+/public/data/toolkits.json → All toolkits with tools & triggers (~5-10MB)
109
+```
110
+
111
+### Why Single File?
112
+
113
+- **Fully static** - No API calls at runtime, fast and reliable
114
+- **No repo bloat** - One file instead of 800+ individual files
115
+- **Git-friendly** - Git compresses JSON well
116
+- **Simple** - Easy to understand and maintain
117
+- **Open source friendly** - Public data, no secrets
118
+
119
+### Generator Script
120
+`scripts/generate-toolkits.ts`
121
+
122
+Run: `bun run generate:toolkits`
123
+
124
+### JSON Structure
125
+
126
+```json
127
+// toolkits.json
128
+[
129
+ {
130
+ "slug": "gmail",
131
+ "name": "Gmail",
132
+ "logo": "https://...",
133
+ "description": "Gmail is Google's...",
134
+ "category": "Communication",
135
+ "authSchemes": ["OAUTH2"],
136
+ "toolCount": 37,
137
+ "triggerCount": 2,
138
+ "version": "20260102_00",
139
+ "tools": [
140
+ { "slug": "GMAIL_SEND_EMAIL", "name": "Send email", "description": "..." }
141
+ ],
142
+ "triggers": [
143
+ { "slug": "GMAIL_NEW_EMAIL", "name": "New email", "description": "..." }
144
+ ]
145
+ }
146
+]
147
+```
148
+
149
+---
150
+
151
+## Scripts
152
+
153
+```json
154
+{
155
+ "scripts": {
156
+ "dev": "next dev",
157
+ "build": "next build",
158
+ "generate:toolkits": "bun scripts/generate-toolkits.ts"
159
+ }
160
+}
161
+```
162
+
163
+| Command | Regenerates? | Use case |
164
+|---------|--------------|----------|
165
+| `bun run dev` | ❌ | Local dev |
166
+| `bun run build` | ❌ | Fast build |
167
+| `bun run generate:toolkits` | ✅ | Manual |
168
+| CI push | ✅ | Auto regenerate |
169
+
170
+---
171
+
172
+## Components to Build
173
+
174
+1. `ToolkitSearch` - Search input
175
+2. `CategoryFilter` - Filter chips
176
+3. `ToolkitCard` - Individual card
177
+4. `ToolkitGrid` - Cards container
178
+5. `ToolsTable` - Searchable tools table
179
+6. `Breadcrumb` - Navigation
180
+
181
+---
182
+
183
+## Implementation Order
184
+
185
+1. [x] Generator script (`scripts/generate-toolkits.ts`)
186
+2. [x] Landing page + components (category grouping, alphabet sections)
187
+3. [x] Individual toolkit page (version display, auth badges, tool/trigger list with copy)
188
+4. [x] Premium tools page (`/toolkits/premium-tools`)
189
+5. [x] Hybrid architecture (static index + server-side API fetch)
190
+6. [ ] Polish/styling
191
+7. [ ] CI hooks for auto-regeneration
192
+
193
+---
194
+
195
+## Future: CI Hooks
196
+
197
+- Trigger docs regeneration from toolkit repo changes
198
+- Trigger docs regeneration from API repo changes
fumadocs/.env.example
+4
-2
@@ -1,4 +1,6 @@
1
+# Composio API Configuration
2
+COMPOSIO_API_KEY=your_api_key_here
3
+COMPOSIO_API_BASE=https://backend.composio.dev/api/v3
4
+
5
# OpenAPI Spec URL for API Reference
2
-# Production: https://backend.composio.dev/api/v3/openapi.json
3
-# Staging: https://staging-backend.composio.dev/api/v3/openapi.json (update with your staging URL)
6
OPENAPI_SPEC_URL=https://backend.composio.dev/api/v3/openapi.json
fumadocs/app/(home)/toolkits/[[...slug]]/page.tsx
+98
-4
@@ -1,6 +1,100 @@
1
import { toolkitsSource } from '@/lib/source';
2
-import { createDocsPage, createGenerateStaticParams, createGenerateMetadata } from '@/lib/create-docs-page';
2
+import { notFound } from 'next/navigation';
3
+import { getMDXComponents } from '@/mdx-components';
4
+import { ToolkitDetail } from '@/components/toolkits/toolkit-detail';
5
+import { readFile } from 'fs/promises';
6
+import { join } from 'path';
7
+import type { Metadata } from 'next';
8
+import type { Toolkit } from '@/types/toolkit';
9
4
-export default createDocsPage(toolkitsSource);
5
-export const generateStaticParams = createGenerateStaticParams(toolkitsSource);
6
-export const generateMetadata = createGenerateMetadata(toolkitsSource);
10
+async function getToolkits(): Promise<Toolkit[]> {
11
+ try {
12
+ const filePath = join(process.cwd(), 'public/data/toolkits.json');
13
+ const data = await readFile(filePath, 'utf-8');
14
+ return JSON.parse(data);
15
+ } catch {
16
+ return [];
17
+ }
18
+}
19
+
20
+export async function generateStaticParams() {
21
+ // MDX pages
22
+ const mdxParams = toolkitsSource.generateParams();
23
+
24
+ // JSON toolkit pages
25
+ const toolkits = await getToolkits();
26
+ const jsonParams = toolkits.map((toolkit) => ({
27
+ slug: [toolkit.slug],
28
+ }));
29
+
30
+ return [...mdxParams, ...jsonParams];
31
+}
32
+
33
+export async function generateMetadata({ params }: { params: Promise<{ slug?: string[] }> }): Promise<Metadata> {
34
+ const { slug } = await params;
35
+
36
+ // Index page
37
+ if (!slug || slug.length === 0) {
38
+ return {
39
+ title: 'Toolkits',
40
+ description: 'Browse all toolkits supported by Composio',
41
+ };
42
+ }
43
+
44
+ // Check MDX first
45
+ const page = toolkitsSource.getPage(slug);
46
+ if (page) {
47
+ return {
48
+ title: page.data.title,
49
+ description: page.data.description,
50
+ };
51
+ }
52
+
53
+ // Check JSON toolkit
54
+ if (slug.length === 1) {
55
+ const toolkits = await getToolkits();
56
+ const toolkit = toolkits.find((t) => t.slug === slug[0]);
57
+ if (toolkit) {
58
+ return {
59
+ title: `${toolkit.name.trim()} - Composio Toolkit`,
60
+ description: toolkit.description,
61
+ };
62
+ }
63
+ }
64
+
65
+ return { title: 'Toolkit Not Found' };
66
+}
67
+
68
+export default async function ToolkitsPage({ params }: { params: Promise<{ slug?: string[] }> }) {
69
+ const { slug } = await params;
70
+
71
+ // Check MDX first
72
+ const page = toolkitsSource.getPage(slug);
73
+ if (page) {
74
+ const MDXContent = page.data.body;
75
+ return (
76
+ <article className="prose prose-fd max-w-none">
77
+ <MDXContent components={getMDXComponents()} />
78
+ </article>
79
+ );
80
+ }
81
+
82
+ // Check JSON toolkit
83
+ if (slug?.length === 1) {
84
+ const toolkitSlug = slug[0];
85
+ const toolkits = await getToolkits();
86
+ const toolkit = toolkits.find((t) => t.slug === toolkitSlug);
87
+
88
+ if (toolkit) {
89
+ return (
90
+ <ToolkitDetail
91
+ toolkit={toolkit}
92
+ tools={toolkit.tools}
93
+ triggers={toolkit.triggers}
94
+ />
95
+ );
96
+ }
97
+ }
98
+
99
+ notFound();
100
+}
fumadocs/app/(home)/toolkits/layout.tsx
+10
-3
@@ -1,4 +1,11 @@
1
-import { toolkitsSource } from '@/lib/source';
2
-import { createDocsLayout } from '@/lib/create-docs-layout';
1
+import type { ReactNode } from 'react';
2
4
-export default createDocsLayout(toolkitsSource);
3
+export default function ToolkitsLayout({ children }: { children: ReactNode }) {
4
+ return (
5
+ <main className="min-h-screen">
6
+ <div className="mx-auto max-w-6xl px-4 py-12 sm:px-6 lg:px-8">
7
+ {children}
8
+ </div>
9
+ </main>
10
+ );
11
+}
fumadocs/components/toolkits/toolkit-detail.tsx
new
+266
@@ -0,0 +1,266 @@
1
+'use client';
2
+
3
+import { useState, useMemo } from 'react';
4
+import Link from 'next/link';
5
+import { ExternalLink, Search, Copy, Check, ChevronDown, ChevronRight, ArrowLeft } from 'lucide-react';
6
+import type { Toolkit, Tool, Trigger } from '@/types/toolkit';
7
+
8
+interface ToolkitDetailProps {
9
+ toolkit: Toolkit;
10
+ tools: Tool[];
11
+ triggers: Trigger[];
12
+}
13
+
14
+function ToolkitIcon({ toolkit }: { toolkit: Toolkit }) {
15
+ return (
16
+ <div
17
+ className="flex h-16 w-16 shrink-0 items-center justify-center rounded-xl border border-fd-border bg-fd-card bg-center bg-no-repeat text-xl font-semibold text-fd-muted-foreground shadow-sm"
18
+ style={toolkit.logo ? {
19
+ backgroundImage: `url(${toolkit.logo})`,
20
+ backgroundSize: '60%',
21
+ } : undefined}
22
+ >
23
+ {!toolkit.logo && toolkit.name.trim().charAt(0).toUpperCase()}
24
+ </div>
25
+ );
26
+}
27
+
28
+function ToolItem({ item }: { item: Tool | Trigger }) {
29
+ const [expanded, setExpanded] = useState(false);
30
+ const [copied, setCopied] = useState(false);
31
+
32
+ const copySlug = (e: React.MouseEvent) => {
33
+ e.stopPropagation();
34
+ navigator.clipboard.writeText(item.slug);
35
+ setCopied(true);
36
+ setTimeout(() => setCopied(false), 2000);
37
+ };
38
+
39
+ return (
40
+ <div className="border-b border-fd-border/50 last:border-0">
41
+ <button
42
+ onClick={() => setExpanded(!expanded)}
43
+ className="group flex w-full items-center gap-2 px-4 py-2.5 text-left transition-colors hover:bg-fd-accent/30"
44
+ >
45
+ <span className="shrink-0 text-fd-muted-foreground">
46
+ {expanded ? <ChevronDown className="h-4 w-4" /> : <ChevronRight className="h-4 w-4" />}
47
+ </span>
48
+ <span className="flex flex-1 items-center justify-between gap-2">
49
+ <span className="text-sm font-medium text-fd-foreground">{item.name}</span>
50
+ <span
51
+ role="button"
52
+ onClick={copySlug}
53
+ className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
54
+ >
55
+ {item.slug}
56
+ {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
57
+ </span>
58
+ </span>
59
+ </button>
60
+ {expanded && (
61
+ <div className="bg-fd-muted/20 px-4 py-3 pl-10">
62
+ <p className="text-sm text-fd-muted-foreground">{item.description}</p>
63
+ </div>
64
+ )}
65
+ </div>
66
+ );
67
+}
68
+
69
+export function ToolkitDetail({ toolkit, tools, triggers }: ToolkitDetailProps) {
70
+ const [copied, setCopied] = useState(false);
71
+ const [versionCopied, setVersionCopied] = useState(false);
72
+ const [toolSearch, setToolSearch] = useState('');
73
+ const [activeTab, setActiveTab] = useState<'tools' | 'triggers'>('tools');
74
+
75
+ const filteredTools = useMemo(() => {
76
+ if (!toolSearch) return tools;
77
+ const search = toolSearch.toLowerCase();
78
+ return tools.filter(
79
+ (tool) =>
80
+ tool.name.toLowerCase().includes(search) ||
81
+ tool.slug.toLowerCase().includes(search) ||
82
+ tool.description.toLowerCase().includes(search)
83
+ );
84
+ }, [tools, toolSearch]);
85
+
86
+ const filteredTriggers = useMemo(() => {
87
+ if (!toolSearch) return triggers;
88
+ const search = toolSearch.toLowerCase();
89
+ return triggers.filter(
90
+ (trigger) =>
91
+ trigger.name.toLowerCase().includes(search) ||
92
+ trigger.slug.toLowerCase().includes(search) ||
93
+ trigger.description.toLowerCase().includes(search)
94
+ );
95
+ }, [triggers, toolSearch]);
96
+
97
+ const copySlug = () => {
98
+ navigator.clipboard.writeText(toolkit.slug.toUpperCase());
99
+ setCopied(true);
100
+ setTimeout(() => setCopied(false), 2000);
101
+ };
102
+
103
+ const copyVersion = () => {
104
+ if (toolkit.version) {
105
+ navigator.clipboard.writeText(toolkit.version);
106
+ setVersionCopied(true);
107
+ setTimeout(() => setVersionCopied(false), 2000);
108
+ }
109
+ };
110
+
111
+ return (
112
+ <div className="space-y-5 sm:space-y-8">
113
+ {/* Back navigation */}
114
+ <Link
115
+ href="/toolkits"
116
+ className="inline-flex items-center gap-1.5 text-sm text-fd-muted-foreground transition-colors hover:text-fd-foreground"
117
+ >
118
+ <ArrowLeft className="h-4 w-4" />
119
+ All Toolkits
120
+ </Link>
121
+
122
+ {/* Header */}
123
+ <div className="flex gap-4">
124
+ <ToolkitIcon toolkit={toolkit} />
125
+ <div className="min-w-0 flex-1">
126
+ {/* Title row */}
127
+ <div className="flex flex-wrap items-center justify-between gap-2">
128
+ <div className="flex flex-wrap items-center gap-2">
129
+ <h1 className="text-xl font-bold tracking-tight text-fd-foreground">{toolkit.name.trim()}</h1>
130
+ <button
131
+ onClick={copySlug}
132
+ className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
133
+ >
134
+ {toolkit.slug.toUpperCase()}
135
+ {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
136
+ </button>
137
+ </div>
138
+ {toolkit.version && (
139
+ <div className="flex items-center gap-2 text-sm text-fd-muted-foreground">
140
+ <span>Latest version</span>
141
+ <button
142
+ onClick={copyVersion}
143
+ className="inline-flex items-center gap-1 rounded border border-orange-500/30 bg-orange-500/10 px-1.5 py-0.5 font-mono text-xs text-orange-600 transition-colors hover:bg-orange-500/20 dark:text-orange-400"
144
+ >
145
+ {toolkit.version}
146
+ {versionCopied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
147
+ </button>
148
+ </div>
149
+ )}
150
+ </div>
151
+
152
+ {/* Description */}
153
+ <p className="mt-1.5 text-sm text-fd-muted-foreground">{toolkit.description}</p>
154
+
155
+ {/* Actions */}
156
+ <div className="mt-4 flex flex-wrap items-center justify-between gap-2">
157
+ <div className="flex flex-wrap items-center gap-2">
158
+ <Link
159
+ href={`https://platform.composio.dev/auth?next_page=${encodeURIComponent(`/tool-router?toolkits=${toolkit.slug}`)}`}
160
+ target="_blank"
161
+ className="inline-flex items-center gap-1.5 rounded-md bg-orange-500 px-3 py-1.5 text-sm font-medium text-white transition-colors hover:bg-orange-600"
162
+ >
163
+ Try {toolkit.name.trim()}
164
+ <ExternalLink className="h-3.5 w-3.5" />
165
+ </Link>
166
+ <Link
167
+ href="/docs/authenticating-tools"
168
+ className="inline-flex items-center gap-1.5 rounded-md border border-fd-border bg-fd-background px-3 py-1.5 text-sm font-medium text-fd-foreground transition-colors hover:bg-fd-accent"
169
+ >
170
+ Authentication guide
171
+ </Link>
172
+ </div>
173
+ {toolkit.authSchemes.length > 0 && (
174
+ <div className="flex items-center gap-1.5 text-sm text-fd-muted-foreground">
175
+ <span>Auth:</span>
176
+ {toolkit.authSchemes.map((scheme, index) => (
177
+ <span
178
+ key={`${scheme}-${index}`}
179
+ className="rounded bg-fd-muted px-1.5 py-0.5 text-xs text-fd-foreground"
180
+ >
181
+ {scheme}
182
+ </span>
183
+ ))}
184
+ </div>
185
+ )}
186
+ </div>
187
+ </div>
188
+ </div>
189
+
190
+ {/* Tools & Triggers */}
191
+ {(tools.length > 0 || triggers.length > 0) && (
192
+ <div className="space-y-4">
193
+ {/* Tabs */}
194
+ <div className="flex items-center gap-6 border-b border-fd-border">
195
+ <button
196
+ onClick={() => setActiveTab('tools')}
197
+ className={`relative pb-2.5 text-sm font-medium transition-colors ${
198
+ activeTab === 'tools'
199
+ ? 'text-fd-foreground'
200
+ : 'text-fd-muted-foreground hover:text-fd-foreground'
201
+ }`}
202
+ >
203
+ Tools ({tools.length})
204
+ {activeTab === 'tools' && (
205
+ <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-orange-500" />
206
+ )}
207
+ </button>
208
+ {triggers.length > 0 && (
209
+ <button
210
+ onClick={() => setActiveTab('triggers')}
211
+ className={`relative pb-2.5 text-sm font-medium transition-colors ${
212
+ activeTab === 'triggers'
213
+ ? 'text-fd-foreground'
214
+ : 'text-fd-muted-foreground hover:text-fd-foreground'
215
+ }`}
216
+ >
217
+ Triggers ({triggers.length})
218
+ {activeTab === 'triggers' && (
219
+ <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-orange-500" />
220
+ )}
221
+ </button>
222
+ )}
223
+ </div>
224
+
225
+ {/* Search */}
226
+ <div className="relative">
227
+ <Search className="absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-fd-muted-foreground" />
228
+ <input
229
+ type="text"
230
+ placeholder={`Search ${activeTab}...`}
231
+ value={toolSearch}
232
+ onChange={(e) => setToolSearch(e.target.value)}
233
+ className="h-9 w-full rounded-md border border-fd-border bg-fd-background pl-9 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:border-fd-primary focus:outline-none focus:ring-1 focus:ring-fd-primary"
234
+ />
235
+ </div>
236
+
237
+ {/* List */}
238
+ <div className="overflow-hidden rounded-md border border-fd-border">
239
+ {activeTab === 'tools' && (
240
+ filteredTools.length > 0 ? (
241
+ filteredTools.map((tool) => (
242
+ <ToolItem key={tool.slug} item={tool} />
243
+ ))
244
+ ) : (
245
+ <p className="px-4 py-8 text-center text-sm text-fd-muted-foreground">
246
+ No tools found
247
+ </p>
248
+ )
249
+ )}
250
+ {activeTab === 'triggers' && (
251
+ filteredTriggers.length > 0 ? (
252
+ filteredTriggers.map((trigger) => (
253
+ <ToolItem key={trigger.slug} item={trigger} />
254
+ ))
255
+ ) : (
256
+ <p className="px-4 py-8 text-center text-sm text-fd-muted-foreground">
257
+ No triggers found
258
+ </p>
259
+ )
260
+ )}
261
+ </div>
262
+ </div>
263
+ )}
264
+ </div>
265
+ );
266
+}
fumadocs/components/toolkits/toolkits-landing.tsx
new
+220
@@ -0,0 +1,220 @@
1
+'use client';
2
+
3
+import { useState, useMemo } from 'react';
4
+import Link from 'next/link';
5
+import { Search, ChevronDown, Sparkles, ArrowRight, Wrench, Zap, Copy, Check } from 'lucide-react';
6
+import toolkitsData from '@/public/data/toolkits.json';
7
+import type { Toolkit } from '@/types/toolkit';
8
+
9
+const toolkits = toolkitsData as Toolkit[];
10
+
11
+// Get unique categories
12
+const categories = Array.from(
13
+ new Set(toolkits.map((t) => t.category).filter(Boolean))
14
+).sort() as string[];
15
+
16
+function ToolkitIcon({ toolkit }: { toolkit: Toolkit }) {
17
+ return (
18
+ <div
19
+ className="flex h-9 w-9 shrink-0 items-center justify-center rounded-lg border border-fd-border/50 bg-fd-background bg-center bg-no-repeat text-sm font-medium text-fd-muted-foreground sm:h-10 sm:w-10"
20
+ style={toolkit.logo ? {
21
+ backgroundImage: `url(${toolkit.logo})`,
22
+ backgroundSize: '65%',
23
+ } : undefined}
24
+ >
25
+ {!toolkit.logo && toolkit.name.trim().charAt(0).toUpperCase()}
26
+ </div>
27
+ );
28
+}
29
+
30
+function CopySlugButton({ slug }: { slug: string }) {
31
+ const [copied, setCopied] = useState(false);
32
+
33
+ const handleCopy = (e: React.MouseEvent) => {
34
+ e.preventDefault();
35
+ navigator.clipboard.writeText(slug.toUpperCase());
36
+ setCopied(true);
37
+ setTimeout(() => setCopied(false), 2000);
38
+ };
39
+
40
+ return (
41
+ <button
42
+ onClick={handleCopy}
43
+ className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
44
+ >
45
+ <span className="max-w-[120px] truncate sm:max-w-none">{slug.toUpperCase()}</span>
46
+ {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
47
+ </button>
48
+ );
49
+}
50
+
51
+export function ToolkitsLanding() {
52
+ const [search, setSearch] = useState('');
53
+ const [category, setCategory] = useState<string>('all');
54
+
55
+ const filteredToolkits = useMemo(() => {
56
+ let result = toolkits;
57
+
58
+ // Filter by category
59
+ if (category !== 'all') {
60
+ result = result.filter((t) => t.category === category);
61
+ }
62
+
63
+ // Filter by search
64
+ if (search) {
65
+ const searchLower = search.toLowerCase();
66
+ result = result.filter(
67
+ (toolkit) =>
68
+ toolkit.name.toLowerCase().includes(searchLower) ||
69
+ toolkit.slug.toLowerCase().includes(searchLower) ||
70
+ toolkit.description.toLowerCase().includes(searchLower)
71
+ );
72
+ }
73
+
74
+ return result;
75
+ }, [search, category]);
76
+
77
+ // Group by first letter (numbers at end)
78
+ const groupedToolkits = useMemo(() => {
79
+ const groups: Record<string, Toolkit[]> = {};
80
+
81
+ // First sort all toolkits alphabetically (trim to handle leading spaces)
82
+ const sorted = [...filteredToolkits].sort((a, b) =>
83
+ a.name.trim().localeCompare(b.name.trim())
84
+ );
85
+
86
+ sorted.forEach((toolkit) => {
87
+ const firstChar = toolkit.name.trim().charAt(0).toUpperCase();
88
+ // Group all numbers under '#'
89
+ const letter = /[0-9]/.test(firstChar) ? '#' : firstChar;
90
+ if (!groups[letter]) {
91
+ groups[letter] = [];
92
+ }
93
+ groups[letter].push(toolkit);
94
+ });
95
+
96
+ // Sort groups with letters first (A-Z), then # (numbers) at end
97
+ return Object.entries(groups).sort(([a], [b]) => {
98
+ if (a === '#') return 1;
99
+ if (b === '#') return -1;
100
+ return a.localeCompare(b);
101
+ });
102
+ }, [filteredToolkits]);
103
+
104
+ return (
105
+ <div className="space-y-5 sm:space-y-8">
106
+ {/* Header */}
107
+ <div>
108
+ <h1 className="text-2xl font-bold text-fd-foreground sm:text-3xl">Toolkits</h1>
109
+ <p className="mt-1.5 text-sm text-fd-muted-foreground sm:mt-2 sm:text-base">
110
+ Browse {toolkits.length} toolkits supported by Composio
111
+ </p>
112
+ </div>
113
+
114
+ {/* Premium Tools Card */}
115
+ <Link
116
+ href="/toolkits/premium-tools"
117
+ className="group flex items-center justify-between gap-3 rounded-md border border-orange-500/30 bg-orange-500/5 px-3 py-2.5 transition-all hover:border-orange-500/50 hover:bg-orange-500/10"
118
+ >
119
+ <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
120
+ <Sparkles className="h-4 w-4 shrink-0 text-orange-500" />
121
+ <span className="text-sm font-medium text-fd-foreground">Premium Tools</span>
122
+ <span className="hidden text-sm text-fd-muted-foreground sm:inline">— Learn about pricing and limits</span>
123
+ </div>
124
+ <ArrowRight className="h-4 w-4 shrink-0 text-fd-muted-foreground transition-transform group-hover:translate-x-1 group-hover:text-orange-500" />
125
+ </Link>
126
+
127
+ {/* Filters */}
128
+ <div className="flex flex-col gap-3 sm:flex-row sm:items-center">
129
+ {/* Search */}
130
+ <div className="relative flex-1">
131
+ <Search className="absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-fd-muted-foreground" />
132
+ <input
133
+ type="text"
134
+ placeholder="Search toolkits..."
135
+ value={search}
136
+ onChange={(e) => setSearch(e.target.value)}
137
+ className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:border-fd-primary focus:outline-none focus:ring-1 focus:ring-fd-primary"
138
+ />
139
+ </div>
140
+
141
+ {/* Category dropdown */}
142
+ <div className="relative w-full sm:w-auto">
143
+ <select
144
+ value={category}
145
+ onChange={(e) => setCategory(e.target.value)}
146
+ className="h-10 w-full appearance-none rounded-lg border border-fd-border bg-fd-background pl-4 pr-10 text-sm text-fd-foreground focus:border-fd-primary focus:outline-none focus:ring-1 focus:ring-fd-primary sm:w-auto"
147
+ >
148
+ <option value="all">All categories</option>
149
+ {categories.map((cat) => (
150
+ <option key={cat} value={cat}>
151
+ {cat.charAt(0).toUpperCase() + cat.slice(1)}
152
+ </option>
153
+ ))}
154
+ </select>
155
+ <ChevronDown className="pointer-events-none absolute right-3 top-1/2 h-4 w-4 -translate-y-1/2 text-fd-muted-foreground" />
156
+ </div>
157
+ </div>
158
+
159
+ {/* Results count */}
160
+ <p className="text-sm text-fd-muted-foreground">
161
+ {filteredToolkits.length} toolkit{filteredToolkits.length !== 1 ? 's' : ''}
162
+ {category !== 'all' && ` in ${category}`}
163
+ {search && ` matching "${search}"`}
164
+ </p>
165
+
166
+ {/* Alphabetically grouped list - table style */}
167
+ {groupedToolkits.length > 0 ? (
168
+ <div className="space-y-6">
169
+ {groupedToolkits.map(([letter, items]) => (
170
+ <div key={letter}>
171
+ <h2 className="mb-2 text-sm font-semibold text-fd-muted-foreground">{letter}</h2>
172
+ <div className="divide-y divide-fd-border">
173
+ {items.map((toolkit) => (
174
+ <Link
175
+ key={toolkit.slug}
176
+ href={`/toolkits/${toolkit.slug}`}
177
+ className="group flex flex-col gap-2 px-2 py-3 transition-colors hover:bg-fd-accent/30 sm:flex-row sm:items-center sm:justify-between sm:px-0 sm:py-2.5"
178
+ >
179
+ {/* Left side: Icon, Name, Slug */}
180
+ <div className="flex items-center gap-3">
181
+ <ToolkitIcon toolkit={toolkit} />
182
+ <div className="flex min-w-0 flex-1 flex-col gap-1 sm:flex-row sm:items-center sm:gap-3">
183
+ <span className="truncate text-sm font-medium text-fd-foreground">{toolkit.name.trim()}</span>
184
+ <CopySlugButton slug={toolkit.slug} />
185
+ </div>
186
+ </div>
187
+ {/* Right side: Counts */}
188
+ <div className="flex items-center gap-3 pl-12 text-xs text-fd-muted-foreground sm:pl-0">
189
+ <span className="flex items-center gap-1">
190
+ <Wrench className="h-3.5 w-3.5" />
191
+ {toolkit.toolCount}
192
+ </span>
193
+ <span className="flex items-center gap-1">
194
+ <Zap className="h-3.5 w-3.5" />
195
+ {toolkit.triggerCount}
196
+ </span>
197
+ </div>
198
+ </Link>
199
+ ))}
200
+ </div>
201
+ </div>
202
+ ))}
203
+ </div>
204
+ ) : (
205
+ <div className="py-12 text-center">
206
+ <p className="text-fd-muted-foreground">No toolkits found.</p>
207
+ <button
208
+ onClick={() => {
209
+ setSearch('');
210
+ setCategory('all');
211
+ }}
212
+ className="mt-2 text-sm text-fd-primary hover:underline"
213
+ >
214
+ Clear filters
215
+ </button>
216
+ </div>
217
+ )}
218
+ </div>
219
+ );
220
+}
fumadocs/content/tool-router/tools-and-toolkits.mdx
+1
-1
@@ -1,6 +1,6 @@
1
---
2
title: Tools and toolkits
3
-description: Access 800+ integrations through Tool Router
3
+description: Access 800+ toolkits through Tool Router
4
---
5
6
Tool Router gives your agent access to most Composio toolkits by default. For details on configuring which toolkits are available in a session, see [Users and sessions](/tool-router/users-and-sessions#enabling-toolkits).
fumadocs/content/toolkits/index.mdx
+2
-22
@@ -1,26 +1,6 @@
1
---
2
title: Toolkits
3
-description: Browse all available Composio toolkits and integrations
3
+description: Browse all toolkits supported by Composio
4
---
5
6
-Composio provides 250+ pre-built toolkits for popular services and APIs.
7
-
8
-## Featured Toolkits
9
-
10
-### Important
11
-
12
-- [GitHub](/toolkits/github) - Manage repositories, issues, and pull requests
13
-- [Gmail](/toolkits/gmail) - Send and manage emails
14
-- [Notion](/toolkits/notion) - Create and manage Notion pages
15
-
16
-### Scheduling & Booking
17
-
18
-- [Google Calendar](/toolkits/googlecalendar) - Manage calendar events
19
-
20
-### No Auth Required
21
-
22
-- [Composio](/toolkits/composio) - Core Composio tools
23
-
24
-## Browse All Toolkits
25
-
26
-Visit the [Composio Dashboard](https://app.composio.dev) to explore all available toolkits.
6
+<ToolkitsLanding />
fumadocs/content/toolkits/meta.json
deleted
-7
@@ -1,7 +0,0 @@
1
-{
2
- "title": "Toolkits",
3
- "pages": [
4
- "---Overview---",
5
- "index"
6
- ]
7
-}
fumadocs/content/toolkits/premium-tools.mdx
new
+59
@@ -0,0 +1,59 @@
1
+---
2
+title: Premium Tools
3
+description: Learn about premium tools, pricing, and limits in Composio
4
+---
5
+
6
+[← All Toolkits](/toolkits)
7
+
8
+# Premium Tools
9
+
10
+This is a quick overview of premium tools, what they are, how they are priced, what limits they have and such.
11
+
12
+## What are premium tools?
13
+
14
+Premium tools are essential tool calls that cost us more to run, normally paying for more premium services or longer running tasks.
15
+
16
+Think something like `E2B` or `Firecrawl`, these are not really comparable to a `GMAIL_SEND_EMAIL` call.
17
+
18
+These types of tools are separated out so we can price both of them competitively.
19
+
20
+This is the current list of premium tools, more will be added over time and this list might change in the future.
21
+
22
+- [Composio Search](/toolkits/composio_search)
23
+- [Code Interpreter (E2B)](/toolkits/codeinterpreter)
24
+- [Firecrawl](/toolkits/firecrawl)
25
+- [Perplexity](/toolkits/perplexityai)
26
+- [Exa](/toolkits/exa)
27
+- [SerpAPI](/toolkits/serpapi)
28
+
29
+## How are premium tools priced?
30
+
31
+As a rough guide, they are priced at 3x the cost of a standard tool call — the specifics depends on your plan and the tool.
32
+
33
+| Plan | Included Standard Tool Calls | Included Premium Tool Calls | Usage Based Standard Tool Calls | Usage Based Premium Tool Calls |
34
+|------|------------------------------|-----------------------------|---------------------------------|--------------------------------|
35
+| Totally Free | 20k | 1k | – | – |
36
+| Ridiculously Cheap | 250k | 5k | $0.299/1k | $0.897/1k |
37
+| Serious Business | 2M | 50k | $0.249/1k | $0.747/1k |
38
+| Enterprise | Flexible | Flexible | Flexible | Flexible |
39
+
40
+This is a quick call out — full pricing details are on the [pricing page](https://composio.dev/pricing).
41
+
42
+## What limits do premium tools have?
43
+
44
+Premium tools are also subject to lower rate limits than standard tool calls.
45
+
46
+If you need more than the default limits, please [contact us](mailto:billing@composio.dev) and we can find a workable solution.
47
+
48
+| Spending Tier | Standard Tool Calls Rate Limit | Premium Tool Calls Rate Limit |
49
+|---------------|--------------------------------|-------------------------------|
50
+| Free | 1,000/hour | 100/hour |
51
+| Ridiculously Cheap | 100,000/hour | 10,000/hour |
52
+| Serious Business | 100,000/hour | 10,000/hour |
53
+| Enterprise | Flexible | Flexible |
54
+
55
+## Feedback on premium tools
56
+
57
+These pricing changes are not rolling out immediately, and we are very open to feedback on the pricing and the limits.
58
+
59
+There is a lot of room for improvement and iteration here, please reach out if you have suggestions [here](mailto:rahul@composio.dev).
fumadocs/lib/source.ts
-1
@@ -43,7 +43,6 @@ export const toolkitsSource = loader({
43
plugins: [lucideIconsPlugin()],
44
});
45
46
-
46
export const changelogEntries = changelog;
47
48
export function getPageImage(page: InferPageType<typeof source>) {
fumadocs/mdx-components.tsx
+2
@@ -11,6 +11,7 @@ import { ProviderCard, ProviderGrid } from '@/components/provider-card';
11
import { Figure } from '@/components/figure';
12
import { Video } from '@/components/video';
13
import { CapabilityCard, CapabilityList } from '@/components/capability-card';
14
+import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
15
import { ShieldCheck, Route as RouteIcon } from 'lucide-react';
16
import {
17
Key,
@@ -46,6 +47,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
47
Video,
48
CapabilityCard,
49
CapabilityList,
50
+ ToolkitsLanding,
51
// Lucide icons - available globally in MDX without imports
52
ShieldCheck,
53
RouteIcon,
fumadocs/package.json
+2
-1
@@ -8,7 +8,8 @@
8
"start": "next start",
9
"types:check": "fumadocs-mdx && next typegen && tsc --noEmit",
10
"postinstall": "fumadocs-mdx",
11
- "lint": "eslint"
11
+ "lint": "eslint",
12
+ "generate:toolkits": "bun scripts/generate-toolkits.ts"
13
},
14
"dependencies": {
15
"@radix-ui/react-tabs": "^1.1.13",
fumadocs/public/data/toolkits.json
new
+99452
@@ -0,0 +1,99452 @@
1
+[
2
+ {
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",
7
+ "category": "collaboration & communication",
8
+ "authSchemes": [
9
+ "OAUTH2"
10
+ ],
11
+ "toolCount": 23,
12
+ "triggerCount": 2,
13
+ "version": "20260102_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)."
19
+ },
20
+ {
21
+ "slug": "GMAIL_CREATE_EMAIL_DRAFT",
22
+ "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."
24
+ },
25
+ {
26
+ "slug": "GMAIL_CREATE_LABEL",
27
+ "name": "Create label",
28
+ "description": "Creates a new label with a unique name in the specified user's gmail account."
29
+ },
30
+ {
31
+ "slug": "GMAIL_DELETE_DRAFT",
32
+ "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`."
34
+ },
35
+ {
36
+ "slug": "GMAIL_DELETE_MESSAGE",
37
+ "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."
39
+ },
40
+ {
41
+ "slug": "GMAIL_FETCH_EMAILS",
42
+ "name": "Fetch emails",
43
+ "description": "Fetches a list of email messages from a gmail account, supporting filtering, pagination, and optional full content retrieval."
44
+ },
45
+ {
46
+ "slug": "GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID",
47
+ "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`."
49
+ },
50
+ {
51
+ "slug": "GMAIL_FETCH_MESSAGE_BY_THREAD_ID",
52
+ "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`."
54
+ },
55
+ {
56
+ "slug": "GMAIL_GET_ATTACHMENT",
57
+ "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."
59
+ },
60
+ {
61
+ "slug": "GMAIL_GET_CONTACTS",
62
+ "name": "Get contacts",
63
+ "description": "Fetches contacts (connections) for the authenticated google account, allowing selection of specific data fields and pagination."
64
+ },
65
+ {
66
+ "slug": "GMAIL_GET_PEOPLE",
67
+ "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."
69
+ },
70
+ {
71
+ "slug": "GMAIL_GET_PROFILE",
72
+ "name": "Get Profile",
73
+ "description": "Retrieves key gmail profile information (email address, message/thread totals, history id) for a user."
74
+ },
75
+ {
76
+ "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."
79
+ },
80
+ {
81
+ "slug": "GMAIL_LIST_LABELS",
82
+ "name": "List Gmail labels",
83
+ "description": "Retrieves a list of all system and user-created labels for the specified gmail account."
84
+ },
85
+ {
86
+ "slug": "GMAIL_LIST_THREADS",
87
+ "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."
89
+ },
90
+ {
91
+ "slug": "GMAIL_MODIFY_THREAD_LABELS",
92
+ "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."
94
+ },
95
+ {
96
+ "slug": "GMAIL_MOVE_TO_TRASH",
97
+ "name": "Move to Trash",
98
+ "description": "Moves an existing, non-deleted email message to the trash for the specified user."
99
+ },
100
+ {
101
+ "slug": "GMAIL_PATCH_LABEL",
102
+ "name": "Patch Label",
103
+ "description": "Patches the specified label."
104
+ },
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
+ },
110
+ {
111
+ "slug": "GMAIL_REPLY_TO_THREAD",
112
+ "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`."
114
+ },
115
+ {
116
+ "slug": "GMAIL_SEARCH_PEOPLE",
117
+ "name": "Search People",
118
+ "description": "Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'other contacts'."
119
+ },
120
+ {
121
+ "slug": "GMAIL_SEND_DRAFT",
122
+ "name": "Send Draft",
123
+ "description": "Sends the specified, existing draft to the recipients in the to, cc, and bcc headers."
124
+ },
125
+ {
126
+ "slug": "GMAIL_SEND_EMAIL",
127
+ "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."
129
+ }
130
+ ],
131
+ "triggers": [
132
+ {
133
+ "slug": "GMAIL_EMAIL_SENT_TRIGGER",
134
+ "name": "Email Sent",
135
+ "description": "Triggers when a Gmail message is sent by the authenticated user. It polls the\n 'SENT' label and emits metadata including sender, recipients, subject, timestamp,\n and thread ID."
136
+ },
137
+ {
138
+ "slug": "GMAIL_NEW_GMAIL_MESSAGE",
139
+ "name": "New Gmail Message Received Trigger",
140
+ "description": "Triggers when a new message is received in Gmail."
141
+ }
142
+ ]
143
+ },
144
+ {
145
+ "slug": "composio",
146
+ "name": "Composio",
147
+ "logo": "https://logos.composio.dev/api/composio",
148
+ "description": "Composio enables AI Agents and LLMs to authenticate and integrate with various tools via function calling.",
149
+ "category": "ai & machine learning",
150
+ "authSchemes": [
151
+ "NO_AUTH"
152
+ ],
153
+ "toolCount": 29,
154
+ "triggerCount": 0,
155
+ "version": "20251208_01",
156
+ "tools": [
157
+ {
158
+ "slug": "COMPOSIO_ASK_ORACLE",
159
+ "name": "Ask Oracle",
160
+ "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"
161
+ },
162
+ {
163
+ "slug": "COMPOSIO_CHECK_ACTIVE_CONNECTION",
164
+ "name": "Check active connection (deprecated)",
165
+ "description": "Deprecated: use check active connections instead for bulk operations. check active connection status for a toolkit or specific connected account id. returns connection details if active, or required parameters for establishing connection if none exists. active connections enable agent actions on the toolkit."
166
+ },
167
+ {
168
+ "slug": "COMPOSIO_CHECK_ACTIVE_CONNECTIONS",
169
+ "name": "Check multiple active connections",
170
+ "description": "Check active connection status for multiple toolkits or specific connected account ids. returns connection details if active, or required parameters for establishing connection if none exists. active connections enable agent actions on toolkits."
171
+ },
172
+ {
173
+ "slug": "COMPOSIO_CREATE_PLAN",
174
+ "name": "Create Plan",
175
+ "description": "\nThis is a workflow builder that ensures the LLM produces a complete, step-by-step plan for any use case.\nWHEN TO CALL:\n- Call this tool based on COMPOSIO_SEARCH_TOOLS output. If search tools response indicates create_plan should be called and the usecase is not easy, call it.\n- Use this tool after COMPOSIO_SEARCH_TOOLS or COMPOSIO_MANAGE_CONNECTIONS to generate an execution plan for the user's use case.\n- USE for medium or hard tasks — skip it for easy ones.\n- If the user switches to a new use case in the same chat and COMPOSIO_SEARCH_TOOLS again instructs you to call the planner, you MUST call this tool again for that new use case.\n\nMemory Integration:\n- You can choose to add the memory received from the search tool into the known_fields parameter of the plan function to enhance planning with discovered relationships and information.\n\nOutputs a complete plan with sections such as \"workflow_steps\", \"complexity_assessment\", \"decision_matrix\", \"failure_handling\" \"output_format\", and more as needed.\n\nIf you skip this step for non-easy tasks, workflows will likely be incomplete, or fail during execution for complex tasks.\nCalling it guarantees reliable, accurate, and end-to-end workflows aligned with the available tools and connections.\n "
176
+ },
177
+ {
178
+ "slug": "COMPOSIO_DOWNLOAD_S3_FILE",
179
+ "name": "Download S3 File",
180
+ "description": "Download a file from a public s3 (or r2) url to a local path."
181
+ },
182
+ {
183
+ "slug": "COMPOSIO_ENABLE_TRIGGER",
184
+ "name": "Enable trigger",
185
+ "description": "Enable a specific trigger for the authenticated user."
186
+ },
187
+ {
188
+ "slug": "COMPOSIO_EXECUTE_AGENT",
189
+ "name": "Execute agent",
190
+ "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."
191
+ },
192
+ {
193
+ "slug": "COMPOSIO_EXECUTE_TOOL",
194
+ "name": "Execute Composio Tool",
195
+ "description": "Execute a tool using the composio api."
196
+ },
197
+ {
198
+ "slug": "COMPOSIO_GET_DEPENDENCY_GRAPH",
199
+ "name": "Get Tool Dependency Graph",
200
+ "description": "Get the dependency graph for a given tool, showing related parent tools that might be useful. this action calls the composio labs dependency graph api to retrieve tools that are commonly used together with or before the specified tool. this helps discover related tools and understand common workflows."
201
+ },
202
+ {
203
+ "slug": "COMPOSIO_GET_REQUIRED_PARAMETERS",
204
+ "name": "Get required parameters for connection",
205
+ "description": "Gets the required parameters for connecting to a toolkit via initiate connection. returns the exact parameter names and types needed for initiate connection's parameters field. supports api keys, oauth credentials, connection fields, and hybrid authentication scenarios. if has default credentials is true, you can call initiate connection with empty parameters for seamless oauth flow."
206
+ },
207
+ {
208
+ "slug": "COMPOSIO_GET_RESPONSE_SCHEMA",
209
+ "name": "Get response schema",
210
+ "description": "Retrieves the response schema for a specified composio tool. this action fetches the complete response schema definition for any valid composio tool, returning it as a dictionary that describes the expected response structure."
211
+ },
212
+ {
213
+ "slug": "COMPOSIO_INITIATE_CONNECTION",
214
+ "name": "Initiate connection",
215
+ "description": "Initiate 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."
216
+ },
217
+ {
218
+ "slug": "COMPOSIO_LIST_TOOLKITS",
219
+ "name": "List toolkits",
220
+ "description": "List all the available toolkits on composio with filtering options."
221
+ },
222
+ {
223
+ "slug": "COMPOSIO_LIST_TRIGGERS",
224
+ "name": "List triggers",
225
+ "description": "List available triggers and their configuration schemas."
226
+ },
227
+ {
228
+ "slug": "COMPOSIO_MANAGE_CONNECTION",
229
+ "name": "Manage connection",
230
+ "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."
231
+ },
232
+ {
233
+ "slug": "COMPOSIO_MANAGE_CONNECTIONS",
234
+ "name": "Manage connections",
235
+ "description": "\nCreate or manage connections to user's apps. Returns a branded authentication link that works for OAuth, API keys, and all other auth types.\n\nCall policy:\n- First call COMPOSIO_SEARCH_TOOLS for the user’s query.\n- If COMPOSIO_SEARCH_TOOLS indicates there is no active connection for a toolkit, call COMPOSIO_MANAGE_CONNECTIONS with the exact toolkit name(s) returned.\n- Do not call COMPOSIO_MANAGE_CONNECTIONS if COMPOSIO_SEARCH_TOOLS returns no main tools and no related tools.\n- Toolkit names in toolkits must exactly match toolkit identifiers returned by COMPOSIO_SEARCH_TOOLS; never invent names.\n- NEVER execute any toolkit tool without an ACTIVE connection.\n\nBehavior:\n- If a connection is Active, the tool returns the connection details. Always use this to verify connection status and fetch metadata.\n- If a connection is not Active, returns a authentication link (redirect_url) to create new connection.\n- If reinitiate_all is true, the tool forces reconnections for all toolkits, even if they already have active connections.\n\nResponse handling:\n- Always show the returned redirect_url as a FORMATTED MARKDOWN LINK to the user, and ask them to click on the link to finish authentication.\n- Begin executing tools only after the connection for that toolkit is confirmed Active.\n "
236
+ },
237
+ {
238
+ "slug": "COMPOSIO_MULTI_EXECUTE_TOOL",
239
+ "name": "Multi Execute Composio Tools",
240
+ "description": "\n Fast and parallel tool executor for tools and recipes discovered through COMPOSIO_SEARCH_TOOLS. Use this tool to execute up to 50 tools in parallel across apps. Response contains structured outputs ready for immediate analysis - avoid reprocessing them via remote bash/workbench tools.\n\nPrerequisites:\n- Always use valid tool slugs and their arguments discovered through COMPOSIO_SEARCH_TOOLS. NEVER invent tool slugs or argument fields. ALWAYS pass STRICTLY schema-compliant arguments with each tool execution.\n- Ensure an ACTIVE connection exists for the toolkits that are going to be executed. If none exists, MUST initiate one via COMPOSIO_MANAGE_CONNECTIONS before execution.\n- Only batch tools that are logically independent - no required ordering or dependencies between tools or their outputs. DO NOT pass dummy or placeholder values; always resolve required inputs using appropriate tools first.\n\nUsage guidelines:\n- Use this whenever a tool is discovered and has to be called, either as part of a multi-step workflow or as a standalone tool.\n- If COMPOSIO_SEARCH_TOOLS returns a tool that can perform the task, prefer calling it via this executor. Do not write custom API calls or ad-hoc scripts for tasks that can be completed by available Composio tools.\n- Prefer parallel execution: group independent tools into a single multi-execute call where possible.\n- Predictively set sync_response_to_workbench=true if the response may be large or needed for later scripting. It still shows response inline; if the actual response data turns out small and easy to handle, keep everything inline and SKIP workbench usage.\n- Responses contain structured outputs for each tool. RULE: Small data - process yourself inline; large data - process in the workbench.\n- ALWAYS include inline references/links to sources in MARKDOWN format directly next to the relevant text. Eg provide slack thread links alongside with summary, render document links instead of raw IDs.\n\nRestrictions: Some tools or toolkits may be disabled in this environment. If the response indicates a restriction, inform the user and STOP execution immediately. Do NOT attempt workarounds or speculative actions.\n\n\n- CRITICAL: You MUST always include the 'memory' parameter - never omit it. Even if you think there's nothing to remember, include an empty object {} for memory.\n\nMemory Storage:\n- CRITICAL FORMAT: Memory must be a dictionary where keys are app names (strings) and values are arrays of strings. NEVER pass nested objects or dictionaries as values.\n- CORRECT format: {\"slack\": [\"Channel general has ID C1234567\"], \"gmail\": [\"John's email is john@example.com\"]}\n- Write memory entries in natural, descriptive language - NOT as key-value pairs. Use full sentences that clearly describe the relationship or information.\n- ONLY store information that will be valuable for future tool executions - focus on persistent data that saves API calls.\n- STORE: ID mappings, entity relationships, configs, stable identifiers.\n- DO NOT STORE: Action descriptions, temporary status updates, logs, or \"sent/fetched\" confirmations.\n- Examples of GOOD memory (store these):\n * \"The important channel in Slack has ID C1234567 and is called #general\"\n * \"The team's main repository is owned by user 'teamlead' with ID 98765\"\n * \"The user prefers markdown docs with professional writing, no emojis\" (user_preference)\n- Examples of BAD memory (DON'T store these):\n * \"Successfully sent email to john@example.com with message hi\"\n * \"Fetching emails from last day (Sep 6, 2025) for analysis\"\n- Do not repeat the memories stored or found previously.\n"
241
+ },
242
+ {
243
+ "slug": "COMPOSIO_REMOTE_BASH_TOOL",
244
+ "name": "Run bash commands",
245
+ "description": "\n Execute bash commands in a REMOTE sandbox for file operations, data processing, and system tasks. Essential for handling large tool responses saved to remote files.\n PRIMARY USE CASES:\n- Process large tool responses saved by COMPOSIO_MULTI_EXECUTE_TOOL to remote sandbox\n- File system operations, extract specific information from JSON with shell tools like jq, awk, sed, grep, etc.\n- Commands run from /home/user directory by default\n "
246
+ },
247
+ {
248
+ "slug": "COMPOSIO_REMOTE_WORKBENCH",
249
+ "name": "Execute Code remotely in work bench",
250
+ "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 400000 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 400k 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 "
251
+ },
252
+ {
253
+ "slug": "COMPOSIO_RETRIEVE_TOOLKITS",
254
+ "name": "Retrieve Toolkits",
255
+ "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."
256
+ },
257
+ {
258
+ "slug": "COMPOSIO_SEARCH_AGENT",
259
+ "name": "Search agent",
260
+ "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."
261
+ },
262
+ {
263
+ "slug": "COMPOSIO_SEARCH_TOOLS",
264
+ "name": "Search Composio Tools",
265
+ "description": "\n MCP Server Info: COMPOSIO MCP connects 500+ apps—Slack, GitHub, Notion, Google Workspace (Gmail, Sheets, Drive, Calendar), Microsoft (Outlook, Teams), X, Figma, Web Search, Meta apps (WhatsApp, Instagram), TikTok, AI tools like Nano Banana & Veo3, and more—for seamless cross-app automation.\n Use this MCP server to discover the right tools and the recommended step-by-step plan to execute reliably.\n ALWAYS call this tool first whenever a user mentions or implies an external app, service, or workflow—never say \"I don’t have access to X/Y app\" before calling it.\n\n Tool Info: Extremely fast discovery tool that returns relevant MCP-callable tools along with a recommended execution plan and common pitfalls for reliable execution.\n\n Usage guidelines:\n - Use this tool whenever kicking off a task. Re-run it when you need additional tools/plans due to missing details, errors, or a changed use case.\n - If the user pivots to a different use case in same chat, you MUST call this tool again with the new use case and generate a new session_id.\n - Specify the use_case with a normalized description of the problem, query, or task. Be clear and precise. Queries can be simple single-app actions or multiple linked queries for complex cross-app workflows.\n - Pass known_fields along with use_case as a string of key–value hints (for example, \"channel_name: general\") to help the search resolve missing details such as IDs.\n\n Example:\n User query: \"send an email to John welcoming him and create a meeting invite for tomorrow\"\n Search call: queries: [\n {use_case: \"send an email to someone\", known_fields: \"recipient_name: John\"},\n {use_case: \"create a meeting invite\", known_fields: \"meeting_date: tomorrow\"}\n ]\n\n Plan review checklist (required):\n - The response includes a detailed execution plan and common pitfalls. You MUST review this plan carefully, adapt it to your current context, and generate your own final step-by-step plan before execution. Execute the steps in order to ensure reliable and accurate execution. Skipping or ignoring required steps can lead to unexpected failures.\n - Check the plan and pitfalls for input parameter nuances (required fields, IDs, formats, limits). Before executing any tool, you MUST review its COMPLETE input schema and provide STRICTLY schema-compliant arguments to avoid invalid-input errors.\n - Determine whether pagination is needed; if a response returns a pagination token and completeness is implied, paginate until exhaustion and do not return partial results.\n\nResponse:\n - Tools & Input Schemas: The response lists toolkits (apps) and tools suitable for the task, along with their tool_slug, description, input schema / schemaRef, and related tools for prerequisites, alternatives, or next steps.\n - NOTE: Tools with schemaRef instead of input_schema require you to call COMPOSIO_GET_TOOL_SCHEMAS first to load their full input_schema before use.\n - Connection Info: If a toolkit has an active connection, the response includes it along with any available current user information. If no active connection exists, you MUST initiate a new connection via COMPOSIO_MANAGE_CONNECTIONS with the correct toolkit name. DO NOT execute any toolkit tool without an ACTIVE connection.\n - Time Info: The response includes the current UTC time for reference. You can reference UTC time from the response if needed.\n - The tools returned to you through this are to be called via COMPOSIO_MULTI_EXECUTE_TOOL. Ensure each tool execution specifies the correct tool_slug and arguments exactly as defined by the tool’s input schema.\n\n - The response includes a memory parameter containing relevant information about the use case and the known fields that can be used to determine the flow of execution. Any user preferences in memory must be adhered to.\n\n\nSESSION: ALWAYS set this parameter, first for any workflow. Pass session: {generate_id: true} for new workflows OR session: {id: \"EXISTING_ID\"} to continue. ALWAYS use the returned session_id in ALL subsequent meta tool calls.\n "
266
+ },
267
+ {
268
+ "slug": "COMPOSIO_WAIT_FOR_CONNECTION",
269
+ "name": "Wait for connection",
270
+ "description": "\nWait for the user to complete authentication AFTER you have given them an auth URL from COMPOSIO_MANAGE_CONNECTIONS. Use this **immediately after** sharing the auth URL so you can automatically continue once the connection is established — without waiting for the user to manually come back and say they’re done. Make sure you have printed the auth URL, DO NOT call this tool without printing auth URL first.\n This ensures a smooth, uninterrupted flow and a better user experience.\n You NEED NOT wait if there is no auth URL in the response of COMPOSIO_MANAGE_CONNECTIONS like in cases you ask user for api_key, client_id or client_secret.\n Input params <toolkits: list of toolkit names>, <mode (any / all) : wait for ANY or ALL connections to reach success/failed state (default: any) >\n Output params <connection statuses>\n Example:\n input:\n toolkits: [gmail, outlook]\n mode: [any]\n output: {\n gmail: {\n status: [connected]\n },\n outlook: {\n status: [initiated]\n }\n }\n "
271
+ },
272
+ {
273
+ "slug": "COMPOSIO_CREATE_UPDATE_RECIPE",
274
+ "name": "Create / Update Recipe from Workflow",
275
+ "description": "Convert executed workflow into a reusable notebook. Only use when workflow is complete or user explicitly requests.\r\n\r\n--- DESCRIPTION FORMAT (MARKDOWN) - MUST BE NEUTRAL ---\r\n\r\nDescription is for ANY user of this recipe, not just the creator. Keep it generic.\r\n- NO PII (no real emails, names, channel names, repo names)\r\n- NO user-specific defaults (defaults go in defaults_for_required_parameters only)\r\n- Use placeholder examples only\r\n\r\nGenerate rich markdown with these sections:\r\n\r\n## Overview\r\n[2-3 sentences: what it does, what problem it solves]\r\n\r\n## How It Works\r\n[End-to-end flow in plain language]\r\n\r\n## Key Features\r\n- [Feature 1]\r\n- [Feature 2]\r\n\r\n## Step-by-Step Flow\r\n1. **[Step]**: [What happens]\r\n2. **[Step]**: [What happens]\r\n\r\n## Apps & Integrations\r\n| App | Purpose |\r\n|-----|---------|\r\n| [App] | [Usage] |\r\n\r\n## Inputs Required\r\n| Input | Description | Format |\r\n|-------|-------------|--------|\r\n| channel_name | Slack channel to post to | WITHOUT # prefix |\r\n\r\n(No default values here - just format guidance)\r\n\r\n## Output\r\n[What the recipe produces]\r\n\r\n## Notes & Limitations\r\n- [Edge cases, rate limits, caveats]\r\n\r\n--- CODE STRUCTURE ---\r\n\r\nCode has 2 parts:\r\n1. DOCSTRING HEADER (comments) - context, learnings, version history\r\n2. EXECUTABLE CODE - clean Python that runs\r\n\r\nDOCSTRING HEADER (preserve all history when updating):\r\n\r\n\"\"\"\r\nRECIPE: [Name]\r\nFLOW: [App1] → [App2] → [Output]\r\n\r\nVERSION HISTORY:\r\nv2 (current): [What changed] - [Why]\r\nv1: Initial version\r\n\r\nAPI LEARNINGS:\r\n- [API_NAME]: [Quirk, e.g., Response nested at data.data]\r\n\r\nKNOWN ISSUES:\r\n- [Issue and fix]\r\n\"\"\"\r\n\r\nThen EXECUTABLE CODE follows (keep code clean, learnings stay in docstring).\r\n\r\n--- INPUT SCHEMA (USER-FRIENDLY) ---\r\n\r\nAsk for: channel_name, repo_name, sheet_url, email_address\r\nNever ask for: channel_id, spreadsheet_id, user_id (resolve in code)\r\nNever ask for large inputs: use invoke_llm to generate content in code\r\n\r\nGOOD DESCRIPTIONS (explicit format, generic examples - no PII):\r\n channel_name: Slack channel WITHOUT # prefix\r\n repo_name: Repository name only, NOT owner/repo\r\n google_sheet_url: Full URL from browser\r\n gmail_label: Label as shown in Gmail sidebar\r\n\r\nREQUIRED vs OPTIONAL:\r\n- Required: things that change every run (channel name, date range, search terms)\r\n- Optional: generic settings with sensible defaults (sheet tab, row limits)\r\n\r\n--- DEFAULTS FOR REQUIRED PARAMETERS ---\r\n\r\n- Provide in defaults_for_required_parameters for all required inputs\r\n- Use values from workflow context\r\n- Use empty string if no value available - never hallucinate\r\n- Match types: string param needs string default, number needs number\r\n- Defaults are private to creator, not shared when recipe is published\r\n- SCHEDULE-FRIENDLY DEFAULTS:\r\n- Use RELATIVE time references unless user asks otherwise, not absolute dates\r\n✓ \"last_24_hours\", \"past_week\", \"7\" (days back)\r\n✗ \"2025-01-15\", \"December 18, 2025\"\r\n- - Never include timezone as an input parameter unless specifically asked\r\n- - Test: \"Will this default work if recipe runs tomorrow?\"\r\n\r\n--- CODING RULES ---\r\n\r\nSINGLE EXECUTION: Generate complete notebook that runs in one invocation.\r\nCODE CORRECTNESS: Must be syntactically and semantically correct and executable.\r\nENVIRONMENT VARIABLES: All inputs via os.environ.get(). Code is shared - no PII.\r\nTIMEOUT: 4 min hard limit. Use ThreadPoolExecutor for bulk operations.\r\nSCHEMA SAFETY: Never assume API response schema. Use invoke_llm to parse unknown responses.\r\nNESTED DATA: APIs often double-nest. Always extract properly before using.\r\nID RESOLUTION: Convert names to IDs in code using FIND/SEARCH tools.\r\nFAIL LOUDLY: Raise Exception if expected data is empty. Never silently continue.\r\nCONTENT GENERATION: Never hardcode text. Use invoke_llm() for generated content.\r\nDEBUGGING: Timestamp all print statements.\r\nNO META LOOPS: Never call RUBE_* or COMPOSIO_* meta tools via run_composio_tool.\r\nOUTPUT: End with just output variable (no print).\r\n\r\n--- HELPERS ---\r\n\r\nAvailable in notebook (dont import). See RUBE_REMOTE_WORKBENCH for details:\r\nrun_composio_tool(slug, args) returns (result, error)\r\ninvoke_llm(prompt, reasoning_effort=\"low\") returns (response, error)\r\n # reasoning_effort: \"low\" (bulk classification), \"medium\" (summarization), \"high\" (creative/complex content)\r\n # Always specify based on task - use low by default, medium for analysis, high for creative generation\r\nproxy_execute(method, endpoint, toolkit, ...) returns (result, error)\r\nupload_local_file(*paths) returns (result, error)\r\n\r\n--- CHECKLIST ---\r\n\r\n- Description: Neutral, no PII, no defaults - for any user\r\n- Docstring header: Version history, API learnings (preserve on update)\r\n- Input schema: Human-friendly names, format guidance, no large inputs\r\n- Defaults: In defaults_for_required_parameters, type-matched, from context\r\n- Code: Single execution, os.environ.get(), no PII, fail loudly\r\n- Output: Ends with just output"
276
+ },
277
+ {
278
+ "slug": "COMPOSIO_EXECUTE_RECIPE",
279
+ "name": "Execute Recipe",
280
+ "description": "Executes a Recipe"
281
+ },
282
+ {
283
+ "slug": "COMPOSIO_UPSERT_RECIPE",
284
+ "name": "Create / Update Recipe from Workflow",
285
+ "description": "\n Convert the executed workflow into a recipe using Python Pydantic code.\n The recipe_slug parameter is required. If a recipe with the provided slug already exists, a new version will be created.\n If the slug does not exist, a new recipe will be created.\n\n \n This tool allows you to:\n\n 1. Save the executed workflow as a reusable recipe using Python Pydantic code\n 2. The recipe_slug parameter is required. If a recipe with the provided slug already exists, a new version will be created. If the slug does not exist, a new recipe will be created.\n 3. Recipes are defined using Python Pydantic models that extend ComposioRecipe base class\n 4. You should generate the Python Pydantic code for the recipe based on the executed workflow, please see below for more instructions on how to generate the code for the recipe\n 5. The recipe code must define request and response Pydantic models and implement the execute method\n\n WHEN TO USE\n - Only run this tool when the workflow is completed and successful or if the user explicitly asked to run this tool\n\n DO NOT USE\n - When the workflow is still being processed, or not yet completed and the user explicitly didn't ask to run this tool\n\n IMPORTANT CODING RULES:\n 1. Single Execution: Please generate the code for the full recipe that can be executed in a single invocation\n 2. 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 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 4. LLM Helpers: You should 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 5. 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 6. 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 7. No Hardcoding: Never hardcode data in code. Always load it from files or tool responses, iterating to construct intermediate or final inputs/outputs.\n 8. No Hardcoding: Please do NOT hardcode any PII related information like email / name / home address / social security id or anything like that. This is very risky\n 9. NEVER HARDCODE CONTENT (CRITICAL): For ANY content generation use case, you MUST use invoke_llm helper instead of hardcoding. This includes but is not limited to: social media posts (Twitter, LinkedIn, Instagram, Facebook, Reddit, etc.), blog posts, articles, email content, SEO reports, market research, jokes, stories, creative writing, product descriptions, news summaries, documentation, or ANY text content that should be unique, personalized, or contextual. Always use invoke_llm with a specific prompt to generate fresh content every time.\n 10. Dynamic Content Generation: Structure your code like this for content generation: content_prompt = f\"Generate a [specific type] about [topic] that [requirements]\" then generated_content, error = invoke_llm(content_prompt). Every execution should produce different, contextually appropriate content.\n 11. Code Correctness (CRITICAL): Code must be syntactically and semantically correct and executable.\n 12. Recipe Structure: The recipe code must follow this structure:\n - Import required modules: from pydantic import BaseModel, Field; from recipes.base import ComposioRecipe\n - Define Request model: class RecipeRequest(BaseModel) with Field descriptions\n - Define Response model: class RecipeResponse(BaseModel) with Field descriptions\n - Define Recipe class: class RecipeName(ComposioRecipe[RecipeRequest, RecipeResponse]) with name attribute and execute method\n - The execute method should use self.run_composio_tool() to call tools and return RecipeResponse instance\n - IMPORTANT: The recipe class must have a name attribute that is a slug-type identifier (lowercase, underscores, no spaces). Example: name = \"weather_lookup\" or name = \"github_repo_analyzer\". This name will be used as the recipe slug identifier.\n 13. Pydantic Models: Use proper Field descriptions and types. Request model should have all input parameters with Field(..., description=\"...\")\n 14. Response Model: Should match the expected output structure with proper Field descriptions\n 15. Tool Execution: Use self.run_composio_tool(tool_slug, arguments) to execute tools within the recipe\n 16. Error Handling: Handle errors appropriately and return meaningful error messages\n 17. Debugging (CRITICAL): For every print statement in your code, please prefix it with the time at which it is being executed. This will help me investigate latency related stuff\n 18. If there are any errors while running, please throw the error so that the person running the recipe can see and fix it\n 19. FAIL LOUDLY (CRITICAL): If you expect data but get 0 results, raise Exception immediately. NEVER silently continue or create empty outputs. Recovery loop will fix the code - don't hide issues. Example: if len(items) == 0: raise Exception(\"Expected data but got none\")\n 20. NESTED DATA (CRITICAL): APIs often double-nest data. Always extract: data = result.get(\"data\", {}); if \"data\" in data: data = data[\"data\"]. Try flexible field names: item.get(\"id\") or item.get(\"channel_id\")\n\n IMPORTANT SCHEMA RULES:\n 1. Keep request model simple - include only parameters users would want to vary between runs\n 2. Do not ask for large inputs. Use invoke_llm helper to generate large content in the code\n 3. HUMAN-FRIENDLY INPUTS (CRITICAL):\n - ✓ Ask for: channel_name, google_sheet_url, repo_name, email_address\n - ✗ Never ask for: channel_id, spreadsheet_id, document_id, user_id\n - Extract IDs in code: use FIND/SEARCH tools to convert names/URLs to IDs\n - For URLs: extract IDs in code with regex (e.g., spreadsheet_id from google_sheet_url)\n 4. REQUIRED vs OPTIONAL: Mark as required only if it's specific to the user's workflow and would change every run. Generic settings should be optional with sensible defaults\n 5. Identify what varies between runs: channel name, date range, search terms = required. Sheet tab name, row limits, formatting = optional\n 6. [CRITICAL]: Use search/find tools in code to convert human inputs (names/URLs) to IDs before calling other tools\n\n ENV & HELPERS:\n Recipes inherit from ComposioRecipe and have access to these helper methods:\n\n 1. self.run_composio_tool(tool_slug: str, params: Dict) -> Tuple[Dict, Optional[str]]\n - Execute a Composio tool\n - Returns: (result dict, error string or None)\n\n 2. self.invoke_llm(prompt: str) -> Tuple[str, Optional[str]]\n - Invoke an LLM for semantic analysis, reasoning, summarization, and other generic tasks\n - Returns: (completion text, error string or None)\n\n 3. self.web_search(query: str) -> Tuple[str, Optional[str]]\n - Perform web search\n - Returns: (answer text, error string or None)\n\n NOTE: The recipe code must be valid Python Pydantic code that extends ComposioRecipe base class.\n \n\n "
286
+ },
287
+ {
288
+ "slug": "COMPOSIO_GET_RECIPE",
289
+ "name": "Get Recipe Details by Slug",
290
+ "description": "\n Get the details of an existing recipe by its slug.\n Returns the recipe's name, description, input/output schemas, and the toolkits it uses.\n Use this to inspect a recipe's structure before executing it.\n "
291
+ },
292
+ {
293
+ "slug": "COMPOSIO_GET_RECIPE_DETAILS",
294
+ "name": "Get Existing Recipe Details",
295
+ "description": "\n Get the details of the existing recipe for a given recipe id.\n "
296
+ },
297
+ {
298
+ "slug": "COMPOSIO_GET_TOOL_SCHEMAS",
299
+ "name": "Get Tool Schemas",
300
+ "description": "Retrieve input schemas for tools by slug. Returns complete parameter definitions required to execute each tool. Make sure to call this tool whenever the response of COMPOSIO_SEARCH_TOOLS does not provide a complete schema for a tool - you must never invent or guess any input parameters."
301
+ }
302
+ ],
303
+ "triggers": []
304
+ },
305
+ {
306
+ "slug": "github",
307
+ "name": "GitHub",
308
+ "logo": "https://logos.composio.dev/api/github",
309
+ "description": "GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features",
310
+ "category": "developer tools & devops",
311
+ "authSchemes": [
312
+ "OAUTH2"
313
+ ],
314
+ "toolCount": 823,
315
+ "triggerCount": 6,
316
+ "version": "20260102_01",
317
+ "tools": [
318
+ {
319
+ "slug": "GITHUB_ACCEPT_A_REPOSITORY_INVITATION",
320
+ "name": "Accept a repository invitation",
321
+ "description": "Accepts a pending repository invitation that has been issued to the authenticated user."
322
+ },
323
+ {
324
+ "slug": "GITHUB_ACTIVITY_LIST_REPO_S_STARRED_BY_AUTHENTICATED_USER",
325
+ "name": "List repositories starred by the authenticated user",
326
+ "description": "Deprecated: lists repositories starred by the authenticated user, including star creation timestamps; use 'list repositories starred by the authenticated user' instead."
327
+ },
328
+ {
329
+ "slug": "GITHUB_ACTIVITY_LIST_STARGAZERS_FOR_REPO",
330
+ "name": "List stargazers",
331
+ "description": "Deprecated: lists users who have starred a repository; use `list stargazers` instead."
332
+ },
333
+ {
334
+ "slug": "GITHUB_ACTIVITY_STAR_REPO_FOR_AUTHENTICATED_USER",
335
+ "name": "Star a repository for the authenticated user",
336
+ "description": "Deprecated: stars a repository for the authenticated user; use `star a repository for the authenticated user` instead."
337
+ },
338
+ {
339
+ "slug": "GITHUB_ADD_AN_EMAIL_ADDRESS_FOR_THE_AUTHENTICATED_USER",
340
+ "name": "Add email for auth user",
341
+ "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."
342
+ },
343
+ {
344
+ "slug": "GITHUB_ADD_APP_ACCESS_RESTRICTIONS",
345
+ "name": "Add app access restrictions",
346
+ "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."
347
+ },
348
+ {
349
+ "slug": "GITHUB_ADD_A_REPOSITORY_COLLABORATOR",
350
+ "name": "Add a repository collaborator",
351
+ "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."
352
+ },
353
+ {
354
+ "slug": "GITHUB_ADD_A_REPOSITORY_TO_AN_APP_INSTALLATION",
355
+ "name": "Add a repository to an app installation",
356
+ "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."
357
+ },
358
+ {
359
+ "slug": "GITHUB_ADD_A_SELECTED_REPOSITORY_TO_A_USER_SECRET",
360
+ "name": "Add a selected repository to a user secret",
361
+ "description": "Grants a specified repository access to an authenticated user's existing codespaces secret, enabling codespaces created for that repository to use the secret."
362
+ },
363
+ {
364
+ "slug": "GITHUB_ADD_ASSIGNEES_TO_AN_ISSUE",
365
+ "name": "Add assignees to an issue",
366
+ "description": "Adds or removes assignees for a github issue; changes are silently ignored if the authenticated user lacks push access to the repository."
367
+ },
368
+ {
369
+ "slug": "GITHUB_ADD_LABELS_TO_AN_ISSUE",
370
+ "name": "Add labels to an issue",
371
+ "description": "Adds labels (provided in the request body) to a repository issue; labels that do not already exist are created."
372
+ },
373
+ {
374
+ "slug": "GITHUB_ADD_ORG_RUNNER_LABELS",
375
+ "name": "Add org runner labels",
376
+ "description": "Adds new custom labels to an existing self-hosted runner for an organization; existing labels are not removed, and duplicates are not added."
377
+ },
378
+ {
379
+ "slug": "GITHUB_ADD_OR_UPDATE_TEAM_MEMBERSHIP_FOR_A_USER",
380
+ "name": "Add or update team membership for a user",
381
+ "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."
382
+ },
383
+ {
384
+ "slug": "GITHUB_ADD_OR_UPDATE_TEAM_PROJECT_PERMISSIONS",
385
+ "name": "Add or update team project permissions",
386
+ "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."
387
+ },
388
+ {
389
+ "slug": "GITHUB_ADD_OR_UPDATE_TEAM_REPOSITORY_PERMISSIONS",
390
+ "name": "Add or update team repository permissions",
391
+ "description": "Sets or updates a team's permission level for a repository within an organization; the team must be a member of the organization."
392
+ },
393
+ {
394
+ "slug": "GITHUB_ADD_PROJECT_COLLABORATOR",
395
+ "name": "Add project collaborator",
396
+ "description": "Adds a specified github user as a collaborator to an existing organization project with a given permission level."
397
+ },
398
+ {
399
+ "slug": "GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_ACCESS",
400
+ "name": "Add repo to org secret with selected access",
401
+ "description": "Adds a repository to an existing organization-level github actions secret that is configured for 'selected' repository access."
402
+ },
403
+ {
404
+ "slug": "GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_VISIBILITY",
405
+ "name": "Add selected repo to org secret",
406
+ "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."
407
+ },
408
+ {
409
+ "slug": "GITHUB_ADD_RUNNER_LABELS",
410
+ "name": "Add runner labels",
411
+ "description": "Adds and appends custom labels to a self-hosted repository runner, which must be registered and active."
412
+ },
413
+ {
414
+ "slug": "GITHUB_ADD_SELECTED_REPOSITORY_TO_AN_ORGANIZATION_SECRET",
415
+ "name": "Add selected repository to an organization secret",
416
+ "description": "Adds a repository to an organization secret's access list when the secret's visibility is 'selected'; this operation is idempotent."
417
+ },
418
+ {
419
+ "slug": "GITHUB_ADD_SELECTED_REPOSITORY_TO_AN_ORGANIZATION_VARIABLE",
420
+ "name": "Add selected repository to an organization variable",
421
+ "description": "Grants a repository access to an organization-level github actions variable, if that variable's visibility is set to 'selected repositories'."
422
+ },
423
+ {
424
+ "slug": "GITHUB_ADD_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER",
425
+ "name": "Add social accounts for the authenticated user",
426
+ "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."
427
+ },
428
+ {
429
+ "slug": "GITHUB_ADD_STATUS_CHECK_CONTEXTS",
430
+ "name": "Add status check contexts",
431
+ "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."
432
+ },
433
+ {
434
+ "slug": "GITHUB_ADD_TEAM_ACCESS_RESTRICTIONS",
435
+ "name": "Add team access restrictions",
436
+ "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."
437
+ },
438
+ {
439
+ "slug": "GITHUB_ADD_USER_ACCESS_RESTRICTIONS",
440
+ "name": "Add user access restrictions",
441
+ "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."
442
+ },
443
+ {
444
+ "slug": "GITHUB_ADD_USERS_TO_CODESPACES_ACCESS_FOR_AN_ORGANIZATION",
445
+ "name": "Add users to codespaces access for an organization",
446
+ "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."
447
+ },
448
+ {
449
+ "slug": "GITHUB_APPROVE_A_WORKFLOW_RUN_FOR_A_FORK_PULL_REQUEST",
450
+ "name": "Approve a workflow run for a fork pull request",
451
+ "description": "Approves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration."
452
+ },
453
+ {
454
+ "slug": "GITHUB_ASSIGN_AN_ORGANIZATION_ROLE_TO_A_TEAM",
455
+ "name": "Assign an organization role to a team",
456
+ "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."
457
+ },
458
+ {
459
+ "slug": "GITHUB_ASSIGN_AN_ORGANIZATION_ROLE_TO_A_USER",
460
+ "name": "Assign an organization role to a user",
461
+ "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."
462
+ },
463
+ {
464
+ "slug": "GITHUB_AUTH_USER_DOCKER_CONFLICT_PACKAGES_LIST",
465
+ "name": "Authuserdockerconflictpackageslist",
466
+ "description": "Lists docker packages for the authenticated user that encountered conflicts during the docker migration process."
467
+ },
468
+ {
469
+ "slug": "GITHUB_BLOCK_A_USER",
470
+ "name": "Block a user",
471
+ "description": "Blocks an existing individual github user (not an organization or your own account), preventing them from interacting with your account and repositories."
472
+ },
473
+ {
474
+ "slug": "GITHUB_BLOCK_A_USER_FROM_AN_ORGANIZATION",
475
+ "name": "Block a user from an organization",
476
+ "description": "Blocks an existing github user from an existing organization, preventing their contributions, collaboration, and forking of the organization's repositories."
477
+ },
478
+ {
479
+ "slug": "GITHUB_CANCEL_A_GITHUB_PAGES_DEPLOYMENT",
480
+ "name": "Cancel a GitHub Pages deployment",
481
+ "description": "Cancels an existing, ongoing or queued github pages deployment for a repository using its `pages deployment id`."
482
+ },
483
+ {
484
+ "slug": "GITHUB_CANCEL_A_WORKFLOW_RUN",
485
+ "name": "Cancel a workflow run",
486
+ "description": "Cancels a workflow run in a github repository if it is in a cancellable state (e.g., 'in progress' or 'queued')."
487
+ },
488
+ {
489
+ "slug": "GITHUB_CHECK_A_TOKEN",
490
+ "name": "Check a token",
491
+ "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."
492
+ },
493
+ {
494
+ "slug": "GITHUB_CHECK_IF_A_GIST_IS_STARRED",
495
+ "name": "Check if a gist is starred",
496
+ "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."
497
+ },
498
+ {
499
+ "slug": "GITHUB_CHECK_IF_A_PERSON_IS_FOLLOWED_BY_THE_AUTHENTICATED_USER",
500
+ "name": "Check if person is followed by authenticated user",
501
+ "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."
502
+ },
503
+ {
504
+ "slug": "GITHUB_CHECK_IF_A_PULL_REQUEST_HAS_BEEN_MERGED",
505
+ "name": "Check if pull request merged",
506
+ "description": "Checks if a specified github pull request has been merged, indicated by a 204 http status (merged) or 404 (not merged/found)."
507
+ },
508
+ {
509
+ "slug": "GITHUB_CHECK_IF_A_REPOSITORY_IS_STARRED_BY_THE_AUTHENTICATED_USER",
510
+ "name": "Check if repo starred by auth user",
511
+ "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."
512
+ },
513
+ {
514
+ "slug": "GITHUB_CHECK_IF_A_USER_CAN_BE_ASSIGNED",
515
+ "name": "Check if a user can be assigned",
516
+ "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."
517
+ },
518
+ {
519
+ "slug": "GITHUB_CHECK_IF_A_USER_CAN_BE_ASSIGNED_TO_A_ISSUE",
520
+ "name": "Check if a user can be assigned to an issue",
521
+ "description": "Checks if a specified github user can be assigned to a given issue within a repository."
522
+ },
523
+ {
524
+ "slug": "GITHUB_CHECK_IF_A_USER_FOLLOWS_ANOTHER_USER",
525
+ "name": "Check if a user follows another user",
526
+ "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."
527
+ },
528
+ {
529
+ "slug": "GITHUB_CHECK_IF_A_USER_IS_A_REPOSITORY_COLLABORATOR",
530
+ "name": "Check if a user is a repository collaborator",
531
+ "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."
532
+ },
533
+ {
534
+ "slug": "GITHUB_CHECK_IF_A_USER_IS_BLOCKED_BY_AN_ORGANIZATION",
535
+ "name": "Check if a user is blocked by an organization",
536
+ "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."
537
+ },
538
+ {
539
+ "slug": "GITHUB_CHECK_IF_A_USER_IS_BLOCKED_BY_THE_AUTHENTICATED_USER",
540
+ "name": "Check if a user is blocked by the authenticated user",
541
+ "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."
542
+ },
543
+ {
544
+ "slug": "GITHUB_CHECK_PRIVATE_VULNERABILITY_REPORTING_STATUS",
545
+ "name": "Check private vulnerability reporting status",
546
+ "description": "Checks if private vulnerability reporting is enabled for the specified repository."
547
+ },
548
+ {
549
+ "slug": "GITHUB_CHECK_TEAM_PERMISSIONS_FOR_A_PROJECT",
550
+ "name": "Check team permissions for a project",
551
+ "description": "Checks if a team has 'read', 'write', or 'admin' permissions for an organization's specific classic project, returning the project's details if access is confirmed."
552
+ },
553
+ {
554
+ "slug": "GITHUB_CHECK_TEAM_PERMISSIONS_FOR_A_REPOSITORY",
555
+ "name": "Check team permissions for a repository",
556
+ "description": "Checks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams."
557
+ },
558
+ {
559
+ "slug": "GITHUB_CLEAR_REPOSITORY_CACHE_BY_KEY",
560
+ "name": "Clear repository cache by key",
561
+ "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."
562
+ },
563
+ {
564
+ "slug": "GITHUB_CLEAR_SELF_HOSTED_RUNNER_ORG_LABELS",
565
+ "name": "Clear self-hosted runner org labels",
566
+ "description": "Removes all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain."
567
+ },
568
+ {
569
+ "slug": "GITHUB_COMPARE_TWO_COMMITS",
570
+ "name": "Compare two commits",
571
+ "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."
572
+ },
573
+ {
574
+ "slug": "GITHUB_CONFIGURE_JITRUNNER_FOR_ORG",
575
+ "name": "Configure JIT runner for an org",
576
+ "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."
577
+ },
578
+ {
579
+ "slug": "GITHUB_CONFIGURE_OIDCSUBJECT_CLAIM_TEMPLATE",
580
+ "name": "Configure OIDC subject claim template",
581
+ "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`)."
582
+ },
583
+ {
584
+ "slug": "GITHUB_CONVERT_AN_ORGANIZATION_MEMBER_TO_OUTSIDE_COLLABORATOR",
585
+ "name": "Convert an organization member to outside collaborator",
586
+ "description": "Converts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories."
587
+ },
588
+ {
589
+ "slug": "GITHUB_CREATE_A_BLOB",
590
+ "name": "Create a blob",
591
+ "description": "Creates a git blob in a repository, requiring content and encoding ('utf-8' or 'base64')."
592
+ },
593
+ {
594
+ "slug": "GITHUB_CREATE_A_CHECK_RUN",
595
+ "name": "Create a check run",
596
+ "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."
597
+ },
598
+ {
599
+ "slug": "GITHUB_CREATE_A_CHECK_SUITE",
600
+ "name": "Create a check suite",
601
+ "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."
602
+ },
603
+ {
604
+ "slug": "GITHUB_CREATE_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
605
+ "name": "Create a codespace for the authenticated user",
606
+ "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))."
607
+ },
608
+ {
609
+ "slug": "GITHUB_CREATE_A_CODESPACE_FROM_A_PULL_REQUEST",
610
+ "name": "Create a codespace from a pull request",
611
+ "description": "Creates a github codespace for an open pull request in a codespaces-enabled repository, with options to customize its configuration."
612
+ },
613
+ {
614
+ "slug": "GITHUB_CREATE_A_CODESPACE_IN_A_REPOSITORY",
615
+ "name": "Create a codespace in a repository",
616
+ "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."
617
+ },
618
+ {
619
+ "slug": "GITHUB_CREATE_A_COMMIT",
620
+ "name": "Create a commit",
621
+ "description": "Creates a new commit in a github repository; the `tree` sha and any `parents` shas must already exist in the repository."
622
+ },
623
+ {
624
+ "slug": "GITHUB_CREATE_A_COMMIT_COMMENT",
625
+ "name": "Create a commit comment",
626
+ "description": "Creates a comment on a specific commit, or on a specific line if `path` and `position` are provided."
627
+ },
628
+ {
629
+ "slug": "GITHUB_CREATE_A_COMMIT_STATUS",
630
+ "name": "Create a commit status",
631
+ "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."
632
+ },
633
+ {
634
+ "slug": "GITHUB_CREATE_A_CUSTOM_ORGANIZATION_ROLE",
635
+ "name": "Create a custom organization role",
636
+ "description": "Creates a custom role with defined permissions within a github organization."
637
+ },
638
+ {
639
+ "slug": "GITHUB_CREATE_A_DEPLOY_KEY",
640
+ "name": "Create a deploy key",
641
+ "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."
642
+ },
643
+ {
644
+ "slug": "GITHUB_CREATE_A_DEPLOYMENT",
645
+ "name": "Create a deployment",
646
+ "description": "Creates a github deployment for an existing repository, targeting a specific ref (branch, tag, or sha) that must also exist within the repository."
647
+ },
648
+ {
649
+ "slug": "GITHUB_CREATE_A_DEPLOYMENT_BRANCH_POLICY",
650
+ "name": "Create a deployment branch policy",
651
+ "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."
652
+ },
653
+ {
654
+ "slug": "GITHUB_CREATE_A_DEPLOYMENT_STATUS",
655
+ "name": "Create a deployment status",
656
+ "description": "Creates a status for an existing deployment, updating its operational state, associated urls, and description."
657
+ },
658
+ {
659
+ "slug": "GITHUB_CREATE_A_DISCUSSION",
660
+ "name": "Create a discussion",
661
+ "description": "Creates a new discussion post on a specific team's page within an organization."
662
+ },
663
+ {
664
+ "slug": "GITHUB_CREATE_A_DISCUSSION_COMMENT",
665
+ "name": "Create a discussion comment",
666
+ "description": "Creates a new comment on an existing team discussion within a github organization."
667
+ },
668
+ {
669
+ "slug": "GITHUB_CREATE_A_FORK",
670
+ "name": "Create a fork",
671
+ "description": "Creates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch."
672
+ },
673
+ {
674
+ "slug": "GITHUB_CREATE_A_GIST",
675
+ "name": "Create a gist",
676
+ "description": "Creates a new gist on github with provided files, an optional description, and public/secret visibility."
677
+ },
678
+ {
679
+ "slug": "GITHUB_CREATE_A_GIST_COMMENT",
680
+ "name": "Create a gist comment",
681
+ "description": "Creates a new comment on a specified github gist."
682
+ },
683
+ {
684
+ "slug": "GITHUB_CREATE_A_GITHUB_APP_FROM_A_MANIFEST",
685
+ "name": "Create a GitHub App from a manifest",
686
+ "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."
687
+ },
688
+ {
689
+ "slug": "GITHUB_CREATE_A_GITHUB_PAGES_DEPLOYMENT",
690
+ "name": "Create a github pages deployment",
691
+ "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."
692
+ },
693
+ {
694
+ "slug": "GITHUB_CREATE_A_GITHUB_PAGES_SITE",
695
+ "name": "Create a github pages site",
696
+ "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`."
697
+ },
698
+ {
699
+ "slug": "GITHUB_CREATE_A_LABEL",
700
+ "name": "Create a label",
701
+ "description": "Creates a new label in a specified github repository, provided the repository exists and the user has write permissions."
702
+ },
703
+ {
704
+ "slug": "GITHUB_CREATE_A_MILESTONE",
705
+ "name": "Create a milestone",
706
+ "description": "Creates a milestone in a github repository for tracking progress on issues or pull requests; requires repository existence and user write permissions."
707
+ },
708
+ {
709
+ "slug": "GITHUB_CREATE_AN_AUTOLINK_REFERENCE_FOR_A_REPOSITORY",
710
+ "name": "Create an autolink reference for a repository",
711
+ "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>`."
712
+ },
713
+ {
714
+ "slug": "GITHUB_CREATE_AN_ENVIRONMENT_VARIABLE",
715
+ "name": "Create an environment variable",
716
+ "description": "Creates an encrypted environment variable for a pre-existing environment within a github repository; will fail if the variable name already exists."
717
+ },
718
+ {
719
+ "slug": "GITHUB_CREATE_AN_ISSUE",
720
+ "name": "Create an issue",
721
+ "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."
722
+ },
723
+ {
724
+ "slug": "GITHUB_CREATE_AN_ISSUE_COMMENT",
725
+ "name": "Create an issue comment",
726
+ "description": "Creates a new comment on an existing github issue or pull request within the specified repository."
727
+ },
728
+ {
729
+ "slug": "GITHUB_CREATE_AN_ORGANIZATION_PROJECT",
730
+ "name": "Create an organization project",
731
+ "description": "Creates a new classic project board within a specified github organization."
732
+ },
733
+ {
734
+ "slug": "GITHUB_CREATE_AN_ORGANIZATION_REPOSITORY",
735
+ "name": "Create an organization repository",
736
+ "description": "Creates a new repository within a specified github organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates."
737
+ },
738
+ {
739
+ "slug": "GITHUB_CREATE_AN_ORGANIZATION_VARIABLE",
740
+ "name": "Create an organization variable",
741
+ "description": "Creates a new, uniquely named github actions variable for an organization, with configurable repository access visibility (all, private, or selected)."
742
+ },
743
+ {
744
+ "slug": "GITHUB_CREATE_AN_ORGANIZATION_WEBHOOK",
745
+ "name": "Create an organization webhook",
746
+ "description": "Creates a webhook for a github organization to deliver event notifications to a configured url."
747
+ },
748
+ {
749
+ "slug": "GITHUB_CREATE_A_PROJECT_CARD",
750
+ "name": "Create a project card",
751
+ "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')."
752
+ },
753
+ {
754
+ "slug": "GITHUB_CREATE_A_PROJECT_COLUMN",
755
+ "name": "Create a project column",
756
+ "description": "Creates a new column in a github project (classic)."
757
+ },
758
+ {
759
+ "slug": "GITHUB_CREATE_A_PULL_REQUEST",
760
+ "name": "Create a pull request",
761
+ "description": "Creates a pull request in a github repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided."
762
+ },
763
+ {
764
+ "slug": "GITHUB_CREATE_A_REFERENCE",
765
+ "name": "Create a reference",
766
+ "description": "Creates a git reference (e.g., a branch or tag) in a repository; the repository must not be empty prior to this operation."
767
+ },
768
+ {
769
+ "slug": "GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_AN_ORGANIZATION",
770
+ "name": "Create a registration token for an organization",
771
+ "description": "Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for github actions."
772
+ },
773
+ {
774
+ "slug": "GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_A_REPOSITORY",
775
+ "name": "Create a registration token for a repository",
776
+ "description": "Generates a time-limited token required to register a new self-hosted runner with a specific repository."
777
+ },
778
+ {
779
+ "slug": "GITHUB_CREATE_A_RELEASE",
780
+ "name": "Create a release",
781
+ "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."
782
+ },
783
+ {
784
+ "slug": "GITHUB_CREATE_A_REMOVE_TOKEN_FOR_AN_ORGANIZATION",
785
+ "name": "Create a remove token for an organization",
786
+ "description": "Generates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization."
787
+ },
788
+ {
789
+ "slug": "GITHUB_CREATE_A_REMOVE_TOKEN_FOR_A_REPOSITORY",
790
+ "name": "Create a remove token for a repository",
791
+ "description": "Generates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository."
792
+ },
793
+ {
794
+ "slug": "GITHUB_CREATE_A_REPLY_FOR_A_REVIEW_COMMENT",
795
+ "name": "Create a reply for a review comment",
796
+ "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."
797
+ },
798
+ {
799
+ "slug": "GITHUB_CREATE_A_REPOSITORY_DISPATCH_EVENT",
800
+ "name": "Create a repository dispatch event",
801
+ "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."
802
+ },
803
+ {
804
+ "slug": "GITHUB_CREATE_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER",
805
+ "name": "Create a repository for the authenticated user",
806
+ "description": "Creates a new repository for the authenticated user, optionally within an organization if `team id` is specified."
807
+ },
808
+ {
809
+ "slug": "GITHUB_CREATE_A_REPOSITORY_FROM_AN_UNPUBLISHED_CODESPACE",
810
+ "name": "Create a repository from an unpublished codespace",
811
+ "description": "Publishes the specified codespace to a new repository, using the codespace's current state as the initial commit."
812
+ },
813
+ {
814
+ "slug": "GITHUB_CREATE_A_REPOSITORY_PROJECT",
815
+ "name": "Create a repository project",
816
+ "description": "Creates a new classic project board within a specified repository; classic projects must be enabled for the target repository."
817
+ },
818
+ {
819
+ "slug": "GITHUB_CREATE_A_REPOSITORY_RULESET",
820
+ "name": "Create a repository ruleset",
821
+ "description": "Creates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors."
822
+ },
823
+ {
824
+ "slug": "GITHUB_CREATE_A_REPOSITORY_USING_A_TEMPLATE",
825
+ "name": "Create a repository using a template",
826
+ "description": "Creates a new repository from an existing template repository; the authenticated user must have access to the template and, if creating in an organization, repository creation permissions within it."
827
+ },
828
+ {
829
+ "slug": "GITHUB_CREATE_A_REPOSITORY_VARIABLE",
830
+ "name": "Create a repository variable",
831
+ "description": "Creates a new, unencrypted variable in a repository for github actions workflows; fails if a variable with the same name already exists."
832
+ },
833
+ {
834
+ "slug": "GITHUB_CREATE_A_REPOSITORY_WEBHOOK",
835
+ "name": "Create a repository webhook",
836
+ "description": "Creates a webhook for a specified repository; requires admin permissions on the repository."
837
+ },
838
+ {
839
+ "slug": "GITHUB_CREATE_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
840
+ "name": "Create a review comment for a pull request",
841
+ "description": "Creates a review comment on a pull request's diff, targeting a specific line, range of lines, an entire file, or replying to an existing comment."
842
+ },
843
+ {
844
+ "slug": "GITHUB_CREATE_A_REVIEW_FOR_A_PULL_REQUEST",
845
+ "name": "Create a review for a pull request",
846
+ "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`."
847
+ },
848
+ {
849
+ "slug": "GITHUB_CREATE_A_SCOPED_ACCESS_TOKEN",
850
+ "name": "Create a scoped access token",
851
+ "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."
852
+ },
853
+ {
854
+ "slug": "GITHUB_CREATE_A_SNAPSHOT_OF_DEPENDENCIES_FOR_A_REPOSITORY",
855
+ "name": "Create a dependency snapshot",
856
+ "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."
857
+ },
858
+ {
859
+ "slug": "GITHUB_CREATE_A_TAG_OBJECT",
860
+ "name": "Create a tag object",
861
+ "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."
862
+ },
863
+ {
864
+ "slug": "GITHUB_CREATE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORY",
865
+ "name": "Create a tag protection state for a repository",
866
+ "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."
867
+ },
868
+ {
869
+ "slug": "GITHUB_CREATE_A_TEAM",
870
+ "name": "Create a team",
871
+ "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'."
872
+ },
873
+ {
874
+ "slug": "GITHUB_CREATE_A_TEMPORARY_PRIVATE_FORK",
875
+ "name": "Create a temporary private fork",
876
+ "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."
877
+ },
878
+ {
879
+ "slug": "GITHUB_CREATE_A_TREE",
880
+ "name": "Create a tree",
881
+ "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."
882
+ },
883
+ {
884
+ "slug": "GITHUB_CREATE_A_USER_PROJECT",
885
+ "name": "Create a user project",
886
+ "description": "Creates a new github project board for the authenticated user to organize and track issues, pull requests, and notes."
887
+ },
888
+ {
889
+ "slug": "GITHUB_CREATE_A_WORKFLOW_DISPATCH_EVENT",
890
+ "name": "Create a workflow dispatch event",
891
+ "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."
892
+ },
893
+ {
894
+ "slug": "GITHUB_CREATE_COMMIT_SIGNATURE_PROTECTION",
895
+ "name": "Create commit signature protection",
896
+ "description": "Enables commit signature protection for a specified branch, requiring all new commits to be signed."
897
+ },
898
+ {
899
+ "slug": "GITHUB_CREATE_DEPLOYMENT_PROTECTION_RULE",
900
+ "name": "Create a custom deployment protection rule on an environment",
901
+ "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."
902
+ },
903
+ {
904
+ "slug": "GITHUB_CREATE_JIT_RUNNER_CONFIG",
905
+ "name": "Create JIT runner config for repo",
906
+ "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."
907
+ },
908
+ {
909
+ "slug": "GITHUB_CREATE_OR_UPDATE_A_CUSTOM_PROPERTY_FOR_AN_ORGANIZATION",
910
+ "name": "Create or update a custom property for an organization",
911
+ "description": "Creates a new custom property (name must be unique for creation) or updates an existing one for an organization to define metadata for its repositories."
912
+ },
913
+ {
914
+ "slug": "GITHUB_CREATE_OR_UPDATE_AN_ENVIRONMENT",
915
+ "name": "Create or update an environment",
916
+ "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."
917
+ },
918
+ {
919
+ "slug": "GITHUB_CREATE_OR_UPDATE_AN_ENVIRONMENT_SECRET",
920
+ "name": "Create or update an environment secret",
921
+ "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."
922
+ },
923
+ {
924
+ "slug": "GITHUB_CREATE_OR_UPDATE_AN_ORGANIZATION_SECRET",
925
+ "name": "Create or update an organization secret",
926
+ "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."
927
+ },
928
+ {
929
+ "slug": "GITHUB_CREATE_OR_UPDATE_A_REPOSITORY_SECRET",
930
+ "name": "Create or update a repository secret",
931
+ "description": "Creates or updates a github actions secret within a specific repository; use `encrypted value` and `key id` to set or change its value."
932
+ },
933
+ {
934
+ "slug": "GITHUB_CREATE_OR_UPDATE_A_SECRET_FOR_THE_AUTHENTICATED_USER",
935
+ "name": "Create or update a secret for the authenticated user",
936
+ "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."
937
+ },
938
+ {
939
+ "slug": "GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATION",
940
+ "name": "Create or update custom properties for an organization",
941
+ "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`."
942
+ },
943
+ {
944
+ "slug": "GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTY_VALUES_FOR_A_REPOSITORY",
945
+ "name": "Create or update repository custom property values",
946
+ "description": "Creates or updates up to 30 custom property values for a repository; custom properties must be predefined at the organization or repository level, and setting a property's value to `null` removes it."
947
+ },
948
+ {
949
+ "slug": "GITHUB_CREATE_OR_UPDATE_FILE_CONTENTS",
950
+ "name": "Create or update file contents",
951
+ "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."
952
+ },
953
+ {
954
+ "slug": "GITHUB_CREATE_OR_UPDATE_REPO_SECRET_WITH_ENCRYPTED_VALUE",
955
+ "name": "Create or update repo secret with encrypted value",
956
+ "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`."
957
+ },
958
+ {
959
+ "slug": "GITHUB_CREATE_REACTION_FOR_A_COMMIT_COMMENT",
960
+ "name": "Create reaction for a commit comment",
961
+ "description": "Creates an emoji reaction for a commit comment; if the user has already reacted with the same content, details of the existing reaction are returned."
962
+ },
963
+ {
964
+ "slug": "GITHUB_CREATE_REACTION_FOR_AN_ISSUE",
965
+ "name": "Create reaction for an issue",
966
+ "description": "Creates a reaction for a specified issue within a github repository."
967
+ },
968
+ {
969
+ "slug": "GITHUB_CREATE_REACTION_FOR_AN_ISSUE_COMMENT",
970
+ "name": "Create reaction for an issue comment",
971
+ "description": "Creates a reaction for a specific comment on an issue within a github repository."
972
+ },
973
+ {
974
+ "slug": "GITHUB_CREATE_REACTION_FOR_A_PULL_REQUEST_REVIEW_COMMENT",
975
+ "name": "Create reaction for a pull request review comment",
976
+ "description": "Adds a specified reaction to a pull request review comment within a github repository."
977
+ },
978
+ {
979
+ "slug": "GITHUB_CREATE_REACTION_FOR_A_RELEASE",
980
+ "name": "Create reaction for a release",
981
+ "description": "Creates an emoji reaction for a specific, existing release in a github repository."
982
+ },
983
+ {
984
+ "slug": "GITHUB_CREATE_REACTION_FOR_A_TEAM_DISCUSSION",
985
+ "name": "Create reaction for a team discussion",
986
+ "description": "Creates a reaction for a team discussion within a github organization."
987
+ },
988
+ {
989
+ "slug": "GITHUB_CREATE_REACTION_FOR_A_TEAM_DISCUSSION_COMMENT",
990
+ "name": "Create reaction for a team discussion comment",
991
+ "description": "Adds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist."
992
+ },
993
+ {
994
+ "slug": "GITHUB_CREATE_UPDATE_ORG_SECRET_WITH_LIB_SODIUM",
995
+ "name": "Create or Update Organization Secret with LibSodium",
996
+ "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."
997
+ },
998
+ {
999
+ "slug": "GITHUB_CUSTOMIZE_OIDC_SUBJECT_CLAIM_TEMPLATE",
1000
+ "name": "Customize OIDC subject claim template",
1001
+ "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."
1002
+ },
1003
+ {
1004
+ "slug": "GITHUB_CUSTOM_OIDCSUBJECT_CLAIM_TEMPLATE",
1005
+ "name": "Get custom OIDC subject claim template",
1006
+ "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."
1007
+ },
1008
+ {
1009
+ "slug": "GITHUB_CUSTOM_OIDCSUBJECT_CLAIM_TEMPLATE_SETTER",
1010
+ "name": "Set custom OIDC subject claim template",
1011
+ "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`."
1012
+ },
1013
+ {
1014
+ "slug": "GITHUB_DECLINE_A_REPOSITORY_INVITATION",
1015
+ "name": "Decline a repository invitation",
1016
+ "description": "Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation id`."
1017
+ },
1018
+ {
1019
+ "slug": "GITHUB_DELETE_ACCESS_RESTRICTIONS",
1020
+ "name": "Delete access restrictions",
1021
+ "description": "Removes all user, team, and app-based access restrictions from a protected branch."
1022
+ },
1023
+ {
1024
+ "slug": "GITHUB_DELETE_A_CODE_SCANNING_ANALYSIS_FROM_A_REPOSITORY",
1025
+ "name": "Delete a code scanning analysis from a repository",
1026
+ "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."
1027
+ },
1028
+ {
1029
+ "slug": "GITHUB_DELETE_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
1030
+ "name": "Delete a codespace for the authenticated user",
1031
+ "description": "Deletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist."
1032
+ },
1033
+ {
1034
+ "slug": "GITHUB_DELETE_A_CODESPACE_FROM_THE_ORGANIZATION",
1035
+ "name": "Delete a codespace from the organization",
1036
+ "description": "Permanently deletes a specific codespace belonging to a member of the specified organization."
1037
+ },
1038
+ {
1039
+ "slug": "GITHUB_DELETE_A_COMMIT_COMMENT",
1040
+ "name": "Delete a commit comment",
1041
+ "description": "Deletes a specific commit comment, identified by its `comment id`, from the specified repository; the comment must exist."
1042
+ },
1043
+ {
1044
+ "slug": "GITHUB_DELETE_A_COMMIT_COMMENT_REACTION",
1045
+ "name": "Delete a commit comment reaction",
1046
+ "description": "Deletes a reaction from a commit comment in a github repository."
1047
+ },
1048
+ {
1049
+ "slug": "GITHUB_DELETE_A_CUSTOM_ORGANIZATION_ROLE",
1050
+ "name": "Delete a custom organization role",
1051
+ "description": "Deletes a custom organization role (which should not be actively assigned) by its id; a 204 no content response indicates success."
1052
+ },
1053
+ {
1054
+ "slug": "GITHUB_DELETE_A_DEPLOY_KEY",
1055
+ "name": "Delete a deploy key",
1056
+ "description": "Deletes a specific deploy key from a repository; to change a key's properties or access scope, the existing key must be deleted and a new one created."
1057
+ },
1058
+ {
1059
+ "slug": "GITHUB_DELETE_A_DEPLOYMENT",
1060
+ "name": "Delete a deployment",
1061
+ "description": "Permanently deletes a specified *inactive* deployment from a repository."
1062
+ },
1063
+ {
1064
+ "slug": "GITHUB_DELETE_A_DEPLOYMENT_BRANCH_POLICY",
1065
+ "name": "Delete a deployment branch policy",
1066
+ "description": "Deletes a specific deployment branch or tag policy, identified by its id, from a given environment within a repository."
1067
+ },
1068
+ {
1069
+ "slug": "GITHUB_DELETE_A_DISCUSSION",
1070
+ "name": "Delete a discussion",
1071
+ "description": "Deletes a specific team discussion, identified by its number, from an organization's team."
1072
+ },
1073
+ {
1074
+ "slug": "GITHUB_DELETE_A_DISCUSSION_COMMENT",
1075
+ "name": "Delete a discussion comment",
1076
+ "description": "Deletes a specific comment from an existing team discussion within an organization, provided the specified organization, team, discussion, and comment all exist."
1077
+ },
1078
+ {
1079
+ "slug": "GITHUB_DELETE_ADMIN_BRANCH_PROTECTION",
1080
+ "name": "Delete admin branch protection",
1081
+ "description": "Removes admin enforcement from a protected branch (branch name cannot contain wildcard characters) in a repository."
1082
+ },
1083
+ {
1084
+ "slug": "GITHUB_DELETE_A_FILE",
1085
+ "name": "Delete a file",
1086
+ "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."
1087
+ },
1088
+ {
1089
+ "slug": "GITHUB_DELETE_A_GIST",
1090
+ "name": "Delete a gist",
1091
+ "description": "Permanently deletes an existing github gist, specified by its `gist id`; this action is destructive and cannot be undone."
1092
+ },
1093
+ {
1094
+ "slug": "GITHUB_DELETE_A_GIST_COMMENT",
1095
+ "name": "Delete a gist comment",
1096
+ "description": "Deletes a specific comment from a github gist using its `gist id` and `comment id`."
1097
+ },
1098
+ {
1099
+ "slug": "GITHUB_DELETE_A_GITHUB_PAGES_SITE",
1100
+ "name": "Delete a GitHub Pages site",
1101
+ "description": "Deletes the github pages site for the specified repository; completes without error if no site is currently enabled."
1102
+ },
1103
+ {
1104
+ "slug": "GITHUB_DELETE_A_LABEL",
1105
+ "name": "Delete a label",
1106
+ "description": "Permanently removes an existing label from a repository."
1107
+ },
1108
+ {
1109
+ "slug": "GITHUB_DELETE_A_MILESTONE",
1110
+ "name": "Delete a milestone",
1111
+ "description": "Deletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted."
1112
+ },
1113
+ {
1114
+ "slug": "GITHUB_DELETE_AN_APP_AUTHORIZATION",
1115
+ "name": "Delete an app authorization",
1116
+ "description": "Revokes a single, specific oauth access token for an oauth app, not all authorizations for the app."
1117
+ },
1118
+ {
1119
+ "slug": "GITHUB_DELETE_AN_APP_TOKEN",
1120
+ "name": "Delete an app token",
1121
+ "description": "Revokes an oauth access token for a github app, if the app exists and the token was issued to it."
1122
+ },
1123
+ {
1124
+ "slug": "GITHUB_DELETE_AN_ARTIFACT",
1125
+ "name": "Delete an artifact",
1126
+ "description": "Deletes a github artifact by its id within a repository, typically resulting in an empty response (http 204 no content) on success."
1127
+ },
1128
+ {
1129
+ "slug": "GITHUB_DELETE_AN_AUTOLINK_REFERENCE_FROM_A_REPOSITORY",
1130
+ "name": "Delete an autolink reference from a repository",
1131
+ "description": "Deletes a specific autolink reference (which automatically links external resource ids like jira-123 to urls) from the specified repository."
1132
+ },
1133
+ {
1134
+ "slug": "GITHUB_DELETE_AN_EMAIL_ADDRESS_FOR_THE_AUTHENTICATED_USER",
1135
+ "name": "Delete authenticated user email address",
1136
+ "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."
1137
+ },
1138
+ {
1139
+ "slug": "GITHUB_DELETE_AN_ENVIRONMENT",
1140
+ "name": "Delete an environment",
1141
+ "description": "Deletes an existing deployment environment from an existing repository."
1142
+ },
1143
+ {
1144
+ "slug": "GITHUB_DELETE_AN_ENVIRONMENT_SECRET",
1145
+ "name": "Delete an environment secret",
1146
+ "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."
1147
+ },
1148
+ {
1149
+ "slug": "GITHUB_DELETE_AN_ENVIRONMENT_VARIABLE",
1150
+ "name": "Delete an environment variable",
1151
+ "description": "Deletes a named environment variable from a specified, existing environment within a github repository."
1152
+ },
1153
+ {
1154
+ "slug": "GITHUB_DELETE_AN_ISSUE_COMMENT",
1155
+ "name": "Delete an issue comment",
1156
+ "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."
1157
+ },
1158
+ {
1159
+ "slug": "GITHUB_DELETE_AN_ISSUE_COMMENT_REACTION",
1160
+ "name": "Delete an issue comment reaction",
1161
+ "description": "Deletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist."
1162
+ },
1163
+ {
1164
+ "slug": "GITHUB_DELETE_AN_ISSUE_REACTION",
1165
+ "name": "Delete an issue reaction",
1166
+ "description": "Permanently removes a specific reaction from an issue in a github repository."
1167
+ },
1168
+ {
1169
+ "slug": "GITHUB_DELETE_AN_ORGANIZATION",
1170
+ "name": "Delete an organization",
1171
+ "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."
1172
+ },
1173
+ {
1174
+ "slug": "GITHUB_DELETE_AN_ORGANIZATION_SECRET",
1175
+ "name": "Delete an organization secret",
1176
+ "description": "Permanently deletes a secret from a github organization, making it inaccessible to github actions workflows or other tools."
1177
+ },
1178
+ {
1179
+ "slug": "GITHUB_DELETE_AN_ORGANIZATION_VARIABLE",
1180
+ "name": "Delete an organization variable",
1181
+ "description": "Deletes a named github actions variable from a specified organization."
1182
+ },
1183
+ {
1184
+ "slug": "GITHUB_DELETE_AN_ORGANIZATION_WEBHOOK",
1185
+ "name": "Delete an organization webhook",
1186
+ "description": "Deletes a specific webhook, identified by `hook id`, from an existing organization."
1187
+ },
1188
+ {
1189
+ "slug": "GITHUB_DELETE_A_PACKAGE_FOR_AN_ORGANIZATION",
1190
+ "name": "Delete a package for an organization",
1191
+ "description": "Deletes a specific package in an organization; cannot delete public packages with over 5,000 downloads."
1192
+ },
1193
+ {
1194
+ "slug": "GITHUB_DELETE_A_PACKAGE_FOR_A_USER",
1195
+ "name": "Delete a package for a user",
1196
+ "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."
1197
+ },
1198
+ {
1199
+ "slug": "GITHUB_DELETE_A_PACKAGE_FOR_THE_AUTHENTICATED_USER",
1200
+ "name": "Delete a package for the authenticated user",
1201
+ "description": "Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this api."
1202
+ },
1203
+ {
1204
+ "slug": "GITHUB_DELETE_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USER",
1205
+ "name": "Delete a package version for the authenticated user",
1206
+ "description": "Deletes an existing package version associated with the authenticated user."
1207
+ },
1208
+ {
1209
+ "slug": "GITHUB_DELETE_A_PENDING_REVIEW_FOR_A_PULL_REQUEST",
1210
+ "name": "Delete a pending review for a pull request",
1211
+ "description": "Deletes a pending (unsubmitted) review from a pull request; this is only possible if the review has not yet been submitted."
1212
+ },
1213
+ {
1214
+ "slug": "GITHUB_DELETE_A_PROJECT",
1215
+ "name": "Delete a project",
1216
+ "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."
1217
+ },
1218
+ {
1219
+ "slug": "GITHUB_DELETE_A_PROJECT_CARD",
1220
+ "name": "Delete a project card",
1221
+ "description": "Deletes a project card from a github 'project (classic)'; this operation is idempotent."
1222
+ },
1223
+ {
1224
+ "slug": "GITHUB_DELETE_A_PROJECT_COLUMN",
1225
+ "name": "Delete a project column",
1226
+ "description": "Deletes a project column by its id from a github project (classic); this is a destructive operation."
1227
+ },
1228
+ {
1229
+ "slug": "GITHUB_DELETE_A_PULL_REQUEST_COMMENT_REACTION",
1230
+ "name": "Delete a pull request comment reaction",
1231
+ "description": "Deletes a specific reaction from a pull request review comment, provided the comment and reaction exist on that comment within the specified repository."
1232
+ },
1233
+ {
1234
+ "slug": "GITHUB_DELETE_A_REFERENCE",
1235
+ "name": "Delete a reference",
1236
+ "description": "Deletes a git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag')."
1237
+ },
1238
+ {
1239
+ "slug": "GITHUB_DELETE_A_RELEASE",
1240
+ "name": "Delete a release",
1241
+ "description": "Permanently deletes a specific release, its assets, and potentially its associated git tag from a repository."
1242
+ },
1243
+ {
1244
+ "slug": "GITHUB_DELETE_A_RELEASE_ASSET",
1245
+ "name": "Delete a release asset",
1246
+ "description": "Deletes a specific release asset from a github repository; this action is idempotent."
1247
+ },
1248
+ {
1249
+ "slug": "GITHUB_DELETE_A_RELEASE_REACTION",
1250
+ "name": "Delete a release reaction",
1251
+ "description": "Deletes a reaction from a github release, provided the repository, release, and reaction exist."
1252
+ },
1253
+ {
1254
+ "slug": "GITHUB_DELETE_A_REPOSITORY",
1255
+ "name": "Delete a repository",
1256
+ "description": "Permanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository."
1257
+ },
1258
+ {
1259
+ "slug": "GITHUB_DELETE_A_REPOSITORY_INVITATION",
1260
+ "name": "Delete a repository invitation",
1261
+ "description": "Deletes an active repository invitation, permanently revoking a user's access to collaborate on the specified repository."
1262
+ },
1263
+ {
1264
+ "slug": "GITHUB_DELETE_A_REPOSITORY_RULESET",
1265
+ "name": "Delete a repository ruleset",
1266
+ "description": "Permanently deletes a repository ruleset."
1267
+ },
1268
+ {
1269
+ "slug": "GITHUB_DELETE_A_REPOSITORY_SECRET",
1270
+ "name": "Delete a repository secret",
1271
+ "description": "Deletes a named github actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist."
1272
+ },
1273
+ {
1274
+ "slug": "GITHUB_DELETE_A_REPOSITORY_SUBSCRIPTION",
1275
+ "name": "Delete a repository subscription",
1276
+ "description": "Deletes the authenticated user's subscription to a specified repository if it exists, effectively 'unwatching' it."
1277
+ },
1278
+ {
1279
+ "slug": "GITHUB_DELETE_A_REPOSITORY_VARIABLE",
1280
+ "name": "Delete a repository variable",
1281
+ "description": "Deletes a named variable (e.g., for github actions workflows) from a repository; the repository and the variable must already exist."
1282
+ },
1283
+ {
1284
+ "slug": "GITHUB_DELETE_A_REPOSITORY_WEBHOOK",
1285
+ "name": "Delete a repository webhook",
1286
+ "description": "Deletes a specific webhook from a repository."
1287
+ },
1288
+ {
1289
+ "slug": "GITHUB_DELETE_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
1290
+ "name": "Delete a review comment for a pull request",
1291
+ "description": "Deletes a specific pull request review comment."
1292
+ },
1293
+ {
1294
+ "slug": "GITHUB_DELETE_A_SECRET_FOR_THE_AUTHENTICATED_USER",
1295
+ "name": "Delete a secret for the authenticated user",
1296
+ "description": "Deletes an existing codespaces secret for the authenticated user by `secret name`; this is a destructive, irreversible, and idempotent operation."
1297
+ },
1298
+ {
1299
+ "slug": "GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_AN_ORGANIZATION",
1300
+ "name": "Delete a self hosted runner from an organization",
1301
+ "description": "Deletes an existing and registered self-hosted runner from an organization, typically returning 204 no content on success."
1302
+ },
1303
+ {
1304
+ "slug": "GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_A_REPOSITORY",
1305
+ "name": "Delete a self hosted runner from a repository",
1306
+ "description": "Removes a specific self-hosted runner (by `runner id`) from a repository, if registered there; this is idempotent."
1307
+ },
1308
+ {
1309
+ "slug": "GITHUB_DELETE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORY",
1310
+ "name": "Delete a tag protection state for a repository",
1311
+ "description": "Permanently deletes a specific tag protection rule, identified by its id, from the given repository."
1312
+ },
1313
+ {
1314
+ "slug": "GITHUB_DELETE_A_TEAM",
1315
+ "name": "Delete a team",
1316
+ "description": "Deletes a team (and any child teams) from an organization."
1317
+ },
1318
+ {
1319
+ "slug": "GITHUB_DELETE_A_THREAD_SUBSCRIPTION",
1320
+ "name": "Delete a thread subscription",
1321
+ "description": "Call this to mute a specific notification thread by deleting the user's subscription; notifications may still occur if the user is @mentioned, comments, or due to repository watch settings."
1322
+ },
1323
+ {
1324
+ "slug": "GITHUB_DELETE_A_WORKFLOW_RUN",
1325
+ "name": "Delete a workflow run",
1326
+ "description": "Deletes a specific workflow run from a repository."
1327
+ },
1328
+ {
1329
+ "slug": "GITHUB_DELETE_BRANCH_PROTECTION",
1330
+ "name": "Delete branch protection",
1331
+ "description": "Removes all protection rules from a specific branch in a github repository; the branch must currently have protection rules enabled."
1332
+ },
1333
+ {
1334
+ "slug": "GITHUB_DELETE_COMMIT_SIGNATURE_PROTECTION",
1335
+ "name": "Delete commit signature protection",
1336
+ "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."
1337
+ },
1338
+ {
1339
+ "slug": "GITHUB_DELETE_DEPENDEBOT_SECRET_BY_NAME",
1340
+ "name": "Delete dependabot secret by name",
1341
+ "description": "Deletes a specific dependabot secret, identified by its name, from a given repository if both the repository and secret exist."
1342
+ },
1343
+ {
1344
+ "slug": "GITHUB_DELETE_GITHUB_ACTIONS_CACHE_BY_ID",
1345
+ "name": "Delete GitHub Actions cache by ID",
1346
+ "description": "Deletes a specific github actions cache from a repository using its unique `cache id`."
1347
+ },
1348
+ {
1349
+ "slug": "GITHUB_DELETE_PACKAGE_VERSION_FOR_AN_ORGANIZATION",
1350
+ "name": "Delete package version for an organization",
1351
+ "description": "Deletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads."
1352
+ },
1353
+ {
1354
+ "slug": "GITHUB_DELETE_PACKAGE_VERSION_FOR_A_USER",
1355
+ "name": "Delete package version for a user",
1356
+ "description": "Permanently and irreversibly deletes a specific version of a package owned by the specified user."
1357
+ },
1358
+ {
1359
+ "slug": "GITHUB_DELETE_PULL_REQUEST_REVIEW_PROTECTION",
1360
+ "name": "Delete pull request review protection",
1361
+ "description": "Disables the requirement for pull request reviews before merging for a specific, existing branch in an existing repository; this action is idempotent and will succeed even if the protection is not currently enabled."
1362
+ },
1363
+ {
1364
+ "slug": "GITHUB_DELETE_REPO_CODESPACE_SECRET_BY_NAME",
1365
+ "name": "Delete repo codespace secret by name",
1366
+ "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."
1367
+ },
1368
+ {
1369
+ "slug": "GITHUB_DELETE_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER",
1370
+ "name": "Delete social accounts for the authenticated user",
1371
+ "description": "Deletes currently linked social media account urls from the authenticated user's github profile."
1372
+ },
1373
+ {
1374
+ "slug": "GITHUB_DELETE_TEAM_DISCUSSION_COMMENT_REACTION",
1375
+ "name": "Delete team discussion comment reaction",
1376
+ "description": "Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction id."
1377
+ },
1378
+ {
1379
+ "slug": "GITHUB_DELETE_TEAM_DISCUSSION_REACTION",
1380
+ "name": "Delete team discussion reaction",
1381
+ "description": "Permanently deletes a specific reaction from a team discussion within an organization."
1382
+ },
1383
+ {
1384
+ "slug": "GITHUB_DELETE_WORKFLOW_RUN_LOGS",
1385
+ "name": "Delete workflow run logs",
1386
+ "description": "Deletes all logs for a specific workflow run in a github repository, provided the repository and run exist."
1387
+ },
1388
+ {
1389
+ "slug": "GITHUB_DISABLE_A_CUSTOM_PROTECTION_RULE_FOR_AN_ENVIRONMENT",
1390
+ "name": "Disable a custom protection rule for an environment",
1391
+ "description": "Disables a specific, currently active custom deployment protection rule for an existing environment within a github repository."
1392
+ },
1393
+ {
1394
+ "slug": "GITHUB_DISABLE_A_WORKFLOW",
1395
+ "name": "Disable a workflow",
1396
+ "description": "Disables a specified workflow (by id or filename) in a given github repository, preventing new automatic triggers; any in-progress runs will continue."
1397
+ },
1398
+ {
1399
+ "slug": "GITHUB_DISABLE_PRIVATE_VULNERABILITY_REPORTING_FOR_A_REPOSITORY",
1400
+ "name": "Disable private vulnerability reporting for a repository",
1401
+ "description": "Disables private vulnerability reporting for an existing github repository, preventing direct private vulnerability reports to maintainers via github's interface for this repository."
1402
+ },
1403
+ {
1404
+ "slug": "GITHUB_DISABLE_REPOSITORY_ACTIONS_IN_ORG",
1405
+ "name": "Disablerepositoryactionsinorg",
1406
+ "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`."
1407
+ },
1408
+ {
1409
+ "slug": "GITHUB_DISMISS_A_REVIEW_FOR_A_PULL_REQUEST",
1410
+ "name": "Dismiss a review for a pull request",
1411
+ "description": "Dismisses a review on a pull request with a mandatory explanatory message."
1412
+ },
1413
+ {
1414
+ "slug": "GITHUB_DOWNLOAD_AN_ARTIFACT",
1415
+ "name": "Download an artifact",
1416
+ "description": "Downloads a specific github repository artifact, returning a temporary url to its 'zip' archive, valid for one minute."
1417
+ },
1418
+ {
1419
+ "slug": "GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_TAR",
1420
+ "name": "Download a repository tarball",
1421
+ "description": "Downloads a repository's source code as a tarball (.tar.gz) archive for a specific git reference, if the repository is accessible."
1422
+ },
1423
+ {
1424
+ "slug": "GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_ZIP",
1425
+ "name": "Download a repository archive ZIP",
1426
+ "description": "Downloads a repository's source code as a zip archive for a specific git reference (branch, tag, or commit sha)."
1427
+ },
1428
+ {
1429
+ "slug": "GITHUB_DOWNLOAD_JOB_LOGS_FOR_A_WORKFLOW_RUN",
1430
+ "name": "Download job logs for a workflow run",
1431
+ "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."
1432
+ },
1433
+ {
1434
+ "slug": "GITHUB_DOWNLOAD_WORKFLOW_RUN_ATTEMPT_LOGS",
1435
+ "name": "Download workflow run attempt logs",
1436
+ "description": "Downloads a zip archive of logs for a specific workflow run attempt."
1437
+ },
1438
+ {
1439
+ "slug": "GITHUB_DOWNLOAD_WORKFLOW_RUN_LOGS",
1440
+ "name": "Download workflow run logs",
1441
+ "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)."
1442
+ },
1443
+ {
1444
+ "slug": "GITHUB_EMO_J_IS_GET",
1445
+ "name": "Get emojis",
1446
+ "description": "Lists all emojis available for use on github; deprecated, use `get emojis` instead."
1447
+ },
1448
+ {
1449
+ "slug": "GITHUB_ENABLE_A_WORKFLOW",
1450
+ "name": "Enable a workflow",
1451
+ "description": "Reactivates a currently disabled github actions workflow within a repository using its numerical id."
1452
+ },
1453
+ {
1454
+ "slug": "GITHUB_ENABLE_GITHUB_ACTIONS_IN_SELECTED_REPOSITORIES",
1455
+ "name": "Enable GitHub actions in selected repositories",
1456
+ "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'."
1457
+ },
1458
+ {
1459
+ "slug": "GITHUB_ENABLE_PRIVATE_VULNERABILITY_REPORTING_FOR_A_REPOSITORY",
1460
+ "name": "Enable private vulnerability reporting for a repository",
1461
+ "description": "Enables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers."
1462
+ },
1463
+ {
1464
+ "slug": "GITHUB_ENABLE_REPO_FORGITHUB_ACTIONS",
1465
+ "name": "Enable repo for Github Actions",
1466
+ "description": "Enables github actions for a repository if the organization's actions permissions are set to allow for 'selected repositories'."
1467
+ },
1468
+ {
1469
+ "slug": "GITHUB_ENCRYPT_AND_UPDATE_DEV_SECRET",
1470
+ "name": "Encrypt and update dev secret",
1471
+ "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."
1472
+ },
1473
+ {
1474
+ "slug": "GITHUB_ENCRYPT_ORG_DEV_ENV_SECRET",
1475
+ "name": "Encrypt org dev env secret",
1476
+ "description": "Creates or updates an organization's github codespaces secret using an encrypted value and its corresponding public key id."
1477
+ },
1478
+ {
1479
+ "slug": "GITHUB_ENCRYPT_ORG_SECRETS_USING_PUBLIC_KEY",
1480
+ "name": "Encrypt org secrets using public key",
1481
+ "description": "Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for codespaces."
1482
+ },
1483
+ {
1484
+ "slug": "GITHUB_EXPORT_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
1485
+ "name": "Export a codespace for the authenticated user",
1486
+ "description": "Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download url."
1487
+ },
1488
+ {
1489
+ "slug": "GITHUB_EXPORT_A_SOFTWARE_BILL_OF_MATERIALS_SBOM_FOR_A_REPOSITORY",
1490
+ "name": "Export an SBOM for a repository",
1491
+ "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."
1492
+ },
1493
+ {
1494
+ "slug": "GITHUB_FETCH_PUBLIC_KEY_FOR_SECRET_ENCRYPTION",
1495
+ "name": "Fetchpublickeyforsecretencryption",
1496
+ "description": "Retrieves the public key for an existing github organization, required for encrypting dependabot secrets."
1497
+ },
1498
+ {
1499
+ "slug": "GITHUB_FIND_PULL_REQUESTS",
1500
+ "name": "Find Pull Requests",
1501
+ "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."
1502
+ },
1503
+ {
1504
+ "slug": "GITHUB_FIND_REPOSITORIES",
1505
+ "name": "Find Repositories",
1506
+ "description": "Ai-optimized repository search with smart filtering by language, stars, topics, and ownership. builds intelligent search queries and returns clean, actionable repository data."
1507
+ },
1508
+ {
1509
+ "slug": "GITHUB_FOLLOW_A_USER",
1510
+ "name": "Follow a user",
1511
+ "description": "Allows the authenticated user to follow the github user specified by `username`; this action is idempotent and the user cannot follow themselves."
1512
+ },
1513
+ {
1514
+ "slug": "GITHUB_FORCE_CANCEL_A_WORKFLOW_RUN",
1515
+ "name": "Force cancel a workflow run",
1516
+ "description": "Forcefully cancels an existing github actions workflow run, bypassing normal cancellation conditions; requires write permissions to the repository."
1517
+ },
1518
+ {
1519
+ "slug": "GITHUB_FORK_A_GIST",
1520
+ "name": "Fork a gist",
1521
+ "description": "Forks a specified public gist, creating a copy under the authenticated user's account."
1522
+ },
1523
+ {
1524
+ "slug": "GITHUB_GENERATE_RELEASE_NOTES_CONTENT_FOR_A_RELEASE",
1525
+ "name": "Generate release notes content for a release",
1526
+ "description": "Generates markdown release notes content (listing changes, pull requests, and contributors) for a github repository release, customizable via tags and a configuration file."
1527
+ },
1528
+ {
1529
+ "slug": "GITHUB_GET_A_BLOB",
1530
+ "name": "Get a blob",
1531
+ "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."
1532
+ },
1533
+ {
1534
+ "slug": "GITHUB_GET_A_BRANCH",
1535
+ "name": "Get a branch",
1536
+ "description": "Retrieves detailed information for a specified branch within a github repository."
1537
+ },
1538
+ {
1539
+ "slug": "GITHUB_GET_ACCESS_RESTRICTIONS",
1540
+ "name": "Get access restrictions",
1541
+ "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."
1542
+ },
1543
+ {
1544
+ "slug": "GITHUB_GET_A_CHECK_RUN",
1545
+ "name": "Get a check run",
1546
+ "description": "Retrieves detailed information for a specific check run within a github repository."
1547
+ },
1548
+ {
1549
+ "slug": "GITHUB_GET_A_CHECK_SUITE",
1550
+ "name": "Get a check suite",
1551
+ "description": "Retrieves a specific check suite (a collection of check runs) by its id from a repository accessible to the authenticated user."
1552
+ },
1553
+ {
1554
+ "slug": "GITHUB_GET_A_CLASSROOM",
1555
+ "name": "Get a classroom",
1556
+ "description": "Retrieves details for a specific github classroom; the classroom id must correspond to an existing classroom."
1557
+ },
1558
+ {
1559
+ "slug": "GITHUB_GET_A_CODE_OF_CONDUCT",
1560
+ "name": "Get a code of conduct",
1561
+ "description": "Retrieves the full details of a specific github code of conduct using its unique key."
1562
+ },
1563
+ {
1564
+ "slug": "GITHUB_GET_A_CODE_QL_DATABASE_FOR_A_REPOSITORY",
1565
+ "name": "Get a CodeQL database for a repository",
1566
+ "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."
1567
+ },
1568
+ {
1569
+ "slug": "GITHUB_GET_A_CODE_SCANNING_ALERT",
1570
+ "name": "Get a code scanning alert",
1571
+ "description": "Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified github repository."
1572
+ },
1573
+ {
1574
+ "slug": "GITHUB_GET_A_CODE_SCANNING_ANALYSIS_FOR_A_REPOSITORY",
1575
+ "name": "Get a code scanning analysis for a repository",
1576
+ "description": "Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis id`."
1577
+ },
1578
+ {
1579
+ "slug": "GITHUB_GET_A_CODE_SCANNING_DEFAULT_SETUP_CONFIGURATION",
1580
+ "name": "Get a code scanning default setup configuration",
1581
+ "description": "Gets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists."
1582
+ },
1583
+ {
1584
+ "slug": "GITHUB_GET_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
1585
+ "name": "Get a codespace for the authenticated user",
1586
+ "description": "Call to retrieve detailed information for a `codespace name` belonging to the authenticated user, ensuring the codespace exists and is accessible."
1587
+ },
1588
+ {
1589
+ "slug": "GITHUB_GET_A_COMMIT",
1590
+ "name": "Get a commit",
1591
+ "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."
1592
+ },
1593
+ {
1594
+ "slug": "GITHUB_GET_A_COMMIT_COMMENT",
1595
+ "name": "Get a commit comment",
1596
+ "description": "Retrieves the full details of a specific commit comment in a github repository, using its unique identifier."
1597
+ },
1598
+ {
1599
+ "slug": "GITHUB_GET_A_COMMIT_OBJECT",
1600
+ "name": "Get a commit object",
1601
+ "description": "Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a github repository, identified by its sha."
1602
+ },
1603
+ {
1604
+ "slug": "GITHUB_GET_A_CUSTOM_DEPLOYMENT_PROTECTION_RULE",
1605
+ "name": "Get a custom deployment protection rule",
1606
+ "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."
1607
+ },
1608
+ {
1609
+ "slug": "GITHUB_GET_A_CUSTOM_PROPERTY_FOR_AN_ORGANIZATION",
1610
+ "name": "Get a custom property for an organization",
1611
+ "description": "Retrieves the definition (schema) of a specific, existing custom property for an organization."
1612
+ },
1613
+ {
1614
+ "slug": "GITHUB_GET_A_DELIVERY_FOR_A_REPOSITORY_WEBHOOK",
1615
+ "name": "Get a delivery for a repository webhook",
1616
+ "description": "Retrieves a specific delivery for a repository webhook, identified by its `hook id` and `delivery id`."
1617
+ },
1618
+ {
1619
+ "slug": "GITHUB_GET_A_DEPLOY_KEY",
1620
+ "name": "Get a deploy key",
1621
+ "description": "Gets a specific deploy key, identified by its `key id`, for the github repository specified by `owner` and `repo`."
1622
+ },
1623
+ {
1624
+ "slug": "GITHUB_GET_A_DEPLOYMENT",
1625
+ "name": "Get a deployment",
1626
+ "description": "Gets a specific deployment by id from a repository, provided the repository and deployment id exist."
1627
+ },
1628
+ {
1629
+ "slug": "GITHUB_GET_A_DEPLOYMENT_BRANCH_POLICY",
1630
+ "name": "Get a deployment branch policy",
1631
+ "description": "Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique id."
1632
+ },
1633
+ {
1634
+ "slug": "GITHUB_GET_A_DEPLOYMENT_STATUS",
1635
+ "name": "Get a deployment status",
1636
+ "description": "Retrieves a specific deployment status by its id for a given deployment within a github repository."
1637
+ },
1638
+ {
1639
+ "slug": "GITHUB_GET_A_DIFF_OF_THE_DEPENDENCIES_BETWEEN_COMMITS",
1640
+ "name": "Get a diff of the dependencies between commits",
1641
+ "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."
1642
+ },
1643
+ {
1644
+ "slug": "GITHUB_GET_A_DISCUSSION",
1645
+ "name": "Get a discussion",
1646
+ "description": "Fetches a specific discussion by its number from a team within an organization."
1647
+ },
1648
+ {
1649
+ "slug": "GITHUB_GET_A_DISCUSSION_COMMENT",
1650
+ "name": "Get a discussion comment",
1651
+ "description": "Fetches a specific comment from a team discussion within a specific organization."
1652
+ },
1653
+ {
1654
+ "slug": "GITHUB_GET_ADMIN_BRANCH_PROTECTION",
1655
+ "name": "Get admin branch protection",
1656
+ "description": "Checks if repository administrators are subject to the branch protection rules on a specific branch."
1657
+ },
1658
+ {
1659
+ "slug": "GITHUB_GET_A_DNS_HEALTH_CHECK_FOR_GITHUB_PAGES",
1660
+ "name": "Get a dns health check for github pages",
1661
+ "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."
1662
+ },
1663
+ {
1664
+ "slug": "GITHUB_GET_A_GIST",
1665
+ "name": "Get a gist",
1666
+ "description": "Fetches a specific github gist by its `gist id`, returning comprehensive details if the gist exists."
1667
+ },
1668
+ {
1669
+ "slug": "GITHUB_GET_A_GIST_COMMENT",
1670
+ "name": "Get a gist comment",
1671
+ "description": "Retrieves a specific gist comment by its id and the gist's id."
1672
+ },
1673
+ {
1674
+ "slug": "GITHUB_GET_A_GIST_REVISION",
1675
+ "name": "Get a gist revision",
1676
+ "description": "Retrieves a specific revision of a gist."
1677
+ },
1678
+ {
1679
+ "slug": "GITHUB_GET_A_GITHUB_PAGES_SITE",
1680
+ "name": "Get a GitHub Pages site",
1681
+ "description": "Retrieves information for a github pages site, which must be enabled for the repository."
1682
+ },
1683
+ {
1684
+ "slug": "GITHUB_GET_A_GITIGNORE_TEMPLATE",
1685
+ "name": "Get a gitignore template",
1686
+ "description": "Retrieves a specific .gitignore template from github by its name, which must be an existing template in github's collection."
1687
+ },
1688
+ {
1689
+ "slug": "GITHUB_GET_A_JOB_FOR_A_WORKFLOW_RUN",
1690
+ "name": "Get a job for a workflow run",
1691
+ "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."
1692
+ },
1693
+ {
1694
+ "slug": "GITHUB_GET_A_LABEL",
1695
+ "name": "Get a label",
1696
+ "description": "Retrieves a specific label by its name from a specified github repository."
1697
+ },
1698
+ {
1699
+ "slug": "GITHUB_GET_A_LICENSE",
1700
+ "name": "Get a license",
1701
+ "description": "Call this action to retrieve comprehensive details for a specific software license recognized by github, using its unique license key."
1702
+ },
1703
+ {
1704
+ "slug": "GITHUB_GET_ALL_API_VERSIONS",
1705
+ "name": "Get all API versions",
1706
+ "description": "Retrieves all officially supported, date-based (e.g., \"2022-11-28\") versions of the github rest api from the /versions endpoint."
1707
+ },
1708
+ {
1709
+ "slug": "GITHUB_GET_ALL_AUTOLINKS_OF_A_REPOSITORY",
1710
+ "name": "Get all autolinks of a repository",
1711
+ "description": "Retrieves all autolinks (e.g., for jira issues) configured for a repository; requires admin permissions on the repository."
1712
+ },
1713
+ {
1714
+ "slug": "GITHUB_GET_ALL_CODES_OF_CONDUCT",
1715
+ "name": "Get all codes of conduct",
1716
+ "description": "Retrieves all available codes of conduct from github, often used to select one for a repository."
1717
+ },
1718
+ {
1719
+ "slug": "GITHUB_GET_ALL_COMMONLY_USED_LICENSES",
1720
+ "name": "Get all commonly used licenses",
1721
+ "description": "Retrieves a list of commonly used software licenses from github, optionally filtering for 'featured' licenses whose specific selection criteria by github may vary."
1722
+ },
1723
+ {
1724
+ "slug": "GITHUB_GET_ALL_CONTRIBUTOR_COMMIT_ACTIVITY",
1725
+ "name": "Get all contributor commit activity",
1726
+ "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."
1727
+ },
1728
+ {
1729
+ "slug": "GITHUB_GET_ALL_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATION",
1730
+ "name": "Get all custom properties for an organization",
1731
+ "description": "Gets the schema definitions for all custom properties configured for an organization, not the specific values assigned to repositories."
1732
+ },
1733
+ {
1734
+ "slug": "GITHUB_GET_ALL_CUSTOM_PROPERTY_VALUES_FOR_A_REPOSITORY",
1735
+ "name": "Get all custom property values for a repository",
1736
+ "description": "Gets all custom property values for a repository, which may include default values or be empty if no properties are explicitly set."
1737
+ },
1738
+ {
1739
+ "slug": "GITHUB_GET_ALL_DEPLOYMENT_PROTECTION_RULES_FOR_AN_ENVIRONMENT",
1740
+ "name": "Get all deployment protection rules for an environment",
1741
+ "description": "Lists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments."
1742
+ },
1743
+ {
1744
+ "slug": "GITHUB_GET_ALL_GITIGNORE_TEMPLATES",
1745
+ "name": "Get all gitignore templates",
1746
+ "description": "Retrieves all available .gitignore template names from github (e.g., 'python', 'node', 'java'), used for generating .gitignore files."
1747
+ },
1748
+ {
1749
+ "slug": "GITHUB_GET_ALL_ORGANIZATION_ROLES_FOR_AN_ORGANIZATION",
1750
+ "name": "Get all organization roles for an organization",
1751
+ "description": "Lists all custom organization roles for an existing github organization."
1752
+ },
1753
+ {
1754
+ "slug": "GITHUB_GET_ALL_REPOSITORY_RULESETS",
1755
+ "name": "Get all repository rulesets",
1756
+ "description": "Retrieves all rulesets for a github repository, which define conditions and actions for repository interactions (e.g., branch protections)."
1757
+ },
1758
+ {
1759
+ "slug": "GITHUB_GET_ALL_REPOSITORY_TOPICS",
1760
+ "name": "Get all repository topics",
1761
+ "description": "Retrieves all topics for a specified, existing, and accessible repository."
1762
+ },
1763
+ {
1764
+ "slug": "GITHUB_GET_ALL_REQUESTED_REVIEWERS_FOR_A_PULL_REQUEST",
1765
+ "name": "Get all requested reviewers for a pull request",
1766
+ "description": "Gets all users and teams requested to review a specific pull request in a repository."
1767
+ },
1768
+ {
1769
+ "slug": "GITHUB_GET_ALL_STATUS_CHECK_CONTEXTS",
1770
+ "name": "Get all status check contexts",
1771
+ "description": "Fetches all required status check contexts for a protected branch; returns an empty list if the branch isn't protected or has no required checks."
1772
+ },
1773
+ {
1774
+ "slug": "GITHUB_GET_A_MILESTONE",
1775
+ "name": "Get a milestone",
1776
+ "description": "Retrieves detailed information for a specific milestone within a github repository by its number."
1777
+ },
1778
+ {
1779
+ "slug": "GITHUB_GET_AN_APP",
1780
+ "name": "Get an app",
1781
+ "description": "Retrieves publicly available information for an existing github app, identified by its unique url-friendly `app slug`."
1782
+ },
1783
+ {
1784
+ "slug": "GITHUB_GET_AN_ARTIFACT",
1785
+ "name": "Get an artifact",
1786
+ "description": "Gets a specific artifact for a repository by `artifact id`."
1787
+ },
1788
+ {
1789
+ "slug": "GITHUB_GET_AN_ASSIGNMENT",
1790
+ "name": "Get an assignment",
1791
+ "description": "Retrieves detailed information for a specific github classroom assignment if the authenticated user is an administrator of the classroom."
1792
+ },
1793
+ {
1794
+ "slug": "GITHUB_GET_AN_AUTOLINK_REFERENCE_OF_A_REPOSITORY",
1795
+ "name": "Get an autolink reference of a repository",
1796
+ "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."
1797
+ },
1798
+ {
1799
+ "slug": "GITHUB_GET_AN_ENVIRONMENT",
1800
+ "name": "Get an environment",
1801
+ "description": "Get an environment"
1802
+ },
1803
+ {
1804
+ "slug": "GITHUB_GET_AN_ENVIRONMENT_PUBLIC_KEY",
1805
+ "name": "Get an environment public key",
1806
+ "description": "Retrieves the public key for a specified github repository environment, used to encrypt secrets for github actions."
1807
+ },
1808
+ {
1809
+ "slug": "GITHUB_GET_AN_ENVIRONMENT_SECRET",
1810
+ "name": "Get an environment secret",
1811
+ "description": "Get an environment secret"
1812
+ },
1813
+ {
1814
+ "slug": "GITHUB_GET_AN_ENVIRONMENT_VARIABLE",
1815
+ "name": "Get an environment variable",
1816
+ "description": "Get an environment variable"
1817
+ },
1818
+ {
1819
+ "slug": "GITHUB_GET_AN_ISSUE",
1820
+ "name": "Get an issue",
1821
+ "description": "Get an issue"
1822
+ },
1823
+ {
1824
+ "slug": "GITHUB_GET_AN_ISSUE_COMMENT",
1825
+ "name": "Get an issue comment",
1826
+ "description": "Get an issue comment"
1827
+ },
1828
+ {
1829
+ "slug": "GITHUB_GET_AN_ISSUE_EVENT",
1830
+ "name": "Get an issue event",
1831
+ "description": "Get an issue event"
1832
+ },
1833
+ {
1834
+ "slug": "GITHUB_GET_AN_ORGANIZATION",
1835
+ "name": "Get an organization",
1836
+ "description": "Get an organization"
1837
+ },
1838
+ {
1839
+ "slug": "GITHUB_GET_AN_ORGANIZATION_PUBLIC_KEY",
1840
+ "name": "Get an organization public key",
1841
+ "description": "Get an organization public key"
1842
+ },
1843
+ {
1844
+ "slug": "GITHUB_GET_AN_ORGANIZATION_ROLE",
1845
+ "name": "Get an organization role",
1846
+ "description": "Retrieves a specific github organization role by its id."
1847
+ },
1848
+ {
1849
+ "slug": "GITHUB_GET_AN_ORGANIZATION_SECRET",
1850
+ "name": "Get an organization secret",
1851
+ "description": "Gets an organization secret's metadata (e.g., name, creation/update dates, visibility), but not its encrypted value."
1852
+ },
1853
+ {
1854
+ "slug": "GITHUB_GET_AN_ORGANIZATION_VARIABLE",
1855
+ "name": "Get an organization variable",
1856
+ "description": "Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing github organization."
1857
+ },
1858
+ {
1859
+ "slug": "GITHUB_GET_AN_ORGANIZATION_WEBHOOK",
1860
+ "name": "Get an organization webhook",
1861
+ "description": "Retrieves the full configuration, including subscribed events and delivery settings, for an existing organization webhook."
1862
+ },
1863
+ {
1864
+ "slug": "GITHUB_GET_A_PACKAGE_FOR_AN_ORGANIZATION",
1865
+ "name": "Get a package for an organization",
1866
+ "description": "Retrieves a specific package (by type and name) from an organization, if both the package and organization exist."
1867
+ },
1868
+ {
1869
+ "slug": "GITHUB_GET_A_PACKAGE_FOR_A_USER",
1870
+ "name": "Get a package for a user",
1871
+ "description": "Retrieves metadata for a specific package owned by a github user, using package type, name, and username as identifiers."
1872
+ },
1873
+ {
1874
+ "slug": "GITHUB_GET_A_PACKAGE_FOR_THE_AUTHENTICATED_USER",
1875
+ "name": "Get a package for the authenticated user",
1876
+ "description": "Retrieves detailed information for a specific package owned by the authenticated user."
1877
+ },
1878
+ {
1879
+ "slug": "GITHUB_GET_A_PACKAGE_VERSION_FOR_AN_ORGANIZATION",
1880
+ "name": "Get a package version for an organization",
1881
+ "description": "Retrieves detailed information for a specific version of a package within an organization."
1882
+ },
1883
+ {
1884
+ "slug": "GITHUB_GET_A_PACKAGE_VERSION_FOR_A_USER",
1885
+ "name": "Get a package version for a user",
1886
+ "description": "Retrieves a specific public package version associated with a github user."
1887
+ },
1888
+ {
1889
+ "slug": "GITHUB_GET_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USER",
1890
+ "name": "Get authenticated user package version",
1891
+ "description": "Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version id."
1892
+ },
1893
+ {
1894
+ "slug": "GITHUB_GET_APPS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
1895
+ "name": "Get apps with access to the protected branch",
1896
+ "description": "Lists github apps with push access to a repository's protected branch."
1897
+ },
1898
+ {
1899
+ "slug": "GITHUB_GET_A_PROJECT",
1900
+ "name": "Get a project",
1901
+ "description": "Retrieves detailed information for a specific github project using its unique `project id`."
1902
+ },
1903
+ {
1904
+ "slug": "GITHUB_GET_A_PROJECT_CARD",
1905
+ "name": "Get a project card",
1906
+ "description": "Retrieves all details of a specific project card, given its unique `card id`."
1907
+ },
1908
+ {
1909
+ "slug": "GITHUB_GET_A_PROJECT_COLUMN",
1910
+ "name": "Get a project column",
1911
+ "description": "Retrieves detailed information for a specific project column; the column must exist."
1912
+ },
1913
+ {
1914
+ "slug": "GITHUB_GET_A_PULL_REQUEST",
1915
+ "name": "Get a pull request",
1916
+ "description": "Retrieves a specific pull request from a github repository using its owner, repository name, and pull request number."
1917
+ },
1918
+ {
1919
+ "slug": "GITHUB_GET_A_REFERENCE",
1920
+ "name": "Get a reference",
1921
+ "description": "Retrieves a specific git reference (e.g., a branch, tag, or fully qualified like 'heads/main') from a github repository."
1922
+ },
1923
+ {
1924
+ "slug": "GITHUB_GET_A_RELEASE",
1925
+ "name": "Get a release",
1926
+ "description": "Gets a specific release from a github repository, provided the repository is accessible and the release exists."
1927
+ },
1928
+ {
1929
+ "slug": "GITHUB_GET_A_RELEASE_ASSET",
1930
+ "name": "Get a release asset",
1931
+ "description": "Gets metadata for a specific release asset in a github repository, including a `browser download url` for downloading the asset."
1932
+ },
1933
+ {
1934
+ "slug": "GITHUB_GET_A_RELEASE_BY_TAG_NAME",
1935
+ "name": "Get a release by tag name",
1936
+ "description": "Gets a release from a github repository by its tag name; the repository and a release with this tag must already exist."
1937
+ },
1938
+ {
1939
+ "slug": "GITHUB_GET_A_REPOSITORY",
1940
+ "name": "Get a repository",
1941
+ "description": "Retrieves detailed information about an existing and accessible github repository."
1942
+ },
1943
+ {
1944
+ "slug": "GITHUB_GET_A_REPOSITORY_PUBLIC_KEY",
1945
+ "name": "Get a repository public key",
1946
+ "description": "Gets a repository's public key for encrypting secrets to be used in github actions, if the repository exists and is accessible."
1947
+ },
1948
+ {
1949
+ "slug": "GITHUB_GET_A_REPOSITORY_README",
1950
+ "name": "Get a repository readme",
1951
+ "description": "Fetches the readme file (if it exists and is accessible) from a specified github repository, returning its base64-encoded content and metadata."
1952
+ },
1953
+ {
1954
+ "slug": "GITHUB_GET_A_REPOSITORY_README_FOR_A_DIRECTORY",
1955
+ "name": "Get a repository readme for a directory",
1956
+ "description": "Retrieves the readme file from a specified directory within a github repository, optionally at a given commit, branch, or tag."
1957
+ },
1958
+ {
1959
+ "slug": "GITHUB_GET_A_REPOSITORY_RULESET",
1960
+ "name": "Get a repository ruleset",
1961
+ "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."
1962
+ },
1963
+ {
1964
+ "slug": "GITHUB_GET_A_REPOSITORY_RULE_SUITE",
1965
+ "name": "Get a repository rule suite",
1966
+ "description": "Gets detailed information for a specific repository rule suite by its id, including its evaluation status and the results of its individual rules."
1967
+ },
1968
+ {
1969
+ "slug": "GITHUB_GET_A_REPOSITORY_SECRET",
1970
+ "name": "Get a repository secret",
1971
+ "description": "Gets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value."
1972
+ },
1973
+ {
1974
+ "slug": "GITHUB_GET_A_REPOSITORY_SUBSCRIPTION",
1975
+ "name": "Get a repository subscription",
1976
+ "description": "Gets the authenticated user's subscription details for a repository, indicating if they receive notifications."
1977
+ },
1978
+ {
1979
+ "slug": "GITHUB_GET_A_REPOSITORY_VARIABLE",
1980
+ "name": "Get a repository variable",
1981
+ "description": "Gets a specific github actions variable by name from an accessible repository."
1982
+ },
1983
+ {
1984
+ "slug": "GITHUB_GET_A_REPOSITORY_WEBHOOK",
1985
+ "name": "Get a repository webhook",
1986
+ "description": "Returns the configuration of an existing webhook for a given repository."
1987
+ },
1988
+ {
1989
+ "slug": "GITHUB_GET_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
1990
+ "name": "Get a review comment for a pull request",
1991
+ "description": "Retrieves a specific pull request review comment by its id, provided the repository exists, is accessible, and the comment id is valid."
1992
+ },
1993
+ {
1994
+ "slug": "GITHUB_GET_A_REVIEW_FOR_A_PULL_REQUEST",
1995
+ "name": "Get a review for a pull request",
1996
+ "description": "Retrieves a specific review for a pull request using its owner, repository, pull request number, and review id."
1997
+ },
1998
+ {
1999
+ "slug": "GITHUB_GET_A_SECRET_FOR_THE_AUTHENTICATED_USER",
2000
+ "name": "Get a secret for the authenticated user",
2001
+ "description": "Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's github codespaces."
2002
+ },
2003
+ {
2004
+ "slug": "GITHUB_GET_A_SELF_HOSTED_RUNNER_FOR_AN_ORGANIZATION",
2005
+ "name": "Get a self hosted runner for an organization",
2006
+ "description": "Retrieves detailed information about a specific self-hosted runner registered within a github organization."
2007
+ },
2008
+ {
2009
+ "slug": "GITHUB_GET_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORY",
2010
+ "name": "Get a self hosted runner for a repository",
2011
+ "description": "Gets a specific self-hosted runner for a repository by its unique id."
2012
+ },
2013
+ {
2014
+ "slug": "GITHUB_GET_ASSIGNMENT_GRADES",
2015
+ "name": "Get assignment grades",
2016
+ "description": "Retrieves all grades for an existing github classroom assignment."
2017
+ },
2018
+ {
2019
+ "slug": "GITHUB_GET_A_TAG",
2020
+ "name": "Get a tag",
2021
+ "description": "Retrieves detailed information for a specific git tag object from a github repository, using the sha of the tag object itself."
2022
+ },
2023
+ {
2024
+ "slug": "GITHUB_GET_A_TEAM_BY_NAME",
2025
+ "name": "Get a team by name",
2026
+ "description": "Retrieves a github team by its slug from a specific organization."
2027
+ },
2028
+ {
2029
+ "slug": "GITHUB_GET_A_THREAD",
2030
+ "name": "Get a thread",
2031
+ "description": "Retrieves a specific github notification thread using its unique `thread id`."
2032
+ },
2033
+ {
2034
+ "slug": "GITHUB_GET_A_THREAD_SUBSCRIPTION_FOR_THE_AUTHENTICATED_USER",
2035
+ "name": "Get a thread subscription for the authenticated user",
2036
+ "description": "Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread id`."
2037
+ },
2038
+ {
2039
+ "slug": "GITHUB_GET_A_TREE",
2040
+ "name": "Get a tree",
2041
+ "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."
2042
+ },
2043
+ {
2044
+ "slug": "GITHUB_GET_A_USER",
2045
+ "name": "Get a user",
2046
+ "description": "Retrieves the public profile information for an existing github user, specified by their username."
2047
+ },
2048
+ {
2049
+ "slug": "GITHUB_GET_A_WEBHOOK_CONFIGURATION_FOR_AN_ORGANIZATION",
2050
+ "name": "Get a webhook configuration for an organization",
2051
+ "description": "Retrieves the configuration for a specific webhook associated with a github organization."
2052
+ },
2053
+ {
2054
+ "slug": "GITHUB_GET_A_WEBHOOK_CONFIGURATION_FOR_A_REPOSITORY",
2055
+ "name": "Get a webhook configuration for a repository",
2056
+ "description": "Returns the configuration for an existing webhook on the specified repository."
2057
+ },
2058
+ {
2059
+ "slug": "GITHUB_GET_A_WEBHOOK_DELIVERY_FOR_AN_ORGANIZATION_WEBHOOK",
2060
+ "name": "Get a webhook delivery for an organization webhook",
2061
+ "description": "Returns detailed information for a specific delivery attempt of a webhook configured for the specified github organization."
2062
+ },
2063
+ {
2064
+ "slug": "GITHUB_GET_A_WORKFLOW",
2065
+ "name": "Get a workflow",
2066
+ "description": "Retrieves detailed information for a specific github actions workflow in a repository, identified by either its numeric id or its filename."
2067
+ },
2068
+ {
2069
+ "slug": "GITHUB_GET_A_WORKFLOW_RUN",
2070
+ "name": "Get a workflow run",
2071
+ "description": "Gets a specific workflow run by its id from a github repository."
2072
+ },
2073
+ {
2074
+ "slug": "GITHUB_GET_A_WORKFLOW_RUN_ATTEMPT",
2075
+ "name": "Get a workflow run attempt",
2076
+ "description": "Retrieves detailed information for a specific attempt of a workflow run in a github repository, including its status, conclusion, and timings."
2077
+ },
2078
+ {
2079
+ "slug": "GITHUB_GET_BRANCH_PROTECTION",
2080
+ "name": "Get branch protection",
2081
+ "description": "Retrieves branch protection settings for a specific, existing, and accessible branch in a github repository; protection feature availability varies by github product plan."
2082
+ },
2083
+ {
2084
+ "slug": "GITHUB_GET_COMMIT_AUTHORS",
2085
+ "name": "Get commit authors",
2086
+ "description": "Fetches commit authors identified during a repository import, used to map authors from an external vcs to github accounts."
2087
+ },
2088
+ {
2089
+ "slug": "GITHUB_GET_COMMIT_SIGNATURE_PROTECTION",
2090
+ "name": "Get commit signature protection",
2091
+ "description": "Gets the commit signature protection status for a branch in a repository."
2092
+ },
2093
+ {
2094
+ "slug": "GITHUB_GET_COMMUNITY_PROFILE_METRICS",
2095
+ "name": "Get community profile metrics",
2096
+ "description": "Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., readme, license)."
2097
+ },
2098
+ {
2099
+ "slug": "GITHUB_GET_CONTEXTUAL_INFORMATION_FOR_A_USER",
2100
+ "name": "Get contextual information for a user",
2101
+ "description": "Gets contextual hovercard information for a github user; `subject type` and `subject id` can be jointly provided for more specific details."
2102
+ },
2103
+ {
2104
+ "slug": "GITHUB_GET_DEFAULT_ATTRIBUTES_FOR_A_CODESPACE",
2105
+ "name": "Get default attributes for a codespace",
2106
+ "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."
2107
+ },
2108
+ {
2109
+ "slug": "GITHUB_GET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_AN_ORGANIZATION",
2110
+ "name": "Get default workflow permissions for an organization",
2111
+ "description": "Gets the default github token workflow permissions and settings for a github organization."
2112
+ },
2113
+ {
2114
+ "slug": "GITHUB_GET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_A_REPOSITORY",
2115
+ "name": "Get default workflow permissions for a repository",
2116
+ "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."
2117
+ },
2118
+ {
2119
+ "slug": "GITHUB_GET_DETAILS_ABOUT_A_CODESPACE_EXPORT",
2120
+ "name": "Get details about a codespace export",
2121
+ "description": "Retrieves detailed information about a specific export of a codespace."
2122
+ },
2123
+ {
2124
+ "slug": "GITHUB_GET_EMOJIS",
2125
+ "name": "Get emojis",
2126
+ "description": "Lists all emojis available for use on github, including custom and unicode emojis."
2127
+ },
2128
+ {
2129
+ "slug": "GITHUB_GET_FEEDS",
2130
+ "name": "Get feeds",
2131
+ "description": "Fetches a list of available github feed urls for the authenticated user."
2132
+ },
2133
+ {
2134
+ "slug": "GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_AN_ORGANIZATION",
2135
+ "name": "Get GitHub Actions cache usage for an organization",
2136
+ "description": "Retrieves total github actions cache usage statistics for an organization, including active cache count and size across all repositories."
2137
+ },
2138
+ {
2139
+ "slug": "GITHUB_GET_GITHUB_ACTIONS_CACHE_USAGE_FOR_A_REPOSITORY",
2140
+ "name": "Get github actions cache usage for a repository",
2141
+ "description": "Retrieves the total count of active github actions caches and their combined size in bytes for a specified repository."
2142
+ },
2143
+ {
2144
+ "slug": "GITHUB_GET_GITHUB_ACTIONS_PERMISSIONS_FOR_AN_ORGANIZATION",
2145
+ "name": "Get github actions permissions for an organization",
2146
+ "description": "Gets the github actions permissions for a specified organization, detailing repository enablement and allowed actions policies."
2147
+ },
2148
+ {
2149
+ "slug": "GITHUB_GET_GITHUB_ACTIONS_PERMISSIONS_FOR_A_REPOSITORY",
2150
+ "name": "Get GitHub Actions permissions for a repository",
2151
+ "description": "Gets the github actions permissions policy for a repository, including its enabled status and the scope of allowed actions."
2152
+ },
2153
+ {
2154
+ "slug": "GITHUB_GET_GITHUB_META_INFORMATION",
2155
+ "name": "Get github meta information",
2156
+ "description": "Fetches github's publicly available metadata, useful for configuring network security policies or ip allow-listing."
2157
+ },
2158
+ {
2159
+ "slug": "GITHUB_GET_GITHUB_PAGES_BUILD",
2160
+ "name": "Get github pages build",
2161
+ "description": "Retrieves detailed information about a specific github pages build for a repository, which must have github pages enabled."
2162
+ },
2163
+ {
2164
+ "slug": "GITHUB_GET_INFORMATION_ABOUT_A_SARIF_UPLOAD",
2165
+ "name": "Get information about a sarif upload",
2166
+ "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."
2167
+ },
2168
+ {
2169
+ "slug": "GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATION",
2170
+ "name": "Get interaction restrictions for an organization",
2171
+ "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."
2172
+ },
2173
+ {
2174
+ "slug": "GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORY",
2175
+ "name": "Get interaction restrictions for a repository",
2176
+ "description": "Retrieves active interaction restrictions for a repository, detailing which user groups are limited from activities like commenting or creating pull requests, and when these restrictions expire."
2177
+ },
2178
+ {
2179
+ "slug": "GITHUB_GET_INTERACTION_RESTRICTIONS_FOR_YOUR_PUBLIC_REPOSITORIES",
2180
+ "name": "Get interaction restrictions for public repositories",
2181
+ "description": "Retrieves currently active interaction restrictions for the authenticated user's public repositories."
2182
+ },
2183
+ {
2184
+ "slug": "GITHUB_GET_LARGE_FILES",
2185
+ "name": "Get large files",
2186
+ "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."
2187
+ },
2188
+ {
2189
+ "slug": "GITHUB_GET_LATEST_PAGES_BUILD",
2190
+ "name": "Get latest pages build",
2191
+ "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."
2192
+ },
2193
+ {
2194
+ "slug": "GITHUB_GET_OCTOCAT",
2195
+ "name": "Get octocat",
2196
+ "description": "Fetches an ascii art representation of github's octocat, suitable for text-based displays."
2197
+ },
2198
+ {
2199
+ "slug": "GITHUB_GET_ORG_ALLOWED_ACTIONS",
2200
+ "name": "Get allowed actions and workflows for an org",
2201
+ "description": "Retrieves the github actions permissions policy, including allowed actions and reusable workflows, for a specified organization."
2202
+ },
2203
+ {
2204
+ "slug": "GITHUB_GET_ORG_DEV_ENVIRONMENT_SECRET_SAFELY",
2205
+ "name": "Get org dev environment secret safely",
2206
+ "description": "Retrieves metadata for a specific secret available to an organization's github codespaces without exposing its encrypted value."
2207
+ },
2208
+ {
2209
+ "slug": "GITHUB_GET_PAGE_VIEWS",
2210
+ "name": "Get page views",
2211
+ "description": "Retrieves page view statistics for a repository over the last 14 days, including total views, unique visitors, and a daily or weekly breakdown."
2212
+ },
2213
+ {
2214
+ "slug": "GITHUB_GET_PENDING_DEPLOYMENTS_FOR_A_WORKFLOW_RUN",
2215
+ "name": "Get pending deployments for a workflow run",
2216
+ "description": "Retrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules."
2217
+ },
2218
+ {
2219
+ "slug": "GITHUB_GET_PROJECT_PERMISSION_FOR_A_USER",
2220
+ "name": "Get project permission for a user",
2221
+ "description": "Retrieves a collaborator's permission level (admin, write, read, or none) for an existing github project."
2222
+ },
2223
+ {
2224
+ "slug": "GITHUB_GET_PUBLIC_KEY_FOR_SECRET_ENCRYPTION",
2225
+ "name": "Get public key for secret encryption",
2226
+ "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."
2227
+ },
2228
+ {
2229
+ "slug": "GITHUB_GET_PUBLIC_KEY_FOR_THE_AUTHENTICATED_USER",
2230
+ "name": "Get public key for the authenticated user",
2231
+ "description": "Retrieves the authenticated user's public github key, used to encrypt secrets for github codespaces."
2232
+ },
2233
+ {
2234
+ "slug": "GITHUB_GET_PULL_REQUEST_REVIEW_PROTECTION",
2235
+ "name": "Get pull request review protection",
2236
+ "description": "Retrieves the pull request review protection settings for a specific branch in a github repository, if such protection is configured."
2237
+ },
2238
+ {
2239
+ "slug": "GITHUB_GET_RATE_LIMIT_STATUS_FOR_THE_AUTHENTICATED_USER",
2240
+ "name": "Get rate limit status for the authenticated user",
2241
+ "description": "Retrieves the authenticated user's current github api rate limit status, including usage and limits across different resource categories."
2242
+ },
2243
+ {
2244
+ "slug": "GITHUB_GET_REPO_DEV_ENV_SECRET",
2245
+ "name": "Get repository development environment secret",
2246
+ "description": "Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (codespaces secret) in a repository, without exposing its value."
2247
+ },
2248
+ {
2249
+ "slug": "GITHUB_GET_REPOSITORY_CLONES",
2250
+ "name": "Get repository clones",
2251
+ "description": "Retrieves the total number of clones and a breakdown of clone activity (daily or weekly) for a specified repository over the preceding 14 days."
2252
+ },
2253
+ {
2254
+ "slug": "GITHUB_GET_REPOSITORY_CONTENT",
2255
+ "name": "Get repository content",
2256
+ "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."
2257
+ },
2258
+ {
2259
+ "slug": "GITHUB_GET_REPOSITORY_PERMISSIONS_FOR_A_USER",
2260
+ "name": "Get repository permissions for a user",
2261
+ "description": "Retrieves a specific user's permission level ('admin', 'write', 'read', or 'none') for a given repository, where 'maintain' role is reported as 'write' and 'triage' as 'read'."
2262
+ },
2263
+ {
2264
+ "slug": "GITHUB_GET_REPOSITORY_SECRET_SECURELY",
2265
+ "name": "Get repository secret securely",
2266
+ "description": "Retrieves metadata for an existing dependabot secret in a repository, without exposing its encrypted value."
2267
+ },
2268
+ {
2269
+ "slug": "GITHUB_GET_RULES_FOR_A_BRANCH",
2270
+ "name": "Get rules for a branch",
2271
+ "description": "Retrieves all active rules for a specific branch in a github repository, excluding rules in 'evaluate' or 'disabled' status."
2272
+ },
2273
+ {
2274
+ "slug": "GITHUB_GET_SINGLE_ORG_SECRET_WITHOUT_DECRYPTION",
2275
+ "name": "Get single org secret without decryption",
2276
+ "description": "Retrieves metadata (e.g., name, creation/update timestamps, visibility) for an organization's dependabot secret, without its encrypted value."
2277
+ },
2278
+ {
2279
+ "slug": "GITHUB_GET_STATUS_CHECKS_PROTECTION",
2280
+ "name": "Get status checks protection",
2281
+ "description": "Retrieves the status check protection settings for a specific branch in a github repository, if status check protection is enabled for it."
2282
+ },
2283
+ {
2284
+ "slug": "GITHUB_GET_TEAM_MEMBERSHIP_FOR_A_USER",
2285
+ "name": "Get team membership for a user",
2286
+ "description": "Retrieves a user's role and membership status within a specific team in an organization."
2287
+ },
2288
+ {
2289
+ "slug": "GITHUB_GET_TEAMS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
2290
+ "name": "Get teams with access to the protected branch",
2291
+ "description": "Lists teams with explicit push access to a protected branch, provided team restrictions are configured in the branch's protection settings; returns an empty list otherwise."
2292
+ },
2293
+ {
2294
+ "slug": "GITHUB_GET_THE_AUTHENTICATED_USER",
2295
+ "name": "Get the authenticated user",
2296
+ "description": "Gets the profile information for the currently authenticated github user, including potentially private details based on user settings."
2297
+ },
2298
+ {
2299
+ "slug": "GITHUB_GET_THE_COMBINED_STATUS_FOR_A_SPECIFIC_REFERENCE",
2300
+ "name": "Get the combined status for a specific reference",
2301
+ "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."
2302
+ },
2303
+ {
2304
+ "slug": "GITHUB_GET_THE_HOURLY_COMMIT_COUNT_FOR_EACH_DAY",
2305
+ "name": "Get the hourly commit count for each day",
2306
+ "description": "Retrieves the 'punch card' data, showing hourly commit counts for each day of the week for an existing and accessible repository."
2307
+ },
2308
+ {
2309
+ "slug": "GITHUB_GET_THE_LAST_YEAR_OF_COMMIT_ACTIVITY",
2310
+ "name": "Get the last year of commit activity",
2311
+ "description": "Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified github repository."
2312
+ },
2313
+ {
2314
+ "slug": "GITHUB_GET_THE_LATEST_RELEASE",
2315
+ "name": "Get the latest release",
2316
+ "description": "Fetches the latest official (non-prerelease, non-draft) release for a github repository; requires at least one such published release."
2317
+ },
2318
+ {
2319
+ "slug": "GITHUB_GET_THE_LICENSE_FOR_A_REPOSITORY",
2320
+ "name": "Get the license for a repository",
2321
+ "description": "Retrieves the license file and its details for a repository, optionally from a specific git reference (branch, tag, or commit sha)."
2322
+ },
2323
+ {
2324
+ "slug": "GITHUB_GET_THE_REVIEW_HISTORY_FOR_A_WORKFLOW_RUN",
2325
+ "name": "Get the review history for a workflow run",
2326
+ "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."
2327
+ },
2328
+ {
2329
+ "slug": "GITHUB_GET_THE_STATUS_OF_A_GITHUB_PAGES_DEPLOYMENT",
2330
+ "name": "Get the status of a GitHub Pages deployment",
2331
+ "description": "Retrieves the status of a specific github pages deployment for a repository, which must have github pages enabled."
2332
+ },
2333
+ {
2334
+ "slug": "GITHUB_GET_THE_WEEKLY_COMMIT_ACTIVITY",
2335
+ "name": "Get the weekly commit activity",
2336
+ "description": "Fetches the weekly commit activity (additions and deletions per week) for a repository over the past year; best for repositories with under 10,000 commits."
2337
+ },
2338
+ {
2339
+ "slug": "GITHUB_GET_THE_WEEKLY_COMMIT_COUNT",
2340
+ "name": "Get the weekly commit count",
2341
+ "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."
2342
+ },
2343
+ {
2344
+ "slug": "GITHUB_GET_THE_ZEN_OF_GITHUB",
2345
+ "name": "Get the zen of github",
2346
+ "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."
2347
+ },
2348
+ {
2349
+ "slug": "GITHUB_GET_TOP_REFERRAL_PATHS",
2350
+ "name": "Get top referral paths",
2351
+ "description": "Fetches the top 10 most viewed content paths for a repository from the last 14 days."
2352
+ },
2353
+ {
2354
+ "slug": "GITHUB_GET_TOP_REFERRAL_SOURCES",
2355
+ "name": "Get top referral sources",
2356
+ "description": "Fetches the top 10 websites that referred traffic to a repository within the last 14 days."
2357
+ },
2358
+ {
2359
+ "slug": "GITHUB_GET_USERS_WITH_ACCESS_TO_THE_PROTECTED_BRANCH",
2360
+ "name": "Get users with access to the protected branch",
2361
+ "description": "Lists users with explicit push access to a protected branch, provided its protection rule restricts pushes to specific users."
2362
+ },
2363
+ {
2364
+ "slug": "GITHUB_GET_WORKFLOW_EXTERNAL_ACCESS",
2365
+ "name": "Get workflow external access level",
2366
+ "description": "Gets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows."
2367
+ },
2368
+ {
2369
+ "slug": "GITHUB_GET_WORKFLOW_RUN_USAGE",
2370
+ "name": "Get workflow run usage",
2371
+ "description": "Gets the billable time, in milliseconds, for a specific workflow run, detailing time spent on various operating systems."
2372
+ },
2373
+ {
2374
+ "slug": "GITHUB_GET_WORKFLOW_USAGE",
2375
+ "name": "Get workflow usage",
2376
+ "description": "Gets the billable time (in milliseconds, broken down by runner os) for a specific workflow within a repository for the current billing cycle."
2377
+ },
2378
+ {
2379
+ "slug": "GITHUB_GIST_S_CREATE",
2380
+ "name": "Create a gist",
2381
+ "description": "Deprecated: use `create a gist` instead. creates a new github gist with specified files, content, an optional description, and public visibility."
2382
+ },
2383
+ {
2384
+ "slug": "GITHUB_GIST_S_LIST_PUBLIC",
2385
+ "name": "List public gists",
2386
+ "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."
2387
+ },
2388
+ {
2389
+ "slug": "GITHUB_GITHUB_API_ROOT",
2390
+ "name": "Get GitHub API root",
2391
+ "description": "Retrieves a map of all top-level github rest api resource urls and their templates."
2392
+ },
2393
+ {
2394
+ "slug": "GITHUB_GITHUB_GET_REPO_ALLOWED_ACTIONS",
2395
+ "name": "Get allowed actions and workflows for a repository",
2396
+ "description": "Gets the settings for allowed actions and reusable workflows that can be run in the specified repository."
2397
+ },
2398
+ {
2399
+ "slug": "GITHUB_GITHUB_SET_REPO_RUNNER_LABELS",
2400
+ "name": "Set custom labels for repo runner",
2401
+ "description": "Replaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels."
2402
+ },
2403
+ {
2404
+ "slug": "GITHUB_ISSUES_CREATE",
2405
+ "name": "Create an issue",
2406
+ "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."
2407
+ },
2408
+ {
2409
+ "slug": "GITHUB_ISSUES_CREATE_COMMENT",
2410
+ "name": "Create an issue comment",
2411
+ "description": "Deprecated: use `create an issue comment` to create a comment on an existing github issue or pull request."
2412
+ },
2413
+ {
2414
+ "slug": "GITHUB_ISSUES_GET",
2415
+ "name": "Get an issue",
2416
+ "description": "Deprecated: use the `get an issue` action instead to retrieve details for a specific issue in a repository."
2417
+ },
2418
+ {
2419
+ "slug": "GITHUB_ISSUES_LIST_ASSIGN_EES",
2420
+ "name": "List assignees",
2421
+ "description": "Deprecated: use `list assignees`. lists users who can be assigned to issues in a repository, typically those with push access."
2422
+ },
2423
+ {
2424
+ "slug": "GITHUB_ISSUES_LIST_EVENTS_FOR_REPO",
2425
+ "name": "List issue events for a repository",
2426
+ "description": "Lists all issue events for a specified repository. <<deprecated: this action is deprecated. use `list issue events for a repository` instead.>>"
2427
+ },
2428
+ {
2429
+ "slug": "GITHUB_ISSUES_LIST_FOR_REPO",
2430
+ "name": "List repository issues",
2431
+ "description": "Lists all issues (including pull requests) in a github repository; deprecated: use list repository issues."
2432
+ },
2433
+ {
2434
+ "slug": "GITHUB_LIST_ACCEPTED_ASSIGNMENTS_FOR_AN_ASSIGNMENT",
2435
+ "name": "List accepted assignments for an assignment",
2436
+ "description": "Lists accepted assignments (student repositories created after acceptance) for an existing github classroom assignment, identified by its unique `assignment id`."
2437
+ },
2438
+ {
2439
+ "slug": "GITHUB_LIST_APP_INSTALLATIONS_ACCESSIBLE_TO_THE_USER_ACCESS_TOKEN",
2440
+ "name": "List app installations for user token",
2441
+ "description": "Lists github app installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access."
2442
+ },
2443
+ {
2444
+ "slug": "GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY",
2445
+ "name": "List artifacts for a repository",
2446
+ "description": "Lists github actions workflow artifacts for a specified repository, which must exist."
2447
+ },
2448
+ {
2449
+ "slug": "GITHUB_LIST_ASSIGNED_ISSUES",
2450
+ "name": "List assigned issues for authenticated user",
2451
+ "description": "Lists github issues for the authenticated user, defaulting to 'assigned' but filterable by other interactions, state, labels, and time, with sorting and pagination."
2452
+ },
2453
+ {
2454
+ "slug": "GITHUB_LIST_ASSIGNEES",
2455
+ "name": "List assignees",
2456
+ "description": "Lists users who can be assigned to issues in a repository, typically those with push access."
2457
+ },
2458
+ {
2459
+ "slug": "GITHUB_LIST_ASSIGNMENTS_FOR_A_CLASSROOM",
2460
+ "name": "List assignments for a classroom",
2461
+ "description": "Lists all assignments for a given github classroom `classroom id`; the classroom must exist and be accessible."
2462
+ },
2463
+ {
2464
+ "slug": "GITHUB_LIST_AVAILABLE_MACHINE_TYPES_FOR_A_REPOSITORY",
2465
+ "name": "List available machine types for a repository",
2466
+ "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."
2467
+ },
2468
+ {
2469
+ "slug": "GITHUB_LIST_BRANCHES",
2470
+ "name": "List branches",
2471
+ "description": "Lists branches for an existing github repository, with an option to filter by protection status."
2472
+ },
2473
+ {
2474
+ "slug": "GITHUB_LIST_BRANCHES_FOR_HEAD_COMMIT",
2475
+ "name": "List branches for head commit",
2476
+ "description": "Lists branches in an accessible repository where the provided commit sha is the head, useful for identifying development lines based on that commit."
2477
+ },
2478
+ {
2479
+ "slug": "GITHUB_LIST_CHECK_RUN_ANNOTATIONS",
2480
+ "name": "List check run annotations",
2481
+ "description": "Lists annotations for a specific check run in a github repository, detailing issues like errors or warnings on particular code lines."
2482
+ },
2483
+ {
2484
+ "slug": "GITHUB_LIST_CHECK_RUNS_FOR_A_GIT_REFERENCE",
2485
+ "name": "List check runs for a git reference",
2486
+ "description": "Lists check runs for a given git reference within a repository; ensure the reference exists and the repository is accessible."
2487
+ },
2488
+ {
2489
+ "slug": "GITHUB_LIST_CHECK_RUNS_IN_A_CHECK_SUITE",
2490
+ "name": "List check runs in a check suite",
2491
+ "description": "Lists check runs for a specific check suite in a github repository, optionally filtering by check name or status."
2492
+ },
2493
+ {
2494
+ "slug": "GITHUB_LIST_CHECK_SUITES_FOR_A_GIT_REFERENCE",
2495
+ "name": "List check suites for a git reference",
2496
+ "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."
2497
+ },
2498
+ {
2499
+ "slug": "GITHUB_LIST_CHILD_TEAMS",
2500
+ "name": "List child teams",
2501
+ "description": "Lists the immediate child teams of a parent team within an organization."
2502
+ },
2503
+ {
2504
+ "slug": "GITHUB_LIST_CLASSROOMS",
2505
+ "name": "List classrooms",
2506
+ "description": "Lists github classrooms to which the authenticated user has administrative access."
2507
+ },
2508
+ {
2509
+ "slug": "GITHUB_LIST_CODEOWNERS_ERRORS",
2510
+ "name": "List codeowners errors",
2511
+ "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."
2512
+ },
2513
+ {
2514
+ "slug": "GITHUB_LIST_CODE_QL_DATABASES_FOR_A_REPOSITORY",
2515
+ "name": "List CodeQL databases for a repository",
2516
+ "description": "Lists all codeql databases for a repository where codeql analysis has been previously run and completed."
2517
+ },
2518
+ {
2519
+ "slug": "GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_AN_ORGANIZATION",
2520
+ "name": "List code scanning alerts for an organization",
2521
+ "description": "Lists code scanning alerts for a github organization; use either `tool name` or `tool guid` if filtering by tool, not both."
2522
+ },
2523
+ {
2524
+ "slug": "GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_A_REPOSITORY",
2525
+ "name": "List code scanning alerts for a repository",
2526
+ "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."
2527
+ },
2528
+ {
2529
+ "slug": "GITHUB_LIST_CODE_SCANNING_ANALYSES_FOR_A_REPOSITORY",
2530
+ "name": "List code scanning analyses for a repository",
2531
+ "description": "Lists code scanning analyses for an existing repository, optionally filtering by tool (name or guid), git reference, or sarif id."
2532
+ },
2533
+ {
2534
+ "slug": "GITHUB_LIST_CODESPACES_FOR_A_USER_IN_ORGANIZATION",
2535
+ "name": "List codespaces for a user in organization",
2536
+ "description": "Lists all github codespaces owned by a specified member of a given organization."
2537
+ },
2538
+ {
2539
+ "slug": "GITHUB_LIST_CODESPACES_FOR_THE_AUTHENTICATED_USER",
2540
+ "name": "List codespaces for the authenticated user",
2541
+ "description": "Lists github codespaces for the authenticated user, optionally filtering by repository id and supporting pagination."
2542
+ },
2543
+ {
2544
+ "slug": "GITHUB_LIST_CODESPACES_FOR_THE_ORGANIZATION",
2545
+ "name": "List codespaces for the organization",
2546
+ "description": "Lists active/pending github codespaces for an existing organization; admins list all, members list their own."
2547
+ },
2548
+ {
2549
+ "slug": "GITHUB_LIST_COMMENTS_FOR_A_PULL_REQUEST_REVIEW",
2550
+ "name": "List comments for a pull request review",
2551
+ "description": "Lists all comments for a specific review on a github pull request."
2552
+ },
2553
+ {
2554
+ "slug": "GITHUB_LIST_COMMIT_COMMENTS",
2555
+ "name": "List commit comments",
2556
+ "description": "Retrieves all comments for a specific commit in a github repository, supporting pagination."
2557
+ },
2558
+ {
2559
+ "slug": "GITHUB_LIST_COMMIT_COMMENTS_FOR_A_REPOSITORY",
2560
+ "name": "List commit comments for a repository",
2561
+ "description": "Lists all commit comments for a specified repository, which must exist and be accessible."
2562
+ },
2563
+ {
2564
+ "slug": "GITHUB_LIST_COMMITS",
2565
+ "name": "List commits",
2566
+ "description": "Retrieves commits for a repository, optionally filtering by sha (must be valid commit sha or existing branch), path, author, committer, or date range."
2567
+ },
2568
+ {
2569
+ "slug": "GITHUB_LIST_COMMITS_ON_A_PULL_REQUEST",
2570
+ "name": "List commits on a pull request",
2571
+ "description": "Lists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination."
2572
+ },
2573
+ {
2574
+ "slug": "GITHUB_LIST_COMMIT_STATUSES_FOR_A_REFERENCE",
2575
+ "name": "List commit statuses for a reference",
2576
+ "description": "Lists commit statuses for a specific reference (commit sha, branch, or tag) in a repository, useful for tracking ci/test outcomes."
2577
+ },
2578
+ {
2579
+ "slug": "GITHUB_LIST_CUSTOM_PROPERTY_VALUES_FOR_ORGANIZATION_REPOSITORIES",
2580
+ "name": "List custom property values for organization repositories",
2581
+ "description": "Lists custom property values for repositories in a specified, existing organization, optionally filtered by a repository query."
2582
+ },
2583
+ {
2584
+ "slug": "GITHUB_LIST_DELIVERIES_FOR_AN_ORGANIZATION_WEBHOOK",
2585
+ "name": "List deliveries for an organization webhook",
2586
+ "description": "Retrieves a list of webhook deliveries for a specific webhook in an organization, allowing inspection of delivery history and details."
2587
+ },
2588
+ {
2589
+ "slug": "GITHUB_LIST_DELIVERIES_FOR_A_REPOSITORY_WEBHOOK",
2590
+ "name": "List deliveries for a repository webhook",
2591
+ "description": "Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook id exists."
2592
+ },
2593
+ {
2594
+ "slug": "GITHUB_LIST_DEPLOY_KEYS",
2595
+ "name": "List deploy keys",
2596
+ "description": "Lists deploy ssh keys for a specified repository; the repository must exist."
2597
+ },
2598
+ {
2599
+ "slug": "GITHUB_LIST_DEPLOYMENT_BRANCH_POLICIES",
2600
+ "name": "List deployment branch policies",
2601
+ "description": "Lists all deployment branch policies for a specified environment in a github repository."
2602
+ },
2603
+ {
2604
+ "slug": "GITHUB_LIST_DEPLOYMENTS",
2605
+ "name": "List deployments",
2606
+ "description": "Lists deployments for a specified repository; repository must exist."
2607
+ },
2608
+ {
2609
+ "slug": "GITHUB_LIST_DEPLOYMENT_STATUSES",
2610
+ "name": "List deployment statuses",
2611
+ "description": "Lists all statuses for a given deployment in a repository."
2612
+ },
2613
+ {
2614
+ "slug": "GITHUB_LIST_DISCUSSION_COMMENTS",
2615
+ "name": "List discussion comments",
2616
+ "description": "Lists all comments for a specific team discussion within an organization."
2617
+ },
2618
+ {
2619
+ "slug": "GITHUB_LIST_DISCUSSIONS",
2620
+ "name": "List discussions",
2621
+ "description": "Lists discussions for a specific team within an organization, with options for sorting, pagination, and filtering by pinned status."
2622
+ },
2623
+ {
2624
+ "slug": "GITHUB_LIST_EMAIL_ADDRESSES_FOR_THE_AUTHENTICATED_USER",
2625
+ "name": "List email addresses for the authenticated user",
2626
+ "description": "Lists all email addresses for the authenticated user, including their primary status, verification status, and visibility."
2627
+ },
2628
+ {
2629
+ "slug": "GITHUB_LIST_ENVIRONMENT_CUSTOM_DEPLOYMENT_RULES",
2630
+ "name": "List environment custom deployment rules",
2631
+ "description": "Lists all custom deployment protection rule integrations for a repository environment; the `environment name` must be url-encoded."
2632
+ },
2633
+ {
2634
+ "slug": "GITHUB_LIST_ENVIRONMENTS",
2635
+ "name": "List environments",
2636
+ "description": "Retrieves all deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages."
2637
+ },
2638
+ {
2639
+ "slug": "GITHUB_LIST_ENVIRONMENT_SECRETS",
2640
+ "name": "List environment secrets",
2641
+ "description": "Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing github repository."
2642
+ },
2643
+ {
2644
+ "slug": "GITHUB_LIST_ENVIRONMENT_VARIABLES",
2645
+ "name": "List environment variables",
2646
+ "description": "Lists all environment variables, which are plaintext key-value pairs for github actions workflows, for a specified environment within a github repository."
2647
+ },
2648
+ {
2649
+ "slug": "GITHUB_LIST_EVENTS_FOR_THE_AUTHENTICATED_USER",
2650
+ "name": "List events for the authenticated user",
2651
+ "description": "Lists public events for the specified github user, or private events if authenticated as that user, in reverse chronological order."
2652
+ },
2653
+ {
2654
+ "slug": "GITHUB_LIST_EVENTS_RECEIVED_BY_THE_AUTHENTICATED_USER",
2655
+ "name": "List events received by the authenticated user",
2656
+ "description": "Lists events a specific github user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public."
2657
+ },
2658
+ {
2659
+ "slug": "GITHUB_LIST_FOLLOWERS_OF_A_USER",
2660
+ "name": "List followers of a user",
2661
+ "description": "Lists followers for a specified, existing github user."
2662
+ },
2663
+ {
2664
+ "slug": "GITHUB_LIST_FOLLOWERS_OF_THE_AUTHENTICATED_USER",
2665
+ "name": "List followers of the authenticated user",
2666
+ "description": "Lists users following the authenticated github user, returning an empty list if the user has no followers."
2667
+ },
2668
+ {
2669
+ "slug": "GITHUB_LIST_FORKS",
2670
+ "name": "List forks",
2671
+ "description": "Lists forks for a specified repository, which must exist, with options for sorting and pagination."
2672
+ },
2673
+ {
2674
+ "slug": "GITHUB_LIST_GIST_COMMENTS",
2675
+ "name": "List gist comments",
2676
+ "description": "Lists comments for a specified github gist."
2677
+ },
2678
+ {
2679
+ "slug": "GITHUB_LIST_GIST_COMMITS",
2680
+ "name": "List gist commits",
2681
+ "description": "Lists all commits for a specified gist."
2682
+ },
2683
+ {
2684
+ "slug": "GITHUB_LIST_GIST_FORKS",
2685
+ "name": "List gist forks",
2686
+ "description": "Lists all forks for a given github gist id."
2687
+ },
2688
+ {
2689
+ "slug": "GITHUB_LIST_GISTS_FOR_A_USER",
2690
+ "name": "List gists for a user",
2691
+ "description": "Lists public gists for a specified github user."
2692
+ },
2693
+ {
2694
+ "slug": "GITHUB_LIST_GISTS_FOR_THE_AUTHENTICATED_USER",
2695
+ "name": "List gists for the authenticated user",
2696
+ "description": "Lists gists for the authenticated user, with optional filtering by update time and pagination."
2697
+ },
2698
+ {
2699
+ "slug": "GITHUB_LIST_GITHUB_ACTIONS_CACHES_FOR_A_REPOSITORY",
2700
+ "name": "List github actions caches for a repository",
2701
+ "description": "Lists github actions caches for a repository, with options to filter by git reference or cache key, and to sort and paginate results."
2702
+ },
2703
+ {
2704
+ "slug": "GITHUB_LIST_GITHUB_PAGES_BUILDS",
2705
+ "name": "List GitHub Pages builds",
2706
+ "description": "Lists github pages builds for a repository; github pages must be enabled on the repository for builds to be listed."
2707
+ },
2708
+ {
2709
+ "slug": "GITHUB_LIST_GLOBAL_SECURITY_ADVISORIES",
2710
+ "name": "List global security advisories",
2711
+ "description": "Lists github's global security advisories, filterable by various attributes including id, type, ecosystem, severity, and dates."
2712
+ },
2713
+ {
2714
+ "slug": "GITHUB_LIST_INSTALLATION_REQUESTS_FOR_THE_AUTHENTICATED_APP",
2715
+ "name": "List installation requests for the authenticated app",
2716
+ "description": "Lists pending installation requests made by users or organizations for the authenticated github app."
2717
+ },
2718
+ {
2719
+ "slug": "GITHUB_LIST_INSTANCES_OF_A_CODE_SCANNING_ALERT",
2720
+ "name": "List instances of a code scanning alert",
2721
+ "description": "Lists all instances of a specific code scanning alert, optionally filtered by git ref; requires code scanning to be enabled on the repository."
2722
+ },
2723
+ {
2724
+ "slug": "GITHUB_LIST_ISSUE_COMMENTS",
2725
+ "name": "List issue comments",
2726
+ "description": "Lists comments for a specified issue in a github repository."
2727
+ },
2728
+ {
2729
+ "slug": "GITHUB_LIST_ISSUE_COMMENTS_FOR_A_REPOSITORY",
2730
+ "name": "List issue comments for a repository",
2731
+ "description": "Lists issue comments, including those on pull requests, for an accessible repository."
2732
+ },
2733
+ {
2734
+ "slug": "GITHUB_LIST_ISSUE_EVENTS",
2735
+ "name": "List issue events",
2736
+ "description": "Retrieves a list of all events for a specific issue within a github repository."
2737
+ },
2738
+ {
2739
+ "slug": "GITHUB_LIST_ISSUE_EVENTS_FOR_A_REPOSITORY",
2740
+ "name": "List issue events for a repository",
2741
+ "description": "Lists all issue events (e.g., closed, reopened, assigned) for a specified repository."
2742
+ },
2743
+ {
2744
+ "slug": "GITHUB_LIST_ISSUES_ASSIGNED_TO_THE_AUTHENTICATED_USER",
2745
+ "name": "List issues for user",
2746
+ "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."
2747
+ },
2748
+ {
2749
+ "slug": "GITHUB_LIST_JOBS_FOR_A_WORKFLOW_RUN",
2750
+ "name": "List jobs for a workflow run",
2751
+ "description": "Lists jobs for a specific workflow run in a github repository."
2752
+ },
2753
+ {
2754
+ "slug": "GITHUB_LIST_JOBS_FOR_A_WORKFLOW_RUN_ATTEMPT",
2755
+ "name": "List jobs for a workflow run attempt",
2756
+ "description": "Lists jobs, including details like id, status, and steps, for a specific attempt of a github actions workflow run."
2757
+ },
2758
+ {
2759
+ "slug": "GITHUB_LIST_LABELS_FOR_AN_ISSUE",
2760
+ "name": "List labels for an issue",
2761
+ "description": "Lists all labels for a specified issue in a github repository."
2762
+ },
2763
+ {
2764
+ "slug": "GITHUB_LIST_LABELS_FOR_A_REPOSITORY",
2765
+ "name": "List labels for a repository",
2766
+ "description": "Retrieves all labels for a specified, existing github repository."
2767
+ },
2768
+ {
2769
+ "slug": "GITHUB_LIST_LABELS_FOR_A_SELF_HOSTED_RUNNER_FOR_AN_ORGANIZATION",
2770
+ "name": "List labels for a self-hosted runner for an organization",
2771
+ "description": "Lists all labels assigned to a specific self-hosted runner within a github organization, which are used to route workflows."
2772
+ },
2773
+ {
2774
+ "slug": "GITHUB_LIST_LABELS_FOR_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORY",
2775
+ "name": "List labels for a self-hosted runner for a repository",
2776
+ "description": "Lists all labels assigned to a specific self-hosted runner registered with the given repository."
2777
+ },
2778
+ {
2779
+ "slug": "GITHUB_LIST_LABELS_FOR_ISSUES_IN_A_MILESTONE",
2780
+ "name": "List labels for issues in a milestone",
2781
+ "description": "Lists all labels for issues within a specific milestone in a repository."
2782
+ },
2783
+ {
2784
+ "slug": "GITHUB_LIST_MACHINE_TYPES_FOR_A_CODESPACE",
2785
+ "name": "List machine types for a codespace",
2786
+ "description": "Lists available machine types for a specific, accessible codespace, enabling it to be transitioned to a new hardware configuration."
2787
+ },
2788
+ {
2789
+ "slug": "GITHUB_LIST_MATCHING_REFERENCES",
2790
+ "name": "List matching references",
2791
+ "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`)."
2792
+ },
2793
+ {
2794
+ "slug": "GITHUB_LIST_MILESTONES",
2795
+ "name": "List milestones",
2796
+ "description": "Lists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting."
2797
+ },
2798
+ {
2799
+ "slug": "GITHUB_LIST_NOTIFICATIONS_FOR_THE_AUTHENTICATED_USER",
2800
+ "name": "List notifications for the authenticated user",
2801
+ "description": "Lists notifications for the authenticated user, sorted by most recent update, with filtering and pagination options."
2802
+ },
2803
+ {
2804
+ "slug": "GITHUB_LIST_ORGANIZATION_EVENTS_FOR_THE_AUTHENTICATED_USER",
2805
+ "name": "List organization events for the authenticated user",
2806
+ "description": "Lists events within a specified organization that were performed by the authenticated user, whose `username` (path parameter) must match the api request credentials."
2807
+ },
2808
+ {
2809
+ "slug": "GITHUB_LIST_ORGANIZATION_MEMBERS",
2810
+ "name": "List organization members",
2811
+ "description": "Lists public and concealed members of a github organization; viewing concealed members requires authenticated user to be an organization member."
2812
+ },
2813
+ {
2814
+ "slug": "GITHUB_LIST_ORGANIZATION_PROJECTS",
2815
+ "name": "List organization projects",
2816
+ "description": "Lists projects for a specified github organization, optionally filtering by state and supporting pagination."
2817
+ },
2818
+ {
2819
+ "slug": "GITHUB_LIST_ORGANIZATION_REPOSITORIES",
2820
+ "name": "List organization repositories",
2821
+ "description": "Retrieves a list of repositories for a specified github organization, allowing filtering by type and sorting."
2822
+ },
2823
+ {
2824
+ "slug": "GITHUB_LIST_ORGANIZATIONS",
2825
+ "name": "List organizations",
2826
+ "description": "Lists github organizations for the authenticated user, sorted by id in ascending order."
2827
+ },
2828
+ {
2829
+ "slug": "GITHUB_LIST_ORGANIZATION_SECRETS",
2830
+ "name": "List organization secrets",
2831
+ "description": "Lists github actions secrets available for a specified organization."
2832
+ },
2833
+ {
2834
+ "slug": "GITHUB_LIST_ORGANIZATIONS_FOR_A_USER",
2835
+ "name": "List organizations for a user",
2836
+ "description": "Lists public organizations for a specified github user; the `username` must be a valid github handle."
2837
+ },
2838
+ {
2839
+ "slug": "GITHUB_LIST_ORGANIZATIONS_FOR_THE_AUTHENTICATED_USER",
2840
+ "name": "List organizations for the authenticated user",
2841
+ "description": "Lists organizations the authenticated github user is a member of, returning details for each organization."
2842
+ },
2843
+ {
2844
+ "slug": "GITHUB_LIST_ORGANIZATION_VARIABLES",
2845
+ "name": "List organization variables",
2846
+ "description": "Lists all github actions variables for a specified organization."
2847
+ },
2848
+ {
2849
+ "slug": "GITHUB_LIST_ORGANIZATION_WEBHOOKS",
2850
+ "name": "List organization webhooks",
2851
+ "description": "Lists all webhooks for a specified github organization; the organization must exist."
2852
+ },
2853
+ {
2854
+ "slug": "GITHUB_LIST_ORG_FINE_GRAINED_PERMISSIONS",
2855
+ "name": "List organization fine-grained permissions",
2856
+ "description": "Retrieves all fine-grained permissions for a specified github organization, essential for creating or updating custom roles."
2857
+ },
2858
+ {
2859
+ "slug": "GITHUB_LIST_ORG_ISSUES_FOR_USER",
2860
+ "name": "List organization issues assigned to the authenticated user",
2861
+ "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."
2862
+ },
2863
+ {
2864
+ "slug": "GITHUB_LIST_ORG_LEVEL_CODESPACES_SECRETS",
2865
+ "name": "List org level codespaces secrets",
2866
+ "description": "Lists all codespaces secrets available for a specified organization, which must exist."
2867
+ },
2868
+ {
2869
+ "slug": "GITHUB_LIST_ORG_PACKAGE_VERSIONS",
2870
+ "name": "List package versions for an organization package",
2871
+ "description": "Lists all versions for a specified package, if it exists and is owned by the given github organization."
2872
+ },
2873
+ {
2874
+ "slug": "GITHUB_LIST_ORG_REPOS_WITHGITHUB_ACTIONS_ENABLED",
2875
+ "name": "List organization repositories with Github Actions enabled",
2876
+ "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."
2877
+ },
2878
+ {
2879
+ "slug": "GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENS",
2880
+ "name": "List org resource access tokens",
2881
+ "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."
2882
+ },
2883
+ {
2884
+ "slug": "GITHUB_LIST_ORG_RESOURCES_WITH_PERSONAL_TOKENS",
2885
+ "name": "List org resources with personal tokens",
2886
+ "description": "Retrieves a list of an organization's fine-grained personal access token requests (pending, approved, or denied), with options for filtering and sorting."
2887
+ },
2888
+ {
2889
+ "slug": "GITHUB_LIST_ORG_SECRETS_WITHOUT_VALUES",
2890
+ "name": "List organization Dependabot secrets without values",
2891
+ "description": "Lists all dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist."
2892
+ },
2893
+ {
2894
+ "slug": "GITHUB_LIST_OUTSIDE_COLLABORATORS_FOR_AN_ORGANIZATION",
2895
+ "name": "List outside collaborators for an organization",
2896
+ "description": "Lists outside collaborators for a github organization, with options to filter (e.g., by 2fa status) and paginate results."
2897
+ },
2898
+ {
2899
+ "slug": "GITHUB_LIST_OWNED_PACKAGE_VERSIONS",
2900
+ "name": "List owned package versions",
2901
+ "description": "Lists all versions for an existing package owned by the authenticated user, identified by its type and name."
2902
+ },
2903
+ {
2904
+ "slug": "GITHUB_LIST_PACKAGES_FOR_AN_ORGANIZATION",
2905
+ "name": "List packages for an organization",
2906
+ "description": "Lists github packages for an organization, noting specific interpretations for package type and visibility parameters."
2907
+ },
2908
+ {
2909
+ "slug": "GITHUB_LIST_PACKAGES_FOR_A_USER",
2910
+ "name": "List packages for a user",
2911
+ "description": "Lists packages for a specified github user, filterable by package type and visibility."
2912
+ },
2913
+ {
2914
+ "slug": "GITHUB_LIST_PACKAGES_FOR_THE_AUTHENTICATED_USER_S_NAMESPACE",
2915
+ "name": "List packages for the authenticated user's namespace",
2916
+ "description": "Lists packages of a specific type and visibility within the authenticated user's namespace on github."
2917
+ },
2918
+ {
2919
+ "slug": "GITHUB_LIST_PACKAGE_VERSIONS_FOR_A_PACKAGE_OWNED_BY_A_USER",
2920
+ "name": "List package versions for a package owned by a user",
2921
+ "description": "Lists all versions of a public package owned by a specific github user, identified by package type, package name, and username."
2922
+ },
2923
+ {
2924
+ "slug": "GITHUB_LIST_PENDING_TEAM_INVITATIONS",
2925
+ "name": "List pending team invitations",
2926
+ "description": "Lists all pending membership invitations for a specified team within an organization."
2927
+ },
2928
+ {
2929
+ "slug": "GITHUB_LIST_PROJECT_CARDS",
2930
+ "name": "List project cards",
2931
+ "description": "Lists all project cards for a given `column id`, which must correspond to an existing project column."
2932
+ },
2933
+ {
2934
+ "slug": "GITHUB_LIST_PROJECT_COLLABORATORS",
2935
+ "name": "List project collaborators",
2936
+ "description": "Fetches a list of collaborators for a specified, existing github project."
2937
+ },
2938
+ {
2939
+ "slug": "GITHUB_LIST_PROJECT_COLUMNS",
2940
+ "name": "List project columns",
2941
+ "description": "Lists all of a github project's columns (e.g., 'to do', 'in progress'); project id must identify a valid, accessible project."
2942
+ },
2943
+ {
2944
+ "slug": "GITHUB_LIST_PUBLIC_EMAIL_ADDRESSES_FOR_THE_AUTHENTICATED_USER",
2945
+ "name": "List public email addresses for the authenticated user",
2946
+ "description": "Lists the public email addresses for the authenticated user."
2947
+ },
2948
+ {
2949
+ "slug": "GITHUB_LIST_PUBLIC_EVENTS",
2950
+ "name": "List public events",
2951
+ "description": "Lists public github events, which may be delayed by up to 5 minutes, with support for pagination."
2952
+ },
2953
+ {
2954
+ "slug": "GITHUB_LIST_PUBLIC_EVENTS_FOR_A_NETWORK_OF_REPOSITORIES",
2955
+ "name": "List public events for a network of repositories",
2956
+ "description": "Retrieves public events (up to 90 days old, newest first) for a github repository network, including the repository and its forks."
2957
+ },
2958
+ {
2959
+ "slug": "GITHUB_LIST_PUBLIC_EVENTS_FOR_A_USER",
2960
+ "name": "List public events for a user",
2961
+ "description": "Retrieves a list of public events for a specified github user, in reverse chronological order."
2962
+ },
2963
+ {
2964
+ "slug": "GITHUB_LIST_PUBLIC_EVENTS_RECEIVED_BY_A_USER",
2965
+ "name": "List public events received by a user",
2966
+ "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."
2967
+ },
2968
+ {
2969
+ "slug": "GITHUB_LIST_PUBLIC_GISTS",
2970
+ "name": "List public gists",
2971
+ "description": "Lists public gists from github, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first."
2972
+ },
2973
+ {
2974
+ "slug": "GITHUB_LIST_PUBLIC_KEYS_FOR_A_USER",
2975
+ "name": "List public keys for a user",
2976
+ "description": "Lists the verified public ssh keys for a specified github user."
2977
+ },
2978
+ {
2979
+ "slug": "GITHUB_LIST_PUBLIC_ORGANIZATION_EVENTS",
2980
+ "name": "List public organization events",
2981
+ "description": "Lists public events for a specified github organization, which must exist."
2982
+ },
2983
+ {
2984
+ "slug": "GITHUB_LIST_PUBLIC_ORGANIZATION_MEMBERS",
2985
+ "name": "List public organization members",
2986
+ "description": "Lists users who have publicly declared their membership in a specified, existing github organization."
2987
+ },
2988
+ {
2989
+ "slug": "GITHUB_LIST_PUBLIC_REPOSITORIES",
2990
+ "name": "List public repositories",
2991
+ "description": "Lists all public repositories on github; use the `since` parameter with a repository id from a previous result for pagination."
2992
+ },
2993
+ {
2994
+ "slug": "GITHUB_LIST_PULL_REQUESTS",
2995
+ "name": "List pull requests",
2996
+ "description": "Lists pull requests for a specified github repository with ai-friendly filtering."
2997
+ },
2998
+ {
2999
+ "slug": "GITHUB_LIST_PULL_REQUESTS_ASSOCIATED_WITH_A_COMMIT",
3000
+ "name": "List pull requests associated with a commit",
3001
+ "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."
3002
+ },
3003
+ {
3004
+ "slug": "GITHUB_LIST_PULL_REQUESTS_FILES",
3005
+ "name": "List pull requests files",
3006
+ "description": "Lists all files (including additions, modifications, and removals) associated with a specific pull request in a github repository."
3007
+ },
3008
+ {
3009
+ "slug": "GITHUB_LIST_REACTIONS_FOR_A_COMMIT_COMMENT",
3010
+ "name": "List reactions for a commit comment",
3011
+ "description": "Lists reactions for a specific commit comment; this is a read-only operation."
3012
+ },
3013
+ {
3014
+ "slug": "GITHUB_LIST_REACTIONS_FOR_AN_ISSUE",
3015
+ "name": "List reactions for an issue",
3016
+ "description": "Lists reactions for a specific, existing issue within an accessible github repository, optionally filtering by content type."
3017
+ },
3018
+ {
3019
+ "slug": "GITHUB_LIST_REACTIONS_FOR_AN_ISSUE_COMMENT",
3020
+ "name": "List reactions for an issue comment",
3021
+ "description": "Lists reactions for a specific issue comment in a github repository, optionally filtering by content type."
3022
+ },
3023
+ {
3024
+ "slug": "GITHUB_LIST_REACTIONS_FOR_A_PULL_REQUEST_REVIEW_COMMENT",
3025
+ "name": "List reactions for a pull request review comment",
3026
+ "description": "Lists reactions for a pull request review comment in a repository, optionally filtering by reaction type."
3027
+ },
3028
+ {
3029
+ "slug": "GITHUB_LIST_REACTIONS_FOR_A_RELEASE",
3030
+ "name": "List reactions for a release",
3031
+ "description": "Lists all reactions, or optionally filters reactions by a specific content type, for a given github release."
3032
+ },
3033
+ {
3034
+ "slug": "GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSION",
3035
+ "name": "List reactions for a team discussion",
3036
+ "description": "Lists reactions for an existing team discussion within an organization."
3037
+ },
3038
+ {
3039
+ "slug": "GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSION_COMMENT",
3040
+ "name": "List reactions for a team discussion comment",
3041
+ "description": "Lists reactions for a specific comment in a team discussion within an organization, optionally filtering by content type."
3042
+ },
3043
+ {
3044
+ "slug": "GITHUB_LIST_RELEASE_ASSETS",
3045
+ "name": "List release assets",
3046
+ "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."
3047
+ },
3048
+ {
3049
+ "slug": "GITHUB_LIST_RELEASES",
3050
+ "name": "List releases",
3051
+ "description": "Retrieves a list of all releases (published, draft, and prerelease) for a specified repository."
3052
+ },
3053
+ {
3054
+ "slug": "GITHUB_LIST_REPO_ACCESS_BY_TOKEN",
3055
+ "name": "List repo access by token",
3056
+ "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."
3057
+ },
3058
+ {
3059
+ "slug": "GITHUB_LIST_REPO_CODESPACES",
3060
+ "name": "List repo codespaces for authenticated user",
3061
+ "description": "Lists codespaces the authenticated user can access within a specified, existing repository."
3062
+ },
3063
+ {
3064
+ "slug": "GITHUB_LIST_REPO_DEV_CONTAINER_CONFIGS_FOR_USER",
3065
+ "name": "List repo dev container configs for user",
3066
+ "description": "Lists the `devcontainer.json` configurations available in a specified repository for use with github codespaces."
3067
+ },
3068
+ {
3069
+ "slug": "GITHUB_LIST_REPO_SECRETS_WITHOUT_VALUES",
3070
+ "name": "List repo secrets without values",
3071
+ "description": "Lists all codespaces secrets available in a specific repository, without their encrypted values."
3072
+ },
3073
+ {
3074
+ "slug": "GITHUB_LIST_REPOSITORIES_ACCESSIBLE_TO_THE_APP_INSTALLATION",
3075
+ "name": "List repos accessible to app installation",
3076
+ "description": "Lists repositories an app installation can access; 'total count' in response is zero if none are accessible."
3077
+ },
3078
+ {
3079
+ "slug": "GITHUB_LIST_REPOSITORIES_ACCESSIBLE_TO_THE_USER_ACCESS_TOKEN",
3080
+ "name": "List repositories accessible to the user access token",
3081
+ "description": "Lists repositories accessible to the authenticated user through a specific github app installation (identified by `installation id`)."
3082
+ },
3083
+ {
3084
+ "slug": "GITHUB_LIST_REPOSITORIES_FOR_A_USER",
3085
+ "name": "List repositories for a user",
3086
+ "description": "Lists public repositories for a specified github user, who must have an existing account."
3087
+ },
3088
+ {
3089
+ "slug": "GITHUB_LIST_REPOSITORIES_FOR_THE_AUTHENTICATED_USER",
3090
+ "name": "List repositories for the authenticated user",
3091
+ "description": "Lists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' api parameters (not in this model) can cause a 422 error."
3092
+ },
3093
+ {
3094
+ "slug": "GITHUB_LIST_REPOSITORIES_STARRED_BY_A_USER",
3095
+ "name": "List repositories starred by a user",
3096
+ "description": "Lists repositories a valid and existing github user has starred."
3097
+ },
3098
+ {
3099
+ "slug": "GITHUB_LIST_REPOSITORIES_STARRED_BY_THE_AUTHENTICATED_USER",
3100
+ "name": "List repositories starred by the authenticated user",
3101
+ "description": "Lists repositories the authenticated user has starred, optionally sorted and paginated, including star creation timestamps via 'application/vnd.github.star+json' media type."
3102
+ },
3103
+ {
3104
+ "slug": "GITHUB_LIST_REPOSITORIES_WATCHED_BY_A_USER",
3105
+ "name": "List repositories watched by a user",
3106
+ "description": "Lists repositories a given github user is watching; the username must be a valid and existing github user handle."
3107
+ },
3108
+ {
3109
+ "slug": "GITHUB_LIST_REPOSITORIES_WATCHED_BY_THE_AUTHENTICATED_USER",
3110
+ "name": "List repositories watched by the authenticated user",
3111
+ "description": "Lists repositories the authenticated user is watching (subscribed to for notifications)."
3112
+ },
3113
+ {
3114
+ "slug": "GITHUB_LIST_REPOSITORY_ACTIVITIES",
3115
+ "name": "List repository activities",
3116
+ "description": "Lists activities for a github repository, ensuring the repository exists and is accessible."
3117
+ },
3118
+ {
3119
+ "slug": "GITHUB_LIST_REPOSITORY_COLLABORATORS",
3120
+ "name": "List repository collaborators",
3121
+ "description": "Lists collaborators for a specified repository, provided it exists and is accessible to the authenticated user."
3122
+ },
3123
+ {
3124
+ "slug": "GITHUB_LIST_REPOSITORY_CONTRIBUTORS",
3125
+ "name": "List repository contributors",
3126
+ "description": "Lists contributors to a specified repository, sorted by number of contributions in descending order; the repository must exist and be accessible."
3127
+ },
3128
+ {
3129
+ "slug": "GITHUB_LIST_REPOSITORY_EVENTS",
3130
+ "name": "List repository events",
3131
+ "description": "Lists chronological events (e.g., code pushes, issue activities, pr actions, forks) for a specified, existing github repository."
3132
+ },
3133
+ {
3134
+ "slug": "GITHUB_LIST_REPOSITORY_INVITATIONS",
3135
+ "name": "List repository invitations",
3136
+ "description": "Retrieves all pending (unaccepted or undeclined) collaboration invitations for a specified github repository."
3137
+ },
3138
+ {
3139
+ "slug": "GITHUB_LIST_REPOSITORY_INVITATIONS_FOR_THE_AUTHENTICATED_USER",
3140
+ "name": "List authenticated user's repository invitations",
3141
+ "description": "Lists all pending repository invitations for the authenticated user."
3142
+ },
3143
+ {
3144
+ "slug": "GITHUB_LIST_REPOSITORY_ISSUES",
3145
+ "name": "List repository issues",
3146
+ "description": "Lists issues (which include pull requests) for a specified, existing github repository, with options for filtering, sorting, and pagination."
3147
+ },
3148
+ {
3149
+ "slug": "GITHUB_LIST_REPOSITORY_LANGUAGES",
3150
+ "name": "List repository languages",
3151
+ "description": "Lists the programming languages used in a github repository, returning a byte count for each language."
3152
+ },
3153
+ {
3154
+ "slug": "GITHUB_LIST_REPOSITORY_NOTIFICATIONS_FOR_THE_AUTHENTICATED_USER",
3155
+ "name": "List repository notifications for the authenticated user",
3156
+ "description": "Retrieves notifications for the authenticated user from a specified repository, to which the user must have access."
3157
+ },
3158
+ {
3159
+ "slug": "GITHUB_LIST_REPOSITORY_ORGANIZATION_SECRETS",
3160
+ "name": "List repository organization secrets",
3161
+ "description": "Lists names of organization-level secrets shared with the specified repository; actual secret values are not returned and visibility depends on token access."
3162
+ },
3163
+ {
3164
+ "slug": "GITHUB_LIST_REPOSITORY_ORGANIZATION_VARIABLES",
3165
+ "name": "List repository organization variables",
3166
+ "description": "Lists organization variables accessible to a specific repository; the repository must exist."
3167
+ },
3168
+ {
3169
+ "slug": "GITHUB_LIST_REPOSITORY_PROJECTS",
3170
+ "name": "List repository projects",
3171
+ "description": "Lists projects associated with a specific repository."
3172
+ },
3173
+ {
3174
+ "slug": "GITHUB_LIST_REPOSITORY_RULE_SUITES",
3175
+ "name": "List repository rule suites",
3176
+ "description": "Lists rule suite evaluations for a repository, allowing filtering by ref (non-wildcard), time period, actor, and result."
3177
+ },
3178
+ {
3179
+ "slug": "GITHUB_LIST_REPOSITORY_SECRETS",
3180
+ "name": "List repository secrets",
3181
+ "description": "Lists metadata for all secrets in a github repository, excluding their encrypted values."
3182
+ },
3183
+ {
3184
+ "slug": "GITHUB_LIST_REPOSITORY_SECRETS_WITHOUT_DECRYPTING",
3185
+ "name": "List repository secrets without decrypting",
3186
+ "description": "Lists metadata (e.g., name, creation/update dates) for all dependabot secrets in a repository; secret values are not included."
3187
+ },
3188
+ {
3189
+ "slug": "GITHUB_LIST_REPOSITORY_TAGS",
3190
+ "name": "List repository tags",
3191
+ "description": "Lists tags for a specified github repository."
3192
+ },
3193
+ {
3194
+ "slug": "GITHUB_LIST_REPOSITORY_TEAMS",
3195
+ "name": "List repository teams",
3196
+ "description": "Lists all teams with explicit permission to access the specified repository; the repository must exist."
3197
+ },
3198
+ {
3199
+ "slug": "GITHUB_LIST_REPOSITORY_VARIABLES",
3200
+ "name": "List repository variables",
3201
+ "description": "Lists plain text key-value variables for github actions workflows within a specific, accessible repository."
3202
+ },
3203
+ {
3204
+ "slug": "GITHUB_LIST_REPOSITORY_WEBHOOKS",
3205
+ "name": "List repository webhooks",
3206
+ "description": "Retrieves a list of webhooks for a repository, which must exist and be accessible."
3207
+ },
3208
+ {
3209
+ "slug": "GITHUB_LIST_REPOSITORY_WORKFLOWS",
3210
+ "name": "List repository workflows",
3211
+ "description": "Lists all github actions workflows for a specified repository, which must exist and be accessible."
3212
+ },
3213
+ {
3214
+ "slug": "GITHUB_LIST_REPOS_WITH_GHACTIONS_CACHE_USAGE",
3215
+ "name": "List repos with ghactions cache usage",
3216
+ "description": "Retrieves a paginated list of github actions cache usage statistics for repositories within an existing github organization."
3217
+ },
3218
+ {
3219
+ "slug": "GITHUB_LIST_REVIEW_COMMENTS_IN_A_REPOSITORY",
3220
+ "name": "List review comments in a repository",
3221
+ "description": "Lists all review comments on all pull requests within a specified repository."
3222
+ },
3223
+ {
3224
+ "slug": "GITHUB_LIST_REVIEW_COMMENTS_ON_A_PULL_REQUEST",
3225
+ "name": "List review comments on a pull request",
3226
+ "description": "Lists all review comments on a specific pull request within a github repository."
3227
+ },
3228
+ {
3229
+ "slug": "GITHUB_LIST_REVIEWS_FOR_A_PULL_REQUEST",
3230
+ "name": "List reviews for a pull request",
3231
+ "description": "Lists submitted reviews chronologically for a specific pull request within a github repository."
3232
+ },
3233
+ {
3234
+ "slug": "GITHUB_LIST_RUNNER_APPLICATIONS_FOR_AN_ORGANIZATION",
3235
+ "name": "List runner applications for an organization",
3236
+ "description": "Lists downloadable github actions runner application binaries, used for setting up self-hosted runners, for an existing github organization."
3237
+ },
3238
+ {
3239
+ "slug": "GITHUB_LIST_RUNNER_APPLICATIONS_FOR_A_REPOSITORY",
3240
+ "name": "List runner applications for a repository",
3241
+ "description": "Lists available self-hosted runner application binaries for a specific repository, including their os, architecture, and download url."
3242
+ },
3243
+ {
3244
+ "slug": "GITHUB_LIST_SECRETS_FOR_THE_AUTHENTICATED_USER",
3245
+ "name": "List secrets for the authenticated user",
3246
+ "description": "Lists all codespaces secrets accessible to the authenticated user for use within github codespaces."
3247
+ },
3248
+ {
3249
+ "slug": "GITHUB_LIST_SELECTED_REPOS_FOR_SECRET_ACCESS",
3250
+ "name": "List selected repos for secret access",
3251
+ "description": "Lists repositories within a specified organization that have been granted access to a particular dependabot secret."
3252
+ },
3253
+ {
3254
+ "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRET",
3255
+ "name": "List selected repositories for an organization secret",
3256
+ "description": "Lists repositories within an organization that have explicit access to a specific organization secret, which must have its visibility set to 'selected'."
3257
+ },
3258
+ {
3259
+ "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_VARIABLE",
3260
+ "name": "List selected repositories for an organization variable",
3261
+ "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."
3262
+ },
3263
+ {
3264
+ "slug": "GITHUB_LIST_SELECTED_REPOSITORIES_FOR_A_USER_SECRET",
3265
+ "name": "List selected repositories for a user secret",
3266
+ "description": "Lists repositories that have access to the specified user secret for the authenticated user's codespaces, provided the user has codespaces access."
3267
+ },
3268
+ {
3269
+ "slug": "GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_AN_ORGANIZATION",
3270
+ "name": "List self hosted runners for an organization",
3271
+ "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."
3272
+ },
3273
+ {
3274
+ "slug": "GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_A_REPOSITORY",
3275
+ "name": "List self hosted runners for a repository",
3276
+ "description": "Lists all self-hosted runners configured for a repository."
3277
+ },
3278
+ {
3279
+ "slug": "GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_A_USER",
3280
+ "name": "List social accounts for a user",
3281
+ "description": "Lists social media accounts publicly linked to an existing github user's profile."
3282
+ },
3283
+ {
3284
+ "slug": "GITHUB_LIST_SOCIAL_ACCOUNTS_FOR_THE_AUTHENTICATED_USER",
3285
+ "name": "List social accounts for the authenticated user",
3286
+ "description": "Lists all social media accounts linked to the authenticated user's github profile."
3287
+ },
3288
+ {
3289
+ "slug": "GITHUB_LIST_STARGAZERS",
3290
+ "name": "List stargazers",
3291
+ "description": "Lists users who have starred the specified github repository, which must exist."
3292
+ },
3293
+ {
3294
+ "slug": "GITHUB_LIST_STARRED_GISTS",
3295
+ "name": "List starred gists",
3296
+ "description": "Retrieves a list of gists starred by the authenticated user."
3297
+ },
3298
+ {
3299
+ "slug": "GITHUB_LIST_SUBSCRIPTIONS_FOR_THE_AUTHENTICATED_USER",
3300
+ "name": "List subscriptions for the authenticated user",
3301
+ "description": "Lists the authenticated user's active github marketplace subscriptions."
3302
+ },
3303
+ {
3304
+ "slug": "GITHUB_LIST_SUBSCRIPTIONS_FOR_THE_AUTHENTICATED_USER_STUBBED",
3305
+ "name": "List stubbed subscriptions for the authenticated user",
3306
+ "description": "Lists the authenticated user's stubbed (test/example data, not live) github marketplace subscriptions, useful for development or testing."
3307
+ },
3308
+ {
3309
+ "slug": "GITHUB_LIST_TAG_PROTECTION_STATES_FOR_A_REPOSITORY",
3310
+ "name": "List tag protection states for a repository",
3311
+ "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."
3312
+ },
3313
+ {
3314
+ "slug": "GITHUB_LIST_TEAM_MEMBERS",
3315
+ "name": "List team members",
3316
+ "description": "Lists members of a specific team within an organization, including members of child teams."
3317
+ },
3318
+ {
3319
+ "slug": "GITHUB_LIST_TEAM_PROJECTS",
3320
+ "name": "List team projects",
3321
+ "description": "Lists github projects accessible to a specific team within an organization."
3322
+ },
3323
+ {
3324
+ "slug": "GITHUB_LIST_TEAM_REPOSITORIES",
3325
+ "name": "List team repositories",
3326
+ "description": "Lists repositories accessible to a specific team within a github organization."
3327
+ },
3328
+ {
3329
+ "slug": "GITHUB_LIST_TEAMS",
3330
+ "name": "List teams",
3331
+ "description": "Lists teams for a specified github organization."
3332
+ },
3333
+ {
3334
+ "slug": "GITHUB_LIST_TEAMS_FOR_THE_AUTHENTICATED_USER",
3335
+ "name": "List teams for the authenticated user",
3336
+ "description": "Lists all teams across all organizations to which the authenticated user belongs, supporting pagination."
3337
+ },
3338
+ {
3339
+ "slug": "GITHUB_LIST_TEAMS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLE",
3340
+ "name": "List teams assigned to an organization role",
3341
+ "description": "Lists teams assigned to a specific role within a github organization."
3342
+ },
3343
+ {
3344
+ "slug": "GITHUB_LIST_THE_PEOPLE_A_USER_FOLLOWS",
3345
+ "name": "List the people a user follows",
3346
+ "description": "Lists github users that a valid github `username` is following, supporting pagination."
3347
+ },
3348
+ {
3349
+ "slug": "GITHUB_LIST_THE_PEOPLE_THE_AUTHENTICATED_USER_FOLLOWS",
3350
+ "name": "List people the authenticated user follows",
3351
+ "description": "Lists people the authenticated user follows."
3352
+ },
3353
+ {
3354
+ "slug": "GITHUB_LIST_TIMELINE_EVENTS_FOR_AN_ISSUE",
3355
+ "name": "List timeline events for an issue",
3356
+ "description": "Lists chronological events (e.g., comments, commits, label changes) for a specific issue in a github repository."
3357
+ },
3358
+ {
3359
+ "slug": "GITHUB_LIST_TOKEN_ACCESS_REPOSITORIES",
3360
+ "name": "List token access repositories",
3361
+ "description": "Lists repositories in an organization accessible by a specific fine-grained personal access token; this action is for github apps."
3362
+ },
3363
+ {
3364
+ "slug": "GITHUB_LIST_USER_PROJECTS",
3365
+ "name": "List user projects",
3366
+ "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."
3367
+ },
3368
+ {
3369
+ "slug": "GITHUB_LIST_USERS",
3370
+ "name": "List users",
3371
+ "description": "Retrieves all github users (individuals and organizations) in chronological order of their sign-up date."
3372
+ },
3373
+ {
3374
+ "slug": "GITHUB_LIST_USERS_BLOCKED_BY_AN_ORGANIZATION",
3375
+ "name": "List users blocked by an organization",
3376
+ "description": "Lists users blocked by a specified github organization."
3377
+ },
3378
+ {
3379
+ "slug": "GITHUB_LIST_USERS_BLOCKED_BY_THE_AUTHENTICATED_USER",
3380
+ "name": "List users blocked by the authenticated user",
3381
+ "description": "Lists users blocked by the authenticated user, returning an empty list if no users are blocked."
3382
+ },
3383
+ {
3384
+ "slug": "GITHUB_LIST_USERS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLE",
3385
+ "name": "List users assigned org role",
3386
+ "description": "Lists users assigned to a specific role within a github organization."
3387
+ },
3388
+ {
3389
+ "slug": "GITHUB_LIST_WATCHERS",
3390
+ "name": "List watchers",
3391
+ "description": "Retrieves a list of users watching a specific repository; the repository must be accessible to the authenticated user."
3392
+ },
3393
+ {
3394
+ "slug": "GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS",
3395
+ "name": "List workflow run artifacts",
3396
+ "description": "Lists artifacts (e.g., build outputs, test results) for a specific workflow run in a github repository."
3397
+ },
3398
+ {
3399
+ "slug": "GITHUB_LIST_WORKFLOW_RUNS_FOR_A_REPOSITORY",
3400
+ "name": "List workflow runs for a repository",
3401
+ "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."
3402
+ },
3403
+ {
3404
+ "slug": "GITHUB_LIST_WORKFLOW_RUNS_FOR_A_WORKFLOW",
3405
+ "name": "List workflow runs for a workflow",
3406
+ "description": "Lists runs for a specified, existing workflow (identified by id or filename like `main.yml`) in a github repository, with filtering options."
3407
+ },
3408
+ {
3409
+ "slug": "GITHUB_LOCK_AN_ISSUE",
3410
+ "name": "Lock an issue",
3411
+ "description": "Locks an existing github issue's conversation, preventing further comments; an optional reason can be specified."
3412
+ },
3413
+ {
3414
+ "slug": "GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES",
3415
+ "name": "Manage access control for organization codespaces",
3416
+ "description": "Sets the codespaces access control policy for a github organization, determining which members can use them."
3417
+ },
3418
+ {
3419
+ "slug": "GITHUB_MANAGE_CUSTOM_PROPERTIES_FOR_ORG_REPOS",
3420
+ "name": "Manage custom properties for org repos",
3421
+ "description": "Creates or updates values for an organization's predefined custom properties across multiple repositories (up to 30)."
3422
+ },
3423
+ {
3424
+ "slug": "GITHUB_MANAGE_SECRETS_IN_SELECTED_REPOSITORIES_WITH_PROPER_ACCESS",
3425
+ "name": "Manage secrets in selected repositories with proper access",
3426
+ "description": "Lists repositories within an organization that have been explicitly granted access to a specific organization secret."
3427
+ },
3428
+ {
3429
+ "slug": "GITHUB_MAP_A_COMMIT_AUTHOR",
3430
+ "name": "Map a commit author",
3431
+ "description": "Updates git author information (name and/or email) for an `author id` obtained during a repository import, to correctly attribute commits."
3432
+ },
3433
+ {
3434
+ "slug": "GITHUB_MARK_A_THREAD_AS_DONE",
3435
+ "name": "Mark a thread as done",
3436
+ "description": "Marks the github notification thread (identified by `thread id`) as done or read for the authenticated user, effectively archiving it."
3437
+ },
3438
+ {
3439
+ "slug": "GITHUB_MARK_A_THREAD_AS_READ",
3440
+ "name": "Mark a thread as read",
3441
+ "description": "Marks an existing github notification thread, identified by its `thread id`, as read."
3442
+ },
3443
+ {
3444
+ "slug": "GITHUB_MARK_NOTIFICATIONS_AS_READ",
3445
+ "name": "Mark notifications as read",
3446
+ "description": "Marks notifications as read or unread, optionally for those updated at or before a `last read at` timestamp."
3447
+ },
3448
+ {
3449
+ "slug": "GITHUB_MARK_REPOSITORY_NOTIFICATIONS_AS_READ",
3450
+ "name": "Mark repository notifications as read",
3451
+ "description": "Marks notifications in a repository as read; if 'last read at' is specified, notifications updated after this timestamp are not marked as read."
3452
+ },
3453
+ {
3454
+ "slug": "GITHUB_MERGE_A_BRANCH",
3455
+ "name": "Merge a branch",
3456
+ "description": "Merges a head branch or commit sha into a base branch in a repository; fails if there are merge conflicts requiring manual resolution."
3457
+ },
3458
+ {
3459
+ "slug": "GITHUB_MERGE_A_PULL_REQUEST",
3460
+ "name": "Merge a pull request",
3461
+ "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."
3462
+ },
3463
+ {
3464
+ "slug": "GITHUB_META_ROOT",
3465
+ "name": "Get GitHub API root",
3466
+ "description": "Deprecated: retrieves github rest api root endpoint details; use `github api root` instead."
3467
+ },
3468
+ {
3469
+ "slug": "GITHUB_MOVE_A_PROJECT_CARD",
3470
+ "name": "Move a project card",
3471
+ "description": "Moves a project card to a specified position, optionally into a new column."
3472
+ },
3473
+ {
3474
+ "slug": "GITHUB_MOVE_A_PROJECT_COLUMN",
3475
+ "name": "Move a project column",
3476
+ "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."
3477
+ },
3478
+ {
3479
+ "slug": "GITHUB_PING_AN_ORGANIZATION_WEBHOOK",
3480
+ "name": "Ping an organization webhook",
3481
+ "description": "Sends a 'ping' event to a specified, existing organization webhook to test its configuration and ensure it correctly receives events."
3482
+ },
3483
+ {
3484
+ "slug": "GITHUB_PING_A_REPOSITORY_WEBHOOK",
3485
+ "name": "Ping a repository webhook",
3486
+ "description": "Pings an existing webhook on a repository to test its configuration and reachability by github."
3487
+ },
3488
+ {
3489
+ "slug": "GITHUB_PRIVATELY_REPORT_A_SECURITY_VULNERABILITY",
3490
+ "name": "Privately report a security vulnerability",
3491
+ "description": "Privately reports a security vulnerability for a repository; specify either `severity` or `cvss vector string`, but not both."
3492
+ },
3493
+ {
3494
+ "slug": "GITHUB_PULLS_CHECK_IF_MERGED",
3495
+ "name": "Pulls check if merged",
3496
+ "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)."
3497
+ },
3498
+ {
3499
+ "slug": "GITHUB_PULLS_CREATE",
3500
+ "name": "Create a pull request",
3501
+ "description": "Deprecated: use `create a pull request` instead. creates a pull request, requiring existing `base` and `head` branches."
3502
+ },
3503
+ {
3504
+ "slug": "GITHUB_PULLS_CREATE_REVIEW",
3505
+ "name": "Create a review for a pull request",
3506
+ "description": "Deprecated: use `create a review for a pull request` for creating pull request reviews; supports `pending` for drafts and comment positioning."
3507
+ },
3508
+ {
3509
+ "slug": "GITHUB_PULLS_CREATE_REVIEW_COMMENT",
3510
+ "name": "Create a review comment for a pull request",
3511
+ "description": "Deprecated: creates a review comment on a pull request's diff. use `create a review comment for a pull request` instead."
3512
+ },
3513
+ {
3514
+ "slug": "GITHUB_PULLS_GET",
3515
+ "name": "Get a pull request",
3516
+ "description": "Deprecated: retrieves details of a specific pull request; prefer using the `get a pull request` action."
3517
+ },
3518
+ {
3519
+ "slug": "GITHUB_PULLS_LIST",
3520
+ "name": "List pull requests",
3521
+ "description": "(deprecated: use `list pull requests`) lists pull requests for a specified github repository with ai-friendly filtering."
3522
+ },
3523
+ {
3524
+ "slug": "GITHUB_REDELIVER_A_DELIVERY_FOR_AN_ORGANIZATION_WEBHOOK",
3525
+ "name": "Redeliver a delivery for an organization webhook",
3526
+ "description": "Redelivers a specific webhook delivery for a webhook within an organization, to resend an event that previously failed or was not processed."
3527
+ },
3528
+ {
3529
+ "slug": "GITHUB_REDELIVER_A_DELIVERY_FOR_A_REPOSITORY_WEBHOOK",
3530
+ "name": "Redeliver a delivery for a repository webhook",
3531
+ "description": "Redelivers a specific, previously made webhook delivery (`delivery id`) for a repository's webhook (`hook id`)."
3532
+ },
3533
+ {
3534
+ "slug": "GITHUB_REMOVE_A_CUSTOM_PROPERTY_FOR_AN_ORGANIZATION",
3535
+ "name": "Remove a custom property for an organization",
3536
+ "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."
3537
+ },
3538
+ {
3539
+ "slug": "GITHUB_REMOVE_A_LABEL_FROM_AN_ISSUE",
3540
+ "name": "Remove a label from an issue",
3541
+ "description": "Removes a label currently applied to a specific issue in a repository."
3542
+ },
3543
+ {
3544
+ "slug": "GITHUB_REMOVE_ALL_LABELS_FROM_AN_ISSUE",
3545
+ "name": "Remove all labels from an issue",
3546
+ "description": "Removes all labels from a specified issue in a github repository; this operation is idempotent."
3547
+ },
3548
+ {
3549
+ "slug": "GITHUB_REMOVE_ALL_ORGANIZATION_ROLES_FOR_A_TEAM",
3550
+ "name": "Remove all organization roles for a team",
3551
+ "description": "Revokes all organization roles for a team in an organization; this is destructive and succeeds even if the team initially has no roles."
3552
+ },
3553
+ {
3554
+ "slug": "GITHUB_REMOVE_ALL_ORGANIZATION_ROLES_FOR_A_USER",
3555
+ "name": "Remove all organization roles for a user",
3556
+ "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."
3557
+ },
3558
+ {
3559
+ "slug": "GITHUB_REMOVE_AN_ORGANIZATION_MEMBER",
3560
+ "name": "Remove an organization member",
3561
+ "description": "Removes a user, who must currently be a member, from a github organization, revoking their membership and access rights."
3562
+ },
3563
+ {
3564
+ "slug": "GITHUB_REMOVE_AN_ORGANIZATION_ROLE_FROM_A_TEAM",
3565
+ "name": "Remove an organization role from a team",
3566
+ "description": "Revokes an organization role that a team currently possesses within an organization."
3567
+ },
3568
+ {
3569
+ "slug": "GITHUB_REMOVE_AN_ORGANIZATION_ROLE_FROM_A_USER",
3570
+ "name": "Remove an organization role from a user",
3571
+ "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."
3572
+ },
3573
+ {
3574
+ "slug": "GITHUB_REMOVE_APP_ACCESS_RESTRICTIONS",
3575
+ "name": "Remove app access restrictions",
3576
+ "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."
3577
+ },
3578
+ {
3579
+ "slug": "GITHUB_REMOVE_A_PROJECT_FROM_A_TEAM",
3580
+ "name": "Remove a project from a team",
3581
+ "description": "Removes a project from a team within an organization; this action requires the project to be currently associated with the team."
3582
+ },
3583
+ {
3584
+ "slug": "GITHUB_REMOVE_A_REPOSITORY_COLLABORATOR",
3585
+ "name": "Remove a repository collaborator",
3586
+ "description": "Removes a collaborator from a specified github repository, provided the repository exists and the user is an existing collaborator."
3587
+ },
3588
+ {
3589
+ "slug": "GITHUB_REMOVE_A_REPOSITORY_FROM_AN_APP_INSTALLATION",
3590
+ "name": "Remove a repository from an app installation",
3591
+ "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."
3592
+ },
3593
+ {
3594
+ "slug": "GITHUB_REMOVE_A_REPOSITORY_FROM_A_TEAM",
3595
+ "name": "Remove a repository from a team",
3596
+ "description": "Disassociates a repository from a team; team members may lose access permissions, but the repository and team are not deleted."
3597
+ },
3598
+ {
3599
+ "slug": "GITHUB_REMOVE_A_SELECTED_REPOSITORY_FROM_A_USER_SECRET",
3600
+ "name": "Remove a selected repository from a user secret",
3601
+ "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."
3602
+ },
3603
+ {
3604
+ "slug": "GITHUB_REMOVE_ASSIGNEES_FROM_AN_ISSUE",
3605
+ "name": "Remove assignees from an issue",
3606
+ "description": "Removes specified assignees from a github issue; requires push access, and invalid removal attempts are silently ignored."
3607
+ },
3608
+ {
3609
+ "slug": "GITHUB_REMOVE_CUSTOM_LABEL_FROM_REPO_RUNNER",
3610
+ "name": "Remove custom label from repo runner",
3611
+ "description": "Removes a custom label from a repository's self-hosted runner; this operation is idempotent."
3612
+ },
3613
+ {
3614
+ "slug": "GITHUB_REMOVE_CUSTOM_LABEL_FROM_SELF_HOSTED_RUNNER",
3615
+ "name": "Remove custom label from self hosted runner",
3616
+ "description": "Removes a currently assigned custom label (`name`) from a self-hosted runner (`runner id`) in an organization (`org`)."
3617
+ },
3618
+ {
3619
+ "slug": "GITHUB_REMOVE_CUSTOM_LABELS_FROM_SELF_HOSTED_REPOSITORY_RUNNER",
3620
+ "name": "Remove custom labels from self hosted repo runner",
3621
+ "description": "Removes all custom labels from a self-hosted runner registered at the repository level, leaving only its default labels and any labels inherited from its runner group or organization."
3622
+ },
3623
+ {
3624
+ "slug": "GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATION",
3625
+ "name": "Remove interaction restrictions for an organization",
3626
+ "description": "Removes all interaction restrictions from public repositories in the specified github organization, allowing all users to resume interactions."
3627
+ },
3628
+ {
3629
+ "slug": "GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORY",
3630
+ "name": "Remove interaction restrictions for a repository",
3631
+ "description": "Removes all interaction restrictions for a repository, enabling all users to comment, open issues, and create pull requests by lifting any existing temporary interaction limits."
3632
+ },
3633
+ {
3634
+ "slug": "GITHUB_REMOVE_INTERACTION_RESTRICTIONS_FROM_YOUR_PUBLIC_REPOSITORIES",
3635
+ "name": "Remove user public repo interaction restrictions",
3636
+ "description": "Removes all interaction restrictions (limitations on comments, issues, or pull requests) from all public repositories owned by the authenticated user."
3637
+ },
3638
+ {
3639
+ "slug": "GITHUB_REMOVE_ORG_DEV_ENV_SECRET_BY_NAME",
3640
+ "name": "Remove org dev env secret by name",
3641
+ "description": "Deletes a github codespaces secret from an organization by its name; this operation is idempotent."
3642
+ },
3643
+ {
3644
+ "slug": "GITHUB_REMOVE_ORG_SECRET_BY_NAME",
3645
+ "name": "Remove org secret by name",
3646
+ "description": "Permanently removes a specific dependabot secret, by its `secret name`, from the github `org`, making it unavailable to dependabot for that organization."
3647
+ },
3648
+ {
3649
+ "slug": "GITHUB_REMOVE_OUTSIDE_COLLABORATOR_FROM_AN_ORGANIZATION",
3650
+ "name": "Remove outside collaborator from an organization",
3651
+ "description": "Removes a user, who must be an outside collaborator, from the specified github organization, revoking their access to all its repositories."
3652
+ },
3653
+ {
3654
+ "slug": "GITHUB_REMOVE_PUBLIC_ORG_MEMBERSHIP",
3655
+ "name": "Remove public org membership",
3656
+ "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."
3657
+ },
3658
+ {
3659
+ "slug": "GITHUB_REMOVE_REPO_FROM_ORG_DEV_ENV_SECRET",
3660
+ "name": "Removerepofromorgdevenvsecret",
3661
+ "description": "Removes a repository's access to an organization-level codespaces secret, if it was previously granted."
3662
+ },
3663
+ {
3664
+ "slug": "GITHUB_REMOVE_REPO_FROM_ORG_SECRET_WITH_SELECTED_VISIBILITY",
3665
+ "name": "Remove selected repo from org secret",
3666
+ "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."
3667
+ },
3668
+ {
3669
+ "slug": "GITHUB_REMOVE_REQUESTED_REVIEWERS_FROM_A_PULL_REQUEST",
3670
+ "name": "Remove requested reviewers from a pull request",
3671
+ "description": "Removes currently assigned user logins and/or team slugs from a github pull request's list of requested reviewers."
3672
+ },
3673
+ {
3674
+ "slug": "GITHUB_REMOVE_SELECTED_REPOSITORY_FROM_AN_ORGANIZATION_SECRET",
3675
+ "name": "Remove selected repository from an organization secret",
3676
+ "description": "Removes a specific repository's access to an organization-level secret; the repository must have been previously granted access to this secret."
3677
+ },
3678
+ {
3679
+ "slug": "GITHUB_REMOVE_SELECTED_REPOSITORY_FROM_AN_ORGANIZATION_VARIABLE",
3680
+ "name": "Remove selected repository from an organization variable",
3681
+ "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."
3682
+ },
3683
+ {
3684
+ "slug": "GITHUB_REMOVE_STATUS_CHECK_CONTEXTS",
3685
+ "name": "Remove status check contexts",
3686
+ "description": "Removes specified status check contexts (passed in the request body as an array of strings) from a protected branch in a repository."
3687
+ },
3688
+ {
3689
+ "slug": "GITHUB_REMOVE_STATUS_CHECK_PROTECTION",
3690
+ "name": "Remove status check protection",
3691
+ "description": "Removes status check protection from a branch, disabling required status checks for merging pull requests; will only have an effect if status check protection is currently configured on the branch."
3692
+ },
3693
+ {
3694
+ "slug": "GITHUB_REMOVE_TEAM_ACCESS_RESTRICTIONS",
3695
+ "name": "Remove team access restrictions",
3696
+ "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."
3697
+ },
3698
+ {
3699
+ "slug": "GITHUB_REMOVE_TEAM_MEMBERSHIP_FOR_A_USER",
3700
+ "name": "Remove team membership for a user",
3701
+ "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."
3702
+ },
3703
+ {
3704
+ "slug": "GITHUB_REMOVE_USER_ACCESS_RESTRICTIONS",
3705
+ "name": "Remove user access restrictions",
3706
+ "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."
3707
+ },
3708
+ {
3709
+ "slug": "GITHUB_REMOVE_USER_AS_A_COLLABORATOR",
3710
+ "name": "Remove user as a collaborator",
3711
+ "description": "Removes a user as a collaborator from an organization project; the user must already be a collaborator on the specified project."
3712
+ },
3713
+ {
3714
+ "slug": "GITHUB_REMOVE_USERS_FROM_CODESPACES_ACCESS_FOR_AN_ORGANIZATION",
3715
+ "name": "Remove users from codespaces access for an organization",
3716
+ "description": "Removes selected users from github codespaces billing access for an existing organization."
3717
+ },
3718
+ {
3719
+ "slug": "GITHUB_RENAME_A_BRANCH",
3720
+ "name": "Rename a branch",
3721
+ "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."
3722
+ },
3723
+ {
3724
+ "slug": "GITHUB_RENDER_A_MARKDOWN_DOCUMENT",
3725
+ "name": "Render a markdown document",
3726
+ "description": "Renders markdown to html; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions."
3727
+ },
3728
+ {
3729
+ "slug": "GITHUB_REPLACE_ALL_REPOSITORY_TOPICS",
3730
+ "name": "Replace all repository topics",
3731
+ "description": "Replaces all topics of a repository."
3732
+ },
3733
+ {
3734
+ "slug": "GITHUB_REPLACE_ORG_SECRET_VISIBILITY_TO_SELECTED",
3735
+ "name": "Replace org secret visibility to selected",
3736
+ "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."
3737
+ },
3738
+ {
3739
+ "slug": "GITHUB_REPLACE_REPO_ACCESS_ON_ORG_DEV_ENV_SECRET_SET",
3740
+ "name": "Replace repository access for an org Codespaces secret",
3741
+ "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."
3742
+ },
3743
+ {
3744
+ "slug": "GITHUB_REPO_S_CREATE_FOR_AUTHENTICATED_USER",
3745
+ "name": "Create a repository for the authenticated user",
3746
+ "description": "Deprecated: use 'create a repository for the authenticated user' instead. creates a new repository for the authenticated user."
3747
+ },
3748
+ {
3749
+ "slug": "GITHUB_REPO_S_CREATE_FORK",
3750
+ "name": "Create a fork",
3751
+ "description": "(deprecated: use `create a fork` instead) creates a fork of a specified repository."
3752
+ },
3753
+ {
3754
+ "slug": "GITHUB_REPO_S_CREATE_IN_ORG",
3755
+ "name": "Create an organization repository",
3756
+ "description": "Deprecated: use `create an organization repository` instead. creates a new repository in the specified organization."
3757
+ },
3758
+ {
3759
+ "slug": "GITHUB_REPO_S_CREATE_OR_UPDATE_FILE_CONTENTS",
3760
+ "name": "Create or update file contents",
3761
+ "description": "Deprecated: use `create or update file contents` instead; creates or replaces a file in a repository."
3762
+ },
3763
+ {
3764
+ "slug": "GITHUB_REPO_S_GET_CODE_FREQUENCY_STATS",
3765
+ "name": "Get the weekly commit activity",
3766
+ "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."
3767
+ },
3768
+ {
3769
+ "slug": "GITHUB_REPO_S_GET_COMMIT",
3770
+ "name": "Get a commit",
3771
+ "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."
3772
+ },
3773
+ {
3774
+ "slug": "GITHUB_REPO_S_GET_CONTENT",
3775
+ "name": "Get repository content",
3776
+ "description": "Deprecated: gets repository file content or directory metadata; use `get repository content` instead."
3777
+ },
3778
+ {
3779
+ "slug": "GITHUB_REPO_S_GET_CONTRIBUTORS_STATS",
3780
+ "name": "Get all contributor commit activity",
3781
+ "description": "(deprecated: use `getallcontributorcommitactivity`) fetches commit activity (total commits, weekly additions/deletions/commits) for all repository contributors; retry if github returns 202."
3782
+ },
3783
+ {
3784
+ "slug": "GITHUB_REPO_S_LIST_BRANCHES",
3785
+ "name": "List branches",
3786
+ "description": "(deprecated: use 'list branches' instead) lists branches for an existing github repository, with an option to filter by protection status."
3787
+ },
3788
+ {
3789
+ "slug": "GITHUB_REPO_S_LIST_COLLABORATORS",
3790
+ "name": "List repository collaborators (deprecated)",
3791
+ "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."
3792
+ },
3793
+ {
3794
+ "slug": "GITHUB_REPO_S_LIST_COMMITS",
3795
+ "name": "List commits",
3796
+ "description": "Deprecated: use `list commits` instead; lists repository commits, including gpg/s/mime signature verification details if available."
3797
+ },
3798
+ {
3799
+ "slug": "GITHUB_REPO_S_LIST_CONTRIBUTORS",
3800
+ "name": "List repository contributors",
3801
+ "description": "Deprecated: use `list repository contributors`. lists repository contributors, sorted by contributions; repository must exist and be accessible."
3802
+ },
3803
+ {
3804
+ "slug": "GITHUB_REPO_S_LIST_FOR_AUTHENTICATED_USER",
3805
+ "name": "List repositories for the authenticated user",
3806
+ "description": "Deprecated: use `list repositories for the authenticated user` to list the authenticated user's repositories."
3807
+ },
3808
+ {
3809
+ "slug": "GITHUB_REPO_S_LIST_FOR_ORG",
3810
+ "name": "List organization repositories",
3811
+ "description": "Deprecated: lists repositories for a github organization; use `list organization repositories` instead."
3812
+ },
3813
+ {
3814
+ "slug": "GITHUB_REPO_S_LIST_FOR_USER",
3815
+ "name": "List repositories for a user",
3816
+ "description": "Deprecated: lists public repositories for the specified github user; use `list repositories for a user` instead."
3817
+ },
3818
+ {
3819
+ "slug": "GITHUB_REQUEST_A_GITHUB_PAGES_BUILD",
3820
+ "name": "Request a github pages build",
3821
+ "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."
3822
+ },
3823
+ {
3824
+ "slug": "GITHUB_REQUEST_REVIEWERS_FOR_A_PULL_REQUEST",
3825
+ "name": "Request reviewers for a pull request",
3826
+ "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`."
3827
+ },
3828
+ {
3829
+ "slug": "GITHUB_REREQUEST_A_CHECK_RUN",
3830
+ "name": "Rerequest a check run",
3831
+ "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`."
3832
+ },
3833
+ {
3834
+ "slug": "GITHUB_REREQUEST_A_CHECK_SUITE",
3835
+ "name": "Rerequest a check suite",
3836
+ "description": "Triggers a new run of an existing check suite within a repository, useful for re-running checks without new code."
3837
+ },
3838
+ {
3839
+ "slug": "GITHUB_RE_RUN_A_JOB_FROM_A_WORKFLOW_RUN",
3840
+ "name": "Re-run a job from a workflow run",
3841
+ "description": "Re-runs a specific job and any dependent jobs from a github actions workflow run in the specified repository, optionally enabling debug logging."
3842
+ },
3843
+ {
3844
+ "slug": "GITHUB_RE_RUN_A_WORKFLOW",
3845
+ "name": "Rerun a workflow",
3846
+ "description": "Re-runs a specific github actions workflow run identified by its owner, repository, and run id, optionally enabling debug logging."
3847
+ },
3848
+ {
3849
+ "slug": "GITHUB_RE_RUN_FAILED_JOBS_FROM_A_WORKFLOW_RUN",
3850
+ "name": "Rerun failed jobs from a workflow run",
3851
+ "description": "Re-runs all failed jobs and their dependent jobs from a specified workflow run if the run contains previously failed jobs."
3852
+ },
3853
+ {
3854
+ "slug": "GITHUB_RESET_A_TOKEN",
3855
+ "name": "Reset a token",
3856
+ "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."
3857
+ },
3858
+ {
3859
+ "slug": "GITHUB_RESTORE_A_PACKAGE_FOR_AN_ORGANIZATION",
3860
+ "name": "Restore a package for an organization",
3861
+ "description": "Restores a package in an organization, provided it was deleted within the last 30 days."
3862
+ },
3863
+ {
3864
+ "slug": "GITHUB_RESTORE_A_PACKAGE_FOR_A_USER",
3865
+ "name": "Restore a package for a user",
3866
+ "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)."
3867
+ },
3868
+ {
3869
+ "slug": "GITHUB_RESTORE_A_PACKAGE_FOR_THE_AUTHENTICATED_USER",
3870
+ "name": "Restore a package for the authenticated user",
3871
+ "description": "Restores a package deleted by the authenticated user within the last 30 days, if its namespace and version are still available."
3872
+ },
3873
+ {
3874
+ "slug": "GITHUB_RESTORE_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USER",
3875
+ "name": "Restore a package version for the authenticated user",
3876
+ "description": "Restores a package version that was deleted by the authenticated user within the last 30 days."
3877
+ },
3878
+ {
3879
+ "slug": "GITHUB_RESTORE_PACKAGE_VERSION_FOR_AN_ORGANIZATION",
3880
+ "name": "Restore package version for an organization",
3881
+ "description": "Restores a package version for an organization, provided it was deleted within the last 30 days."
3882
+ },
3883
+ {
3884
+ "slug": "GITHUB_RESTORE_PACKAGE_VERSION_FOR_A_USER",
3885
+ "name": "Restore package version for a user",
3886
+ "description": "Restores a specific, user-owned package version if it was deleted within the last 30 days and its original namespace and version name are still available."
3887
+ },
3888
+ {
3889
+ "slug": "GITHUB_RETRIEVE_REPO_PUBLIC_KEY_FOR_ENCRYPTION",
3890
+ "name": "Retrieve repo public key for encryption",
3891
+ "description": "Gets a repository's public key, used to encrypt secrets for dependabot."
3892
+ },
3893
+ {
3894
+ "slug": "GITHUB_REVIEW_ACCESS_WITH_PERSONAL_TOKEN",
3895
+ "name": "Review access with personal token",
3896
+ "description": "Approves or denies a pending fine-grained personal access token request for organization resources; must be performed by a github app."
3897
+ },
3898
+ {
3899
+ "slug": "GITHUB_REVIEW_DEPLOYMENT_PROTECTION_RULES",
3900
+ "name": "Review Custom Deployment Rules For Workflow Run",
3901
+ "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."
3902
+ },
3903
+ {
3904
+ "slug": "GITHUB_REVIEW_PENDING_DEPLOYMENTS_FOR_A_WORKFLOW_RUN",
3905
+ "name": "Review pending deployments for a workflow run",
3906
+ "description": "Approves or rejects pending deployments for a specific workflow run that are in a 'waiting' state within specified, configured environments."
3907
+ },
3908
+ {
3909
+ "slug": "GITHUB_REVIEW_RESOURCE_REQUESTS_WITH_FINE_GRAINED_TOKENS",
3910
+ "name": "Review resource requests with fine grained tokens",
3911
+ "description": "Approves or denies fine-grained personal access token requests for an organization; any specified `pat request ids` must refer to currently pending requests."
3912
+ },
3913
+ {
3914
+ "slug": "GITHUB_REVOKE_AN_INSTALLATION_ACCESS_TOKEN",
3915
+ "name": "Revoke an installation access token",
3916
+ "description": "Revokes the github app's current installation access token, immediately invalidating it for api authentication."
3917
+ },
3918
+ {
3919
+ "slug": "GITHUB_SEARCH_CODE",
3920
+ "name": "Search code",
3921
+ "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."
3922
+ },
3923
+ {
3924
+ "slug": "GITHUB_SEARCH_COMMITS",
3925
+ "name": "Search commits",
3926
+ "description": "Finds commits on github using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination."
3927
+ },
3928
+ {
3929
+ "slug": "GITHUB_SEARCH_ISSUES_AND_PULL_REQUESTS",
3930
+ "name": "Search issues and pull requests",
3931
+ "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."
3932
+ },
3933
+ {
3934
+ "slug": "GITHUB_SEARCH_LABELS",
3935
+ "name": "Search labels",
3936
+ "description": "Searches for labels within a github repository by keywords in their names or descriptions."
3937
+ },
3938
+ {
3939
+ "slug": "GITHUB_SEARCH_REPO_S",
3940
+ "name": "Search repositories",
3941
+ "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
+ },
3943
+ {
3944
+ "slug": "GITHUB_SEARCH_REPOSITORIES",
3945
+ "name": "Search repositories",
3946
+ "description": "Searches github repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination."
3947
+ },
3948
+ {
3949
+ "slug": "GITHUB_SEARCH_TOPICS",
3950
+ "name": "Search topics",
3951
+ "description": "Finds topics on github using keywords and qualifiers with github's search syntax, supporting pagination."
3952
+ },
3953
+ {
3954
+ "slug": "GITHUB_SEARCH_USERS",
3955
+ "name": "Search users",
3956
+ "description": "Searches for users on github by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`."
3957
+ },
3958
+ {
3959
+ "slug": "GITHUB_SECURITY_ADVISORIES_LIST_GLOBAL_ADVISORIES",
3960
+ "name": "List global security advisories",
3961
+ "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>>"
3962
+ },
3963
+ {
3964
+ "slug": "GITHUB_SET_ADMIN_BRANCH_PROTECTION",
3965
+ "name": "Set admin branch protection",
3966
+ "description": "Enables administrator enforcement on a branch, making existing protection rules also apply to administrators; branch protection rules must already be configured."
3967
+ },
3968
+ {
3969
+ "slug": "GITHUB_SET_APP_ACCESS_RESTRICTIONS",
3970
+ "name": "Set app access restrictions",
3971
+ "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."
3972
+ },
3973
+ {
3974
+ "slug": "GITHUB_SET_A_REPOSITORY_SUBSCRIPTION",
3975
+ "name": "Set a repository subscription",
3976
+ "description": "Sets the authenticated user's notification subscription for a repository."
3977
+ },
3978
+ {
3979
+ "slug": "GITHUB_SET_A_THREAD_SUBSCRIPTION",
3980
+ "name": "Set a thread subscription",
3981
+ "description": "Sets whether a github notification thread is ignored (muted) or unignored (unmuted), for a `thread id` that must identify an existing notification thread."
3982
+ },
3983
+ {
3984
+ "slug": "GITHUB_SET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_AN_ORGANIZATION",
3985
+ "name": "Set default workflow permissions for an organization",
3986
+ "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."
3987
+ },
3988
+ {
3989
+ "slug": "GITHUB_SET_DEFAULT_WORKFLOW_PERMISSIONS_FOR_A_REPOSITORY",
3990
+ "name": "Set default workflow permissions for a repository",
3991
+ "description": "Sets the default permissions for the github token within a repository and configures whether github actions can approve pull requests."
3992
+ },
3993
+ {
3994
+ "slug": "GITHUB_SET_GITHUB_ACTIONS_PERMISSIONS_FOR_AN_ORGANIZATION",
3995
+ "name": "Set GitHub Actions permissions for an organization",
3996
+ "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."
3997
+ },
3998
+ {
3999
+ "slug": "GITHUB_SET_GITHUB_ACTIONS_PERMISSIONS_FOR_A_REPOSITORY",
4000
+ "name": "Set github actions permissions for a repository",
4001
+ "description": "Sets github actions permissions for a repository, enabling/disabling actions and defining the policy for allowed actions and reusable workflows."
4002
+ },
4003
+ {
4004
+ "slug": "GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_AN_ORGANIZATION",
4005
+ "name": "Set interaction restrictions for an organization",
4006
+ "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."
4007
+ },
4008
+ {
4009
+ "slug": "GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORY",
4010
+ "name": "Set interaction restrictions for a repository",
4011
+ "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."
4012
+ },
4013
+ {
4014
+ "slug": "GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_YOUR_PUBLIC_REPOSITORIES",
4015
+ "name": "Set interaction restrictions for your public repositories",
4016
+ "description": "Sets or updates temporary interaction restrictions for all public repositories owned by the authenticated user, overriding any repository-specific limits."
4017
+ },
4018
+ {
4019
+ "slug": "GITHUB_SET_LABELS_FOR_AN_ISSUE",
4020
+ "name": "Set labels for an issue",
4021
+ "description": "Replaces all existing labels on a github issue with a new set of labels."
4022
+ },
4023
+ {
4024
+ "slug": "GITHUB_SET_ORG_ALLOWED_ACTIONS",
4025
+ "name": "Set allowed actions and workflows for an organization",
4026
+ "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."
4027
+ },
4028
+ {
4029
+ "slug": "GITHUB_SET_ORG_RUNNER_LABELS",
4030
+ "name": "Set custom labels for a self-hosted runner for an organization",
4031
+ "description": "Sets the custom labels for a self-hosted runner in an organization; this operation does not affect default system-assigned labels (e.g., 'self-hosted', 'linux', 'x64')."
4032
+ },
4033
+ {
4034
+ "slug": "GITHUB_SET_PRIMARY_EMAIL_VISIBILITY_FOR_THE_AUTHENTICATED_USER",
4035
+ "name": "Set primary email visibility",
4036
+ "description": "Sets the visibility ('public' or 'private') of the authenticated user's primary email address on github, if one is configured."
4037
+ },
4038
+ {
4039
+ "slug": "GITHUB_SET_REPO_ALLOWED_ACTIONS",
4040
+ "name": "Set repo allowed actions",
4041
+ "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)."
4042
+ },
4043
+ {
4044
+ "slug": "GITHUB_SET_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRET",
4045
+ "name": "Set selected repositories for an organization secret",
4046
+ "description": "Replaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'."
4047
+ },
4048
+ {
4049
+ "slug": "GITHUB_SET_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_VARIABLE",
4050
+ "name": "Set selected repositories for an organization variable",
4051
+ "description": "Replaces the list of repositories that can access an organization-level variable; the variable's visibility must be 'selected'."
4052
+ },
4053
+ {
4054
+ "slug": "GITHUB_SET_SELECTED_REPOSITORIES_FOR_A_USER_SECRET",
4055
+ "name": "Set selected repositories for a user secret",
4056
+ "description": "Defines the list of repositories permitted to access a specific codespaces secret for the authenticated user."
4057
+ },
4058
+ {
4059
+ "slug": "GITHUB_SET_STATUS_CHECK_CONTEXTS",
4060
+ "name": "Set status check contexts",
4061
+ "description": "Replaces required status check contexts for a protected branch, requiring admin permissions; an empty `contexts` array removes all checks."
4062
+ },
4063
+ {
4064
+ "slug": "GITHUB_SET_TEAM_ACCESS_RESTRICTIONS",
4065
+ "name": "Set team access restrictions",
4066
+ "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
+ },
4068
+ {
4069
+ "slug": "GITHUB_SET_USER_ACCESS_RESTRICTIONS",
4070
+ "name": "Set user access restrictions",
4071
+ "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
+ },
4073
+ {
4074
+ "slug": "GITHUB_SET_WORKFLOW_EXTERNAL_ACCESS",
4075
+ "name": "Set workflow access level outside repository",
4076
+ "description": "Sets the access level for workflows outside a repository to use actions and reusable workflows within that repository."
4077
+ },
4078
+ {
4079
+ "slug": "GITHUB_STAR_A_GIST",
4080
+ "name": "Star a gist",
4081
+ "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
+ },
4083
+ {
4084
+ "slug": "GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER",
4085
+ "name": "Star a repository for the authenticated user",
4086
+ "description": "Stars an existing and accessible repository for the authenticated user; this action is idempotent and succeeds even if the repository is already starred."
4087
+ },
4088
+ {
4089
+ "slug": "GITHUB_START_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
4090
+ "name": "Start a codespace for the authenticated user",
4091
+ "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
+ },
4093
+ {
4094
+ "slug": "GITHUB_STOP_A_CODESPACE_FOR_AN_ORGANIZATION_USER",
4095
+ "name": "Stop a codespace for an organization user",
4096
+ "description": "Stops a codespace, which must be currently running, for a specified member of an organization."
4097
+ },
4098
+ {
4099
+ "slug": "GITHUB_STOP_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
4100
+ "name": "Stop a codespace for the authenticated user",
4101
+ "description": "Stops a running or available codespace for the authenticated user, pausing its execution and billing."
4102
+ },
4103
+ {
4104
+ "slug": "GITHUB_SUBMIT_A_REVIEW_FOR_A_PULL_REQUEST",
4105
+ "name": "Submit a review for a pull request",
4106
+ "description": "Finalizes a pending pull request review (identified by `review id`) with a required `event` (approve, request changes, comment) and an optional `body`."
4107
+ },
4108
+ {
4109
+ "slug": "GITHUB_SYNC_A_FORK_BRANCH_WITH_THE_UPSTREAM_REPOSITORY",
4110
+ "name": "Sync a fork branch with the upstream repository",
4111
+ "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
+ },
4113
+ {
4114
+ "slug": "GITHUB_TEST_THE_PUSH_REPOSITORY_WEBHOOK",
4115
+ "name": "Test the push repository webhook",
4116
+ "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
+ },
4118
+ {
4119
+ "slug": "GITHUB_TRANSFER_A_REPOSITORY",
4120
+ "name": "Transfer a repository",
4121
+ "description": "Initiates a repository transfer to a new owner (who must accept the request); if the new owner is an organization, it must be configured to allow transfers."
4122
+ },
4123
+ {
4124
+ "slug": "GITHUB_UNBLOCK_A_USER",
4125
+ "name": "Unblock a user",
4126
+ "description": "Unblocks a github user, provided they are currently blocked by the authenticated user."
4127
+ },
4128
+ {
4129
+ "slug": "GITHUB_UNBLOCK_A_USER_FROM_AN_ORGANIZATION",
4130
+ "name": "Unblock a user from an organization",
4131
+ "description": "Unblocks a user from an organization, allowing renewed interaction with its resources, provided the user is currently blocked (otherwise, a 404 error may occur)."
4132
+ },
4133
+ {
4134
+ "slug": "GITHUB_UNFOLLOW_A_USER",
4135
+ "name": "Unfollow a user",
4136
+ "description": "Unfollows an existing github user; this action is idempotent, succeeding even if the authenticated user is not currently following them."
4137
+ },
4138
+ {
4139
+ "slug": "GITHUB_UNLOCK_AN_ISSUE",
4140
+ "name": "Unlock an issue",
4141
+ "description": "Unlocks a currently locked github issue in the specified repository, allowing new comments and interactions."
4142
+ },
4143
+ {
4144
+ "slug": "GITHUB_UNLOCK_AN_ORGANIZATION_REPOSITORY",
4145
+ "name": "Unlock an organization repository",
4146
+ "description": "Unlocks an organization repository previously locked by a github migration."
4147
+ },
4148
+ {
4149
+ "slug": "GITHUB_UNLOCK_A_USER_REPOSITORY",
4150
+ "name": "Unlock a user repository",
4151
+ "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
+ },
4153
+ {
4154
+ "slug": "GITHUB_UNSTAR_A_GIST",
4155
+ "name": "Unstar a gist",
4156
+ "description": "Removes a star from the specified gist; the action is idempotent and will not error if the gist was not previously starred by the user."
4157
+ },
4158
+ {
4159
+ "slug": "GITHUB_UNSTAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER",
4160
+ "name": "Unstar a repository",
4161
+ "description": "Removes the authenticated user's star from a specified repository, which must already be starred by the user."
4162
+ },
4163
+ {
4164
+ "slug": "GITHUB_UPDATE_A_CHECK_RUN",
4165
+ "name": "Update a check run",
4166
+ "description": "Updates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details."
4167
+ },
4168
+ {
4169
+ "slug": "GITHUB_UPDATE_A_CODE_SCANNING_ALERT",
4170
+ "name": "Update a code scanning alert",
4171
+ "description": "Updates a specific code scanning alert in a github repository, primarily to change its state (e.g., 'open' or 'dismissed')."
4172
+ },
4173
+ {
4174
+ "slug": "GITHUB_UPDATE_A_CODE_SCANNING_DEFAULT_SETUP_CONFIGURATION",
4175
+ "name": "Update a code scanning default setup configuration",
4176
+ "description": "Updates the default setup configuration for code scanning in a repository; github advanced security must be enabled for the repository."
4177
+ },
4178
+ {
4179
+ "slug": "GITHUB_UPDATE_A_CODESPACE_FOR_THE_AUTHENTICATED_USER",
4180
+ "name": "Update a codespace for the authenticated user",
4181
+ "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
+ },
4183
+ {
4184
+ "slug": "GITHUB_UPDATE_A_COMMIT_COMMENT",
4185
+ "name": "Update a commit comment",
4186
+ "description": "Changes the body of an existing commit comment."
4187
+ },
4188
+ {
4189
+ "slug": "GITHUB_UPDATE_A_CUSTOM_ORGANIZATION_ROLE",
4190
+ "name": "Update a custom organization role",
4191
+ "description": "Updates an existing custom role in an organization by modifying its name, description, or permissions; at least one of these fields must be provided."
4192
+ },
4193
+ {
4194
+ "slug": "GITHUB_UPDATE_A_DEPLOYMENT_BRANCH_POLICY",
4195
+ "name": "Update a deployment branch policy",
4196
+ "description": "Updates the name pattern of an existing deployment branch policy for a specific environment in a repository."
4197
+ },
4198
+ {
4199
+ "slug": "GITHUB_UPDATE_A_DISCUSSION",
4200
+ "name": "Update a discussion",
4201
+ "description": "Updates the title and/or body of a specific team discussion within an organization."
4202
+ },
4203
+ {
4204
+ "slug": "GITHUB_UPDATE_A_DISCUSSION_COMMENT",
4205
+ "name": "Update a discussion comment",
4206
+ "description": "Updates the body of a comment in a team's discussion within an organization."
4207
+ },
4208
+ {
4209
+ "slug": "GITHUB_UPDATE_A_GIST",
4210
+ "name": "Update a gist",
4211
+ "description": "Updates a gist's description, and/or its files (including content, filename changes, or deletion)."
4212
+ },
4213
+ {
4214
+ "slug": "GITHUB_UPDATE_A_GIST_COMMENT",
4215
+ "name": "Update a gist comment",
4216
+ "description": "Updates an existing comment on a specified gist."
4217
+ },
4218
+ {
4219
+ "slug": "GITHUB_UPDATE_A_LABEL",
4220
+ "name": "Update a label",
4221
+ "description": "Updates an existing label's name, color, or description within a specified repository."
4222
+ },
4223
+ {
4224
+ "slug": "GITHUB_UPDATE_A_MILESTONE",
4225
+ "name": "Update a milestone",
4226
+ "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
+ },
4228
+ {
4229
+ "slug": "GITHUB_UPDATE_AN_ENVIRONMENT_VARIABLE",
4230
+ "name": "Update an environment variable",
4231
+ "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
+ },
4233
+ {
4234
+ "slug": "GITHUB_UPDATE_AN_EXISTING_PROJECT_CARD",
4235
+ "name": "Update an existing project card",
4236
+ "description": "Updates an existing project card's note and/or archived status, identified by its `card id`."
4237
+ },
4238
+ {
4239
+ "slug": "GITHUB_UPDATE_AN_EXISTING_PROJECT_COLUMN",
4240
+ "name": "Update an existing project column",
4241
+ "description": "Updates the name of an existing column, identified by `column id`, in a github project (classic)."
4242
+ },
4243
+ {
4244
+ "slug": "GITHUB_UPDATE_AN_ISSUE",
4245
+ "name": "Update an issue",
4246
+ "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
+ },
4248
+ {
4249
+ "slug": "GITHUB_UPDATE_AN_ISSUE_COMMENT",
4250
+ "name": "Update an issue comment",
4251
+ "description": "Updates an existing comment on an issue or pull request within a specified repository."
4252
+ },
4253
+ {
4254
+ "slug": "GITHUB_UPDATE_AN_ORGANIZATION",
4255
+ "name": "Update an organization",
4256
+ "description": "Updates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions."
4257
+ },
4258
+ {
4259
+ "slug": "GITHUB_UPDATE_AN_ORGANIZATION_VARIABLE",
4260
+ "name": "Update an organization variable",
4261
+ "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
+ },
4263
+ {
4264
+ "slug": "GITHUB_UPDATE_AN_ORGANIZATION_WEBHOOK",
4265
+ "name": "Update an organization webhook",
4266
+ "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
+ },
4268
+ {
4269
+ "slug": "GITHUB_UPDATE_A_PROJECT",
4270
+ "name": "Update a project",
4271
+ "description": "Updates an existing github project's attributes if the github projects feature is enabled and at least one modifiable field is provided."
4272
+ },
4273
+ {
4274
+ "slug": "GITHUB_UPDATE_A_PULL_REQUEST",
4275
+ "name": "Update a pull request",
4276
+ "description": "Updates an existing pull request, allowing changes to attributes like title, body, state, base branch, and maintainer modification settings."
4277
+ },
4278
+ {
4279
+ "slug": "GITHUB_UPDATE_A_PULL_REQUEST_BRANCH",
4280
+ "name": "Update a pull request branch",
4281
+ "description": "Updates an open pull request's head branch by merging the latest changes from its base branch, if mergeable and repository merging is enabled; operates asynchronously."
4282
+ },
4283
+ {
4284
+ "slug": "GITHUB_UPDATE_A_REFERENCE",
4285
+ "name": "Update a reference",
4286
+ "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
+ },
4288
+ {
4289
+ "slug": "GITHUB_UPDATE_A_RELEASE",
4290
+ "name": "Update a release",
4291
+ "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
+ },
4293
+ {
4294
+ "slug": "GITHUB_UPDATE_A_RELEASE_ASSET",
4295
+ "name": "Update a release asset",
4296
+ "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
+ },
4298
+ {
4299
+ "slug": "GITHUB_UPDATE_A_REPOSITORY",
4300
+ "name": "Update a repository",
4301
+ "description": "Updates settings for an existing github repository, such as name, description, visibility, merge strategies, and security configurations."
4302
+ },
4303
+ {
4304
+ "slug": "GITHUB_UPDATE_A_REPOSITORY_INVITATION",
4305
+ "name": "Update a repository invitation",
4306
+ "description": "Updates an active repository invitation to modify the invited user's permissions; the specified repository and invitation must exist."
4307
+ },
4308
+ {
4309
+ "slug": "GITHUB_UPDATE_A_REPOSITORY_RULESET",
4310
+ "name": "Update a repository ruleset",
4311
+ "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
+ },
4313
+ {
4314
+ "slug": "GITHUB_UPDATE_A_REPOSITORY_VARIABLE",
4315
+ "name": "Update a repository variable",
4316
+ "description": "Updates the name and/or value of an existing github actions variable in a repository."
4317
+ },
4318
+ {
4319
+ "slug": "GITHUB_UPDATE_A_REPOSITORY_WEBHOOK",
4320
+ "name": "Update a repository webhook",
4321
+ "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
+ },
4323
+ {
4324
+ "slug": "GITHUB_UPDATE_A_REVIEW_COMMENT_FOR_A_PULL_REQUEST",
4325
+ "name": "Update a review comment for a pull request",
4326
+ "description": "Updates the body of an existing review comment on a pull request."
4327
+ },
4328
+ {
4329
+ "slug": "GITHUB_UPDATE_A_REVIEW_FOR_A_PULL_REQUEST",
4330
+ "name": "Update a review for a pull request",
4331
+ "description": "Updates the body text of an existing pull request review."
4332
+ },
4333
+ {
4334
+ "slug": "GITHUB_UPDATE_A_TEAM",
4335
+ "name": "Update a team",
4336
+ "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
+ },
4338
+ {
4339
+ "slug": "GITHUB_UPDATE_A_WEBHOOK_CONFIGURATION_FOR_AN_ORGANIZATION",
4340
+ "name": "Update a webhook configuration for an organization",
4341
+ "description": "Updates the configuration (url, content type, secret, ssl verification) for an existing webhook within a specified organization."
4342
+ },
4343
+ {
4344
+ "slug": "GITHUB_UPDATE_A_WEBHOOK_CONFIGURATION_FOR_A_REPOSITORY",
4345
+ "name": "Update a webhook configuration for a repository",
4346
+ "description": "Updates the configuration (e.g., payload url, content type, secret, ssl verification) for an existing webhook in a specified repository."
4347
+ },
4348
+ {
4349
+ "slug": "GITHUB_UPDATE_BRANCH_PROTECTION",
4350
+ "name": "Update branch protection",
4351
+ "description": "Updates the protection settings for an existing branch in a repository, which must not contain wildcard characters."
4352
+ },
4353
+ {
4354
+ "slug": "GITHUB_UPDATE_GIT_LFS_PREFERENCE",
4355
+ "name": "Update git lfs preference",
4356
+ "description": "Sets the git large file storage (lfs) preference for a repository, typically before initiating a source import."
4357
+ },
4358
+ {
4359
+ "slug": "GITHUB_UPDATE_INFORMATION_ABOUT_A_GITHUB_PAGES_SITE",
4360
+ "name": "Update information about a github pages site",
4361
+ "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
+ },
4363
+ {
4364
+ "slug": "GITHUB_UPDATE_PULL_REQUEST_REVIEW_PROTECTION",
4365
+ "name": "Update pull request review protection",
4366
+ "description": "Updates pull request review protection settings (e.g., required approvals, review dismissal, bypass allowances) for a branch; branch protection features must be available for the repository."
4367
+ },
4368
+ {
4369
+ "slug": "GITHUB_UPDATE_REPOSITORY_PREFERENCES_FOR_CHECK_SUITES",
4370
+ "name": "Update repository preferences for check suites",
4371
+ "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
+ },
4373
+ {
4374
+ "slug": "GITHUB_UPDATE_RESOURCE_ACCESS_WITH_TOKENS",
4375
+ "name": "Update resource access with tokens",
4376
+ "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
+ },
4378
+ {
4379
+ "slug": "GITHUB_UPDATE_STATUS_CHECK_PROTECTION",
4380
+ "name": "Update status check protection",
4381
+ "description": "Updates required status checks for a branch, optionally requiring it to be up-to-date before merging."
4382
+ },
4383
+ {
4384
+ "slug": "GITHUB_UPDATE_THE_AUTHENTICATED_USER",
4385
+ "name": "Update the authenticated user",
4386
+ "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
+ },
4388
+ {
4389
+ "slug": "GITHUB_UPDATE_TOKEN_ORG_ACCESS",
4390
+ "name": "Update token org access",
4391
+ "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."
4392
+ },
4393
+ {
4394
+ "slug": "GITHUB_UPLOAD_AN_ANALYSIS_AS_SARIF_DATA",
4395
+ "name": "Upload an analysis as sarif data",
4396
+ "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."
4397
+ },
4398
+ {
4399
+ "slug": "GITHUB_USERS_GET_AUTHENTICATED",
4400
+ "name": "Get the authenticated user",
4401
+ "description": "[deprecated] retrieves the authenticated user's information; use `get the authenticated user` instead."
4402
+ },
4403
+ {
4404
+ "slug": "GITHUB_USERS_GET_BY_USERNAME",
4405
+ "name": "Get a user",
4406
+ "description": "Deprecated: use the `getauser` action to retrieve a github user's public profile by username."
4407
+ },
4408
+ {
4409
+ "slug": "GITHUB_USERS_GET_CONTEXT_FOR_USER",
4410
+ "name": "Get contextual information for a user",
4411
+ "description": "Retrieves contextual hovercard information for a github user. (deprecated: please use the `get contextual information for a user` action instead)."
4412
+ },
4413
+ {
4414
+ "slug": "GITHUB_USERS_LIST_FOLLOWERS_FOR_AUTHENTICATED_USER",
4415
+ "name": "List followers of the authenticated user",
4416
+ "description": "Deprecated: lists users following the authenticated github user; use `list followers of the authenticated user` instead."
4417
+ },
4418
+ {
4419
+ "slug": "GITHUB_USERS_LIST_PUBLIC_EMAILS_FOR_AUTHENTICATED_USER",
4420
+ "name": "List public email addresses for the authenticated user",
4421
+ "description": "Deprecated: use `listpublicemailaddressesfortheauthenticateduser` instead; lists public email addresses for the authenticated user."
4422
+ },
4423
+ {
4424
+ "slug": "GITHUB_USERS_LIST_SOCIAL_ACCOUNTS_FOR_USER",
4425
+ "name": "List social accounts for a user",
4426
+ "description": "Deprecated: lists social media accounts for an existing github user; use 'list social accounts for a user' instead."
4427
+ },
4428
+ {
4429
+ "slug": "GITHUB_VERIFY_DEV_CONTAINER_PERMISSIONS_ACCEPTED",
4430
+ "name": "Verify dev container permissions accepted",
4431
+ "description": "Verifies if the authenticated user has accepted permissions for a specific devcontainer configuration in a repository, typically to ensure awareness before a codespace is created or used."
4432
+ }
4433
+ ],
4434
+ "triggers": [
4435
+ {
4436
+ "slug": "GITHUB_COMMIT_EVENT",
4437
+ "name": "Commit Event",
4438
+ "description": "Triggered when a new commit is pushed to a repository."
4439
+ },
4440
+ {
4441
+ "slug": "GITHUB_FOLLOWER_EVENT",
4442
+ "name": "Follower Changes",
4443
+ "description": "Triggers when there are changes in GitHub followers."
4444
+ },
4445
+ {
4446
+ "slug": "GITHUB_ISSUE_ADDED_EVENT",
4447
+ "name": "Issue Added Event",
4448
+ "description": "Triggered when a new issue is added to the repository."
4449
+ },
4450
+ {
4451
+ "slug": "GITHUB_LABEL_ADDED_EVENT",
4452
+ "name": "Label Added Event",
4453
+ "description": "Triggered when a new label is added to a pull request."
4454
+ },
4455
+ {
4456
+ "slug": "GITHUB_PULL_REQUEST_EVENT",
4457
+ "name": "Pull Request Event",
4458
+ "description": "Triggered when a pull request is opened, closed, or synchronized."
4459
+ },
4460
+ {
4461
+ "slug": "GITHUB_STAR_ADDED_EVENT",
4462
+ "name": "Star Added Event",
4463
+ "description": "Triggered when a new star is added to the repository."
4464
+ }
4465
+ ]
4466
+ },
4467
+ {
4468
+ "slug": "googlecalendar",
4469
+ "name": "Google Calendar",
4470
+ "logo": "https://logos.composio.dev/api/googlecalendar",
4471
+ "description": "Google Calendar is a time management tool providing scheduling features, event reminders, and integration with email and other apps for streamlined organization",
4472
+ "category": "scheduling & booking",
4473
+ "authSchemes": [
4474
+ "OAUTH2"
4475
+ ],
4476
+ "toolCount": 28,
4477
+ "triggerCount": 7,
4478
+ "version": "20260102_01",
4479
+ "tools": [
4480
+ {
4481
+ "slug": "GOOGLECALENDAR_CALENDAR_LIST_INSERT",
4482
+ "name": "Insert Calendar into List",
4483
+ "description": "Inserts an existing calendar into the user's calendar list."
4484
+ },
4485
+ {
4486
+ "slug": "GOOGLECALENDAR_CALENDAR_LIST_UPDATE",
4487
+ "name": "Update Calendar List Entry",
4488
+ "description": "Updates an existing entry on the user\\'s calendar list."
4489
+ },
4490
+ {
4491
+ "slug": "GOOGLECALENDAR_CALENDARS_DELETE",
4492
+ "name": "Delete Calendar",
4493
+ "description": "Deletes a secondary calendar. use calendars.clear for clearing all events on primary calendars."
4494
+ },
4495
+ {
4496
+ "slug": "GOOGLECALENDAR_CALENDARS_UPDATE",
4497
+ "name": "Update Calendar",
4498
+ "description": "Updates metadata for a calendar."
4499
+ },
4500
+ {
4501
+ "slug": "GOOGLECALENDAR_CLEAR_CALENDAR",
4502
+ "name": "Clear Calendar",
4503
+ "description": "Clears a primary calendar. this operation deletes all events associated with the primary calendar of an account."
4504
+ },
4505
+ {
4506
+ "slug": "GOOGLECALENDAR_CREATE_EVENT",
4507
+ "name": "Create Event",
4508
+ "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."
4509
+ },
4510
+ {
4511
+ "slug": "GOOGLECALENDAR_DELETE_EVENT",
4512
+ "name": "Delete event",
4513
+ "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."
4514
+ },
4515
+ {
4516
+ "slug": "GOOGLECALENDAR_DUPLICATE_CALENDAR",
4517
+ "name": "Create a calendar",
4518
+ "description": "Creates a new, empty google calendar with the specified title (summary)."
4519
+ },
4520
+ {
4521
+ "slug": "GOOGLECALENDAR_EVENTS_INSTANCES",
4522
+ "name": "Get Event Instances",
4523
+ "description": "Returns instances of the specified recurring event."
4524
+ },
4525
+ {
4526
+ "slug": "GOOGLECALENDAR_EVENTS_LIST",
4527
+ "name": "List Events",
4528
+ "description": "Returns events on the specified calendar."
4529
+ },
4530
+ {
4531
+ "slug": "GOOGLECALENDAR_EVENTS_MOVE",
4532
+ "name": "Move Event",
4533
+ "description": "Moves an event to another calendar, i.e., changes an event's organizer."
4534
+ },
4535
+ {
4536
+ "slug": "GOOGLECALENDAR_EVENTS_WATCH",
4537
+ "name": "Watch Events",
4538
+ "description": "Watch for changes to events resources."
4539
+ },
4540
+ {
4541
+ "slug": "GOOGLECALENDAR_FIND_EVENT",
4542
+ "name": "Find event",
4543
+ "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."
4544
+ },
4545
+ {
4546
+ "slug": "GOOGLECALENDAR_FIND_FREE_SLOTS",
4547
+ "name": "Find free slots",
4548
+ "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."
4549
+ },
4550
+ {
4551
+ "slug": "GOOGLECALENDAR_FREE_BUSY_QUERY",
4552
+ "name": "Query Free/Busy Information",
4553
+ "description": "Returns free/busy information for a set of calendars."
4554
+ },
4555
+ {
4556
+ "slug": "GOOGLECALENDAR_GET_CALENDAR",
4557
+ "name": "Get Google Calendar",
4558
+ "description": "Retrieves a specific google calendar, identified by `calendar id`, to which the authenticated user has access."
4559
+ },
4560
+ {
4561
+ "slug": "GOOGLECALENDAR_GET_CURRENT_DATE_TIME",
4562
+ "name": "Get current date and time",
4563
+ "description": "Gets the current date and time, allowing for a specific timezone offset."
4564
+ },
4565
+ {
4566
+ "slug": "GOOGLECALENDAR_LIST_ACL_RULES",
4567
+ "name": "List ACL Rules",
4568
+ "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."
4569
+ },
4570
+ {
4571
+ "slug": "GOOGLECALENDAR_LIST_CALENDARS",
4572
+ "name": "List Google Calendars",
4573
+ "description": "Retrieves calendars from the user's google calendar list, with options for pagination and filtering."
4574
+ },
4575
+ {
4576
+ "slug": "GOOGLECALENDAR_PATCH_CALENDAR",
4577
+ "name": "Patch Calendar",
4578
+ "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."
4579
+ },
4580
+ {
4581
+ "slug": "GOOGLECALENDAR_PATCH_EVENT",
4582
+ "name": "Patch Event",
4583
+ "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."
4584
+ },
4585
+ {
4586
+ "slug": "GOOGLECALENDAR_QUICK_ADD",
4587
+ "name": "Quick Add Event",
4588
+ "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'."
4589
+ },
4590
+ {
4591
+ "slug": "GOOGLECALENDAR_REMOVE_ATTENDEE",
4592
+ "name": "Remove attendee from event",
4593
+ "description": "Removes an attendee from a specified event in a google calendar; the calendar and event must exist."
4594
+ },
4595
+ {
4596
+ "slug": "GOOGLECALENDAR_SETTINGS_LIST",
4597
+ "name": "List Settings",
4598
+ "description": "Returns all user settings for the authenticated user."
4599
+ },
4600
+ {
4601
+ "slug": "GOOGLECALENDAR_SETTINGS_WATCH",
4602
+ "name": "Watch Settings",
4603
+ "description": "Watch for changes to settings resources."
4604
+ },
4605
+ {
4606
+ "slug": "GOOGLECALENDAR_SYNC_EVENTS",
4607
+ "name": "Sync Events",
4608
+ "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."
4609
+ },
4610
+ {
4611
+ "slug": "GOOGLECALENDAR_UPDATE_ACL_RULE",
4612
+ "name": "Update ACL Rule",
4613
+ "description": "Updates an access control rule for the specified calendar."
4614
+ },
4615
+ {
4616
+ "slug": "GOOGLECALENDAR_UPDATE_EVENT",
4617
+ "name": "Update Google event",
4618
+ "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."
4619
+ }
4620
+ ],
4621
+ "triggers": [
4622
+ {
4623
+ "slug": "GOOGLECALENDAR_ATTENDEE_RESPONSE_CHANGED_TRIGGER",
4624
+ "name": "Attendee Response Changed",
4625
+ "description": "Polling trigger that fires when any attendee's RSVP changes to\n accepted, declined, or tentative. Returns attendee info and current status."
4626
+ },
4627
+ {
4628
+ "slug": "GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGER",
4629
+ "name": "Event Canceled or Deleted",
4630
+ "description": "Triggers when a Google Calendar event is cancelled or deleted.\n Returns minimal data: event_id, summary (if available), and cancellation timestamp."
4631
+ },
4632
+ {
4633
+ "slug": "GOOGLECALENDAR_EVENT_STARTING_SOON_TRIGGER",
4634
+ "name": "Event Starting Soon",
4635
+ "description": "Triggers when a calendar event is within a configured number of minutes from starting.\n Includes countdown window, start time, and event metadata."
4636
+ },
4637
+ {
4638
+ "slug": "GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CHANGE_TRIGGER",
4639
+ "name": "Calendar Event Changes",
4640
+ "description": "**SOON TO BE DEPRECATED** - Use Calendar Event Sync (polling trigger) instead.\n Real-time webhook trigger for calendar event changes. Returns event metadata only.\n For full event data, use Calendar Event Sync (polling trigger)."
4641
+ },
4642
+ {
4643
+ "slug": "GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGER",
4644
+ "name": "Event Created",
4645
+ "description": "Polling trigger that fires when a new calendar event is created.\n Returns event ID, summary, start/end times, and organizer info."
4646
+ },
4647
+ {
4648
+ "slug": "GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGER",
4649
+ "name": "Calendar Event Sync",
4650
+ "description": "Polling trigger that returns full event data including details, attendees, and metadata.\n For real-time notifications with basic info, use Calendar Event Changes (webhook)."
4651
+ },
4652
+ {
4653
+ "slug": "GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGER",
4654
+ "name": "Event Updated",
4655
+ "description": "Triggers when an existing Google Calendar event is modified. Returns the event ID,\n change type, and the specific fields that changed with their previous and new values."
4656
+ }
4657
+ ]
4658
+ },
4659
+ {
4660
+ "slug": "notion",
4661
+ "name": "Notion",
4662
+ "logo": "https://logos.composio.dev/api/notion",
4663
+ "description": "Notion centralizes notes, docs, wikis, and tasks in a unified workspace, letting teams build custom workflows for collaboration and knowledge management",
4664
+ "category": "productivity & project management",
4665
+ "authSchemes": [
4666
+ "OAUTH2",
4667
+ "API_KEY"
4668
+ ],
4669
+ "toolCount": 28,
4670
+ "triggerCount": 5,
4671
+ "version": "20260102_01",
4672
+ "tools": [
4673
+ {
4674
+ "slug": "NOTION_ADD_MULTIPLE_PAGE_CONTENT",
4675
+ "name": "Add multiple content blocks (bulk, user-friendly)",
4676
+ "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."
4677
+ },
4678
+ {
4679
+ "slug": "NOTION_ADD_PAGE_CONTENT",
4680
+ "name": "Add content to Notion page",
4681
+ "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."
4682
+ },
4683
+ {
4684
+ "slug": "NOTION_APPEND_BLOCK_CHILDREN",
4685
+ "name": "Append complex blocks (advanced, full control)",
4686
+ "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."
4687
+ },
4688
+ {
4689
+ "slug": "NOTION_ARCHIVE_NOTION_PAGE",
4690
+ "name": "Archive Notion Page",
4691
+ "description": "Archives (moves to trash) or unarchives (restores from trash) a specified notion page."
4692
+ },
4693
+ {
4694
+ "slug": "NOTION_CREATE_COMMENT",
4695
+ "name": "Create comment",
4696
+ "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)."
4697
+ },
4698
+ {
4699
+ "slug": "NOTION_CREATE_DATABASE",
4700
+ "name": "Create Notion Database",
4701
+ "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."
4702
+ },
4703
+ {
4704
+ "slug": "NOTION_CREATE_NOTION_PAGE",
4705
+ "name": "Create Notion page",
4706
+ "description": "Creates a new empty page in a notion workspace."
4707
+ },
4708
+ {
4709
+ "slug": "NOTION_DELETE_BLOCK",
4710
+ "name": "Delete a block",
4711
+ "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."
4712
+ },
4713
+ {
4714
+ "slug": "NOTION_DUPLICATE_PAGE",
4715
+ "name": "Duplicate page",
4716
+ "description": "Duplicates a notion page, including all its content, properties, and nested blocks, under a specified parent page or workspace."
4717
+ },
4718
+ {
4719
+ "slug": "NOTION_FETCH_BLOCK_CONTENTS",
4720
+ "name": "Fetch Notion Block Children",
4721
+ "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."
4722
+ },
4723
+ {
4724
+ "slug": "NOTION_FETCH_BLOCK_METADATA",
4725
+ "name": "Fetch Notion block metadata",
4726
+ "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."
4727
+ },
4728
+ {
4729
+ "slug": "NOTION_FETCH_COMMENTS",
4730
+ "name": "Fetch comments",
4731
+ "description": "Fetches unresolved comments for a specified notion block or page id."
4732
+ },
4733
+ {
4734
+ "slug": "NOTION_FETCH_DATA",
4735
+ "name": "Fetch Notion Data",
4736
+ "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"
4737
+ },
4738
+ {
4739
+ "slug": "NOTION_FETCH_DATABASE",
4740
+ "name": "Fetch Database",
4741
+ "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."
4742
+ },
4743
+ {
4744
+ "slug": "NOTION_FETCH_ROW",
4745
+ "name": "Fetch database row",
4746
+ "description": "Retrieves a notion database row's properties and metadata; use fetch block contents for page content blocks."
4747
+ },
4748
+ {
4749
+ "slug": "NOTION_GET_ABOUT_ME",
4750
+ "name": "Get About Me",
4751
+ "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."
4752
+ },
4753
+ {
4754
+ "slug": "NOTION_GET_ABOUT_USER",
4755
+ "name": "Get about user",
4756
+ "description": "Retrieves detailed information about a specific notion user, such as their name, avatar, and email, based on their unique user id."
4757
+ },
4758
+ {
4759
+ "slug": "NOTION_GET_PAGE_PROPERTY_ACTION",
4760
+ "name": "Get page property",
4761
+ "description": "Call this to get a specific property from a notion page when you have a valid `page id` and `property id`; handles pagination for properties returning multiple items."
4762
+ },
4763
+ {
4764
+ "slug": "NOTION_INSERT_ROW_DATABASE",
4765
+ "name": "Insert row database",
4766
+ "description": "Creates a new page (row) in a specified notion database."
4767
+ },
4768
+ {
4769
+ "slug": "NOTION_LIST_USERS",
4770
+ "name": "List users",
4771
+ "description": "Retrieves a paginated list of users (excluding guests) from the notion workspace; the number of users returned per page may be less than the requested `page size`."
4772
+ },
4773
+ {
4774
+ "slug": "NOTION_QUERY_DATABASE",
4775
+ "name": "Query database",
4776
+ "description": "Queries a notion database for pages (rows), where rows are pages and columns are properties; ensure sort property names correspond to existing database properties."
4777
+ },
4778
+ {
4779
+ "slug": "NOTION_RETRIEVE_COMMENT",
4780
+ "name": "Retrieve Comment",
4781
+ "description": "Tool to retrieve a specific comment by its id. use when you have a comment id and need to fetch its details."
4782
+ },
4783
+ {
4784
+ "slug": "NOTION_RETRIEVE_DATABASE_PROPERTY",
4785
+ "name": "Retrieve Database Property",
4786
+ "description": "Tool to retrieve a specific property object of a notion database. use when you need to get details about a single database column/property."
4787
+ },
4788
+ {
4789
+ "slug": "NOTION_SEARCH_NOTION_PAGE",
4790
+ "name": "Search Notion page",
4791
+ "description": "Searches notion pages and databases by title; an empty query lists all accessible items, useful for discovering ids or as a fallback when a specific query yields no results."
4792
+ },
4793
+ {
4794
+ "slug": "NOTION_UPDATE_BLOCK",
4795
+ "name": "Update block",
4796
+ "description": "Updates an existing notion block's textual content or type-specific properties (e.g., 'checked' status, 'color'), using its `block id` and the specified `block type`."
4797
+ },
4798
+ {
4799
+ "slug": "NOTION_UPDATE_PAGE",
4800
+ "name": "Update Page",
4801
+ "description": "Tool to update the properties, icon, cover, or archive status of a page. use when you need to modify existing page attributes."
4802
+ },
4803
+ {
4804
+ "slug": "NOTION_UPDATE_ROW_DATABASE",
4805
+ "name": "Update row database",
4806
+ "description": "Updates or archives an existing notion database row (page) using its `row id`, allowing modification of its icon, cover, and/or properties; ensure the target page is accessible and property details (names/ids and values) align with the database schema and specified formats."
4807
+ },
4808
+ {
4809
+ "slug": "NOTION_UPDATE_SCHEMA_DATABASE",
4810
+ "name": "Update database schema",
4811
+ "description": "Updates an existing notion database's title, description, and/or properties; at least one of these attributes must be provided to effect a change."
4812
+ }
4813
+ ],
4814
+ "triggers": [
4815
+ {
4816
+ "slug": "NOTION_ALL_PAGE_EVENTS_TRIGGER",
4817
+ "name": "All Page Events",
4818
+ "description": "Triggers when any Notion page is created or updated across the workspace."
4819
+ },
4820
+ {
4821
+ "slug": "NOTION_COMMENTS_ADDED_TRIGGER",
4822
+ "name": "New Comment",
4823
+ "description": "Triggers when a new comment is added to a specified Notion block or page."
4824
+ },
4825
+ {
4826
+ "slug": "NOTION_PAGE_ADDED_TO_DATABASE",
4827
+ "name": "New Page",
4828
+ "description": "Triggers when a new page is added to a Notion database."
4829
+ },
4830
+ {
4831
+ "slug": "NOTION_PAGE_ADDED_TRIGGER",
4832
+ "name": "Page Added to Page",
4833
+ "description": "Fires when a new subpage (a `child_page` type block) is added under a specified parent Notion page."
4834
+ },
4835
+ {
4836
+ "slug": "NOTION_PAGE_UPDATED_TRIGGER",
4837
+ "name": "Page Updated",
4838
+ "description": "Triggers when any block within a specified Notion page is updated."
4839
+ }
4840
+ ]
4841
+ },
4842
+ {
4843
+ "slug": "googlesheets",
4844
+ "name": "Google Sheets",
4845
+ "logo": "https://logos.composio.dev/api/googlesheets",
4846
+ "description": "Google Sheets is a cloud-based spreadsheet tool enabling real-time collaboration, data analysis, and integration with other Google Workspace apps",
4847
+ "category": "productivity & project management",
4848
+ "authSchemes": [
4849
+ "OAUTH2"
4850
+ ],
4851
+ "toolCount": 36,
4852
+ "triggerCount": 2,
4853
+ "version": "20260102_01",
4854
+ "tools": [
4855
+ {
4856
+ "slug": "GOOGLESHEETS_ADD_SHEET",
4857
+ "name": "Add Sheet to Spreadsheet",
4858
+ "description": "Adds a new sheet (worksheet) to a spreadsheet. use this tool to create a new tab within an existing google sheet, optionally specifying its title, index, size, and other properties."
4859
+ },
4860
+ {
4861
+ "slug": "GOOGLESHEETS_AGGREGATE_COLUMN_DATA",
4862
+ "name": "Aggregate Column Data",
4863
+ "description": "Searches for rows where a specific column matches a value and performs mathematical operations on data from another column."
4864
+ },
4865
+ {
4866
+ "slug": "GOOGLESHEETS_APPEND_DIMENSION",
4867
+ "name": "Append Dimension",
4868
+ "description": "Tool to append new rows or columns to a sheet, increasing its size. use when you need to add empty rows or columns to an existing sheet."
4869
+ },
4870
+ {
4871
+ "slug": "GOOGLESHEETS_BATCH_GET",
4872
+ "name": "Batch get spreadsheet",
4873
+ "description": "Retrieves data from specified cell ranges in a google spreadsheet; ensure the spreadsheet has at least one worksheet and any explicitly referenced sheet names in ranges exist."
4874
+ },
4875
+ {
4876
+ "slug": "GOOGLESHEETS_BATCH_UPDATE",
4877
+ "name": "Batch update spreadsheet",
4878
+ "description": "Updates a specified range in a google sheet with given values, or appends them as new rows if `first cell location` is omitted; ensure the target sheet exists and the spreadsheet contains at least one worksheet."
4879
+ },
4880
+ {
4881
+ "slug": "GOOGLESHEETS_BATCH_UPDATE_VALUES_BY_DATA_FILTER",
4882
+ "name": "Batch Update Values by Data Filter",
4883
+ "description": "Tool to update values in ranges matching data filters. use when you need to update specific data in a google sheet based on criteria rather than fixed cell ranges."
4884
+ },
4885
+ {
4886
+ "slug": "GOOGLESHEETS_CLEAR_BASIC_FILTER",
4887
+ "name": "Clear Basic Filter",
4888
+ "description": "Tool to clear the basic filter from a sheet. use when you need to remove an existing basic filter from a specific sheet within a google spreadsheet."
4889
+ },
4890
+ {
4891
+ "slug": "GOOGLESHEETS_CLEAR_VALUES",
4892
+ "name": "Clear spreadsheet values",
4893
+ "description": "Clears cell content (preserving formatting and notes) from a specified a1 notation range in a google spreadsheet; the range must correspond to an existing sheet and cells."
4894
+ },
4895
+ {
4896
+ "slug": "GOOGLESHEETS_CREATE_CHART",
4897
+ "name": "Create Chart in Google Sheets",
4898
+ "description": "Create a chart in a google sheets spreadsheet using the specified data range and chart type."
4899
+ },
4900
+ {
4901
+ "slug": "GOOGLESHEETS_CREATE_GOOGLE_SHEET1",
4902
+ "name": "Create a Google Sheet",
4903
+ "description": "Creates a new google spreadsheet in google drive using the provided title."
4904
+ },
4905
+ {
4906
+ "slug": "GOOGLESHEETS_CREATE_SPREADSHEET_COLUMN",
4907
+ "name": "Create spreadsheet column",
4908
+ "description": "Creates a new column in a google spreadsheet, requiring a valid `spreadsheet id` and an existing `sheet id`; an out-of-bounds `insert index` may append/prepend the column."
4909
+ },
4910
+ {
4911
+ "slug": "GOOGLESHEETS_CREATE_SPREADSHEET_ROW",
4912
+ "name": "Create spreadsheet row",
4913
+ "description": "Inserts a new, empty row into a specified sheet of a google spreadsheet at a given index, optionally inheriting formatting from the row above."
4914
+ },
4915
+ {
4916
+ "slug": "GOOGLESHEETS_DELETE_DIMENSION",
4917
+ "name": "Delete Dimension (Rows/Columns)",
4918
+ "description": "Tool to delete specified rows or columns from a sheet in a google spreadsheet. use when you need to remove a range of rows or columns."
4919
+ },
4920
+ {
4921
+ "slug": "GOOGLESHEETS_DELETE_SHEET",
4922
+ "name": "Delete Sheet",
4923
+ "description": "Tool to delete a sheet (worksheet) from a spreadsheet. use when you need to remove a specific sheet from a google sheet document."
4924
+ },
4925
+ {
4926
+ "slug": "GOOGLESHEETS_EXECUTE_SQL",
4927
+ "name": "Execute SQL on Spreadsheet",
4928
+ "description": "Execute sql queries against google sheets tables. supports select, insert, update, and delete operations with familiar sql syntax. tables are automatically detected and mapped from the spreadsheet structure."
4929
+ },
4930
+ {
4931
+ "slug": "GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE",
4932
+ "name": "Find worksheet by title",
4933
+ "description": "Finds a worksheet by its exact, case-sensitive title within a google spreadsheet; returns a boolean indicating if found and the complete metadata of the entire spreadsheet, regardless of whether the target worksheet is found."
4934
+ },
4935
+ {
4936
+ "slug": "GOOGLESHEETS_FORMAT_CELL",
4937
+ "name": "Format cell",
4938
+ "description": "Applies text and background cell formatting to a specified range in a google sheets worksheet."
4939
+ },
4940
+ {
4941
+ "slug": "GOOGLESHEETS_GET_SHEET_NAMES",
4942
+ "name": "Get sheet names",
4943
+ "description": "Lists all worksheet names from a specified google spreadsheet (which must exist), useful for discovering sheets before further operations."
4944
+ },
4945
+ {
4946
+ "slug": "GOOGLESHEETS_GET_SPREADSHEET_BY_DATA_FILTER",
4947
+ "name": "Get Spreadsheet by Data Filter",
4948
+ "description": "Returns the spreadsheet at the given id, filtered by the specified data filters. use this tool when you need to retrieve specific subsets of data from a google sheet based on criteria like a1 notation, developer metadata, or grid ranges."
4949
+ },
4950
+ {
4951
+ "slug": "GOOGLESHEETS_GET_SPREADSHEET_INFO",
4952
+ "name": "Get spreadsheet info",
4953
+ "description": "Retrieves comprehensive metadata for a google spreadsheet using its id, excluding cell data."
4954
+ },
4955
+ {
4956
+ "slug": "GOOGLESHEETS_GET_TABLE_SCHEMA",
4957
+ "name": "Get Table Schema",
4958
+ "description": "This action is used to get the schema of a table in a google spreadsheet, call this action to get the schema of a table in a spreadsheet before you query the table. analyze table structure and infer column names, types, and constraints. uses statistical analysis of sample data to determine the most likely data type for each column. call this action after calling the list tables action to get the schema of a table in a spreadsheet."
4959
+ },
4960
+ {
4961
+ "slug": "GOOGLESHEETS_INSERT_DIMENSION",
4962
+ "name": "Insert Dimension in Google Sheet",
4963
+ "description": "Tool to insert new rows or columns into a sheet at a specified location. use when you need to add empty rows or columns within an existing google sheet."
4964
+ },
4965
+ {
4966
+ "slug": "GOOGLESHEETS_LIST_TABLES",
4967
+ "name": "List Tables in Spreadsheet",
4968
+ "description": "This action is used to list all tables in a google spreadsheet, call this action to get the list of tables in a spreadsheet. discover all tables in a google spreadsheet by analyzing sheet structure and detecting data patterns. uses heuristic analysis to find header rows, data boundaries, and table structures."
4969
+ },
4970
+ {
4971
+ "slug": "GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW",
4972
+ "name": "Look up spreadsheet row",
4973
+ "description": "Finds the first row in a google spreadsheet where a cell's entire content exactly matches the query string, searching within a specified a1 notation range or the first sheet by default."
4974
+ },
4975
+ {
4976
+ "slug": "GOOGLESHEETS_QUERY_TABLE",
4977
+ "name": "Query Spreadsheet Table",
4978
+ "description": "This action is used to query a table in a google spreadsheet, call this action to query a table in a spreadsheet. execute sql-like select queries against spreadsheet tables. supports where conditions, order by, limit clauses. call this action after calling the get table schema action to query a table in a spreadsheet."
4979
+ },
4980
+ {
4981
+ "slug": "GOOGLESHEETS_SEARCH_DEVELOPER_METADATA",
4982
+ "name": "Search Developer Metadata",
4983
+ "description": "Tool to search for developer metadata in a spreadsheet. use when you need to find specific metadata entries based on filters."
4984
+ },
4985
+ {
4986
+ "slug": "GOOGLESHEETS_SEARCH_SPREADSHEETS",
4987
+ "name": "Search Spreadsheets",
4988
+ "description": "Search for google spreadsheets using various filters including name, content, date ranges, and more."
4989
+ },
4990
+ {
4991
+ "slug": "GOOGLESHEETS_SET_BASIC_FILTER",
4992
+ "name": "Set Basic Filter",
4993
+ "description": "Tool to set a basic filter on a sheet in a google spreadsheet. use when you need to filter or sort data within a specific range on a sheet."
4994
+ },
4995
+ {
4996
+ "slug": "GOOGLESHEETS_SHEET_FROM_JSON",
4997
+ "name": "Create sheet from JSON",
4998
+ "description": "Creates a new google spreadsheet and populates its first worksheet from `sheet json`, which must be non-empty as its first item's keys establish the headers."
4999
+ },
This file is too large to show in full.
fumadocs/scripts/generate-toolkits.ts
new
+220
@@ -0,0 +1,220 @@
1
+/**
2
+ * Toolkit Generator Script
3
+ *
4
+ * Fetches all toolkits from Composio API and generates:
5
+ * - /public/data/toolkits.json (all toolkits with tools & triggers)
6
+ *
7
+ * Run: bun run generate:toolkits
8
+ */
9
+
10
+import { mkdir, writeFile } from 'fs/promises';
11
+import { join } from 'path';
12
+
13
+const API_BASE = process.env.COMPOSIO_API_BASE || 'https://backend.composio.dev/api/v3';
14
+const API_KEY = process.env.COMPOSIO_API_KEY;
15
+
16
+if (!API_KEY) {
17
+ console.error('Error: COMPOSIO_API_KEY environment variable is required');
18
+ process.exit(1);
19
+}
20
+
21
+const OUTPUT_DIR = join(process.cwd(), 'public/data');
22
+
23
+interface Tool {
24
+ slug: string;
25
+ name: string;
26
+ description: string;
27
+}
28
+
29
+interface Trigger {
30
+ slug: string;
31
+ name: string;
32
+ description: string;
33
+}
34
+
35
+interface Toolkit {
36
+ slug: string;
37
+ name: string;
38
+ logo: string | null;
39
+ description: string;
40
+ category: string | null;
41
+ authSchemes: string[];
42
+ toolCount: number;
43
+ triggerCount: number;
44
+ version: string | null;
45
+ tools: Tool[];
46
+ triggers: Trigger[];
47
+}
48
+
49
+async function fetchToolkits(): Promise<any[]> {
50
+ console.log('Fetching toolkits from API...');
51
+
52
+ const response = await fetch(`${API_BASE}/toolkits`, {
53
+ headers: {
54
+ 'Content-Type': 'application/json',
55
+ 'x-api-key': API_KEY!,
56
+ },
57
+ });
58
+
59
+ if (!response.ok) {
60
+ throw new Error(`Failed to fetch toolkits: ${response.status} ${response.statusText}`);
61
+ }
62
+
63
+ const data = await response.json();
64
+ return data.items || data;
65
+}
66
+
67
+async function fetchToolkitChangelog(): Promise<Map<string, string>> {
68
+ console.log('Fetching toolkit changelog...');
69
+
70
+ const response = await fetch(`${API_BASE}/toolkits/changelog`, {
71
+ headers: {
72
+ 'Content-Type': 'application/json',
73
+ 'x-api-key': API_KEY!,
74
+ },
75
+ });
76
+
77
+ if (!response.ok) {
78
+ console.warn(`Failed to fetch changelog: ${response.status}`);
79
+ return new Map();
80
+ }
81
+
82
+ const data = await response.json();
83
+ const versionMap = new Map<string, string>();
84
+
85
+ // Response format: { items: [{ slug, name, display_name, versions: [{ version, changelog }] }] }
86
+ const items = data.items || [];
87
+ for (const entry of items) {
88
+ const slug = entry.slug?.toLowerCase();
89
+ const latestVersion = entry.versions?.[0]?.version;
90
+ if (slug && latestVersion) {
91
+ versionMap.set(slug, latestVersion);
92
+ }
93
+ }
94
+
95
+ console.log(`Found versions for ${versionMap.size} toolkits`);
96
+ return versionMap;
97
+}
98
+
99
+async function fetchToolsForToolkit(slug: string): Promise<Tool[]> {
100
+ const response = await fetch(`${API_BASE}/tools?toolkit_slug=${slug}&limit=1000`, {
101
+ headers: {
102
+ 'Content-Type': 'application/json',
103
+ 'x-api-key': API_KEY!,
104
+ },
105
+ });
106
+
107
+ if (!response.ok) return [];
108
+
109
+ const data = await response.json();
110
+ const items = data.items || data || [];
111
+
112
+ return items.map((raw: any) => ({
113
+ slug: raw.slug || '',
114
+ name: raw.name || raw.display_name || raw.slug || '',
115
+ description: raw.description || '',
116
+ }));
117
+}
118
+
119
+async function fetchTriggersForToolkit(slug: string): Promise<Trigger[]> {
120
+ const response = await fetch(`${API_BASE}/triggers_types?toolkit_slugs=${slug}`, {
121
+ headers: {
122
+ 'Content-Type': 'application/json',
123
+ 'x-api-key': API_KEY!,
124
+ },
125
+ });
126
+
127
+ if (!response.ok) return [];
128
+
129
+ const data = await response.json();
130
+ const items = data.items || data || [];
131
+
132
+ return items.map((raw: any) => ({
133
+ slug: raw.slug || '',
134
+ name: raw.name || raw.display_name || raw.slug || '',
135
+ description: raw.description || '',
136
+ }));
137
+}
138
+
139
+function transformToolkit(raw: any): Toolkit {
140
+ return {
141
+ slug: raw.slug?.toLowerCase() || '',
142
+ name: raw.name || raw.slug || '',
143
+ logo: raw.meta?.logo || raw.logo || null,
144
+ description: raw.meta?.description || raw.description || '',
145
+ category: raw.meta?.categories?.[0]?.name || raw.meta?.categories?.[0] || null,
146
+ authSchemes: raw.auth_schemes || raw.authSchemes || [],
147
+ toolCount: raw.tool_count || raw.toolCount || 0,
148
+ triggerCount: raw.trigger_count || raw.triggerCount || 0,
149
+ version: null,
150
+ tools: [],
151
+ triggers: [],
152
+ };
153
+}
154
+
155
+async function main() {
156
+ console.log('Starting toolkit generation...\n');
157
+
158
+ // Create output directory
159
+ await mkdir(OUTPUT_DIR, { recursive: true });
160
+
161
+ // Fetch all toolkits and changelog in parallel
162
+ const [rawToolkits, versionMap] = await Promise.all([
163
+ fetchToolkits(),
164
+ fetchToolkitChangelog(),
165
+ ]);
166
+ console.log(`Found ${rawToolkits.length} toolkits\n`);
167
+
168
+ // Transform toolkits
169
+ const toolkits: Toolkit[] = rawToolkits.map(transformToolkit);
170
+
171
+ // Add versions from changelog
172
+ for (const toolkit of toolkits) {
173
+ toolkit.version = versionMap.get(toolkit.slug) || null;
174
+ }
175
+
176
+ // Fetch tools and triggers for each toolkit in batches
177
+ console.log('Fetching tools and triggers...');
178
+ const batchSize = 10;
179
+ let completed = 0;
180
+
181
+ for (let i = 0; i < toolkits.length; i += batchSize) {
182
+ const batch = toolkits.slice(i, i + batchSize);
183
+
184
+ await Promise.all(
185
+ batch.map(async (toolkit) => {
186
+ const [tools, triggers] = await Promise.all([
187
+ fetchToolsForToolkit(toolkit.slug.toUpperCase()),
188
+ fetchTriggersForToolkit(toolkit.slug.toUpperCase()),
189
+ ]);
190
+
191
+ toolkit.tools = tools;
192
+ toolkit.triggers = triggers;
193
+ toolkit.toolCount = tools.length;
194
+ toolkit.triggerCount = triggers.length;
195
+
196
+ completed++;
197
+ process.stdout.write(`\r Progress: ${completed}/${toolkits.length}`);
198
+ })
199
+ );
200
+ }
201
+
202
+ console.log('\n');
203
+
204
+ // Write single file
205
+ await writeFile(
206
+ join(OUTPUT_DIR, 'toolkits.json'),
207
+ JSON.stringify(toolkits, null, 2)
208
+ );
209
+
210
+ const fileSizeKB = Math.round(JSON.stringify(toolkits).length / 1024);
211
+ console.log('Generation complete!');
212
+ console.log(` Output: public/data/toolkits.json`);
213
+ console.log(` Toolkits: ${toolkits.length}`);
214
+ console.log(` File size: ~${fileSizeKB}KB`);
215
+}
216
+
217
+main().catch((error) => {
218
+ console.error('Fatal error:', error);
219
+ process.exit(1);
220
+});
fumadocs/types/toolkit.ts
new
+25
@@ -0,0 +1,25 @@
1
+export interface Tool {
2
+ slug: string;
3
+ name: string;
4
+ description: string;
5
+}
6
+
7
+export interface Trigger {
8
+ slug: string;
9
+ name: string;
10
+ description: string;
11
+}
12
+
13
+export interface Toolkit {
14
+ slug: string;
15
+ name: string;
16
+ logo: string | null;
17
+ description: string;
18
+ category: string | null;
19
+ authSchemes: string[];
20
+ toolCount: number;
21
+ triggerCount: number;
22
+ version: string | null;
23
+ tools: Tool[];
24
+ triggers: Trigger[];
25
+}