Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 22, 15:45 UTC
revert: remove Twoslash annotations from docs content
Revert all content changes from the previous Twoslash implementation to start fresh with a cleaner approach. The Twoslash infrastructure remains in place (source.config.ts with explicitTrigger: true), but content files are restored to their original state without annotations. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sushmithamallesh committed
Jan 12, 2026 at 15:06 UTC
4248a1b93f55469915b64066b778122d118d61c2
8 files changed
+45
-166
fumadocs/content/docs/authenticating-tools.mdx
+10
-21
@@ -129,10 +129,10 @@ print(f"Visit: {redirect_url} to authenticate your account")
129
```
130
</Tab>
131
<Tab value="TypeScript">
132
-```typescript twoslash
132
+```typescript
133
import { Composio } from '@composio/core';
134
135
-const composio = new Composio({ apiKey: "your_api_key" });
135
+const composio = new Composio({apiKey: "your_api_key"});
136
137
// Use the "AUTH CONFIG ID" from your dashboard
138
const authConfigId = 'your_auth_config_id';
@@ -202,10 +202,10 @@ print(f"Connection established: {connected_account.id}")
202
```
203
</Tab>
204
<Tab value="TypeScript">
205
-```typescript twoslash
205
+```typescript
206
import { Composio } from '@composio/core';
207
208
-const composio = new Composio({ apiKey: "YOUR_COMPOSIO_API_KEY" });
208
+const composio = new Composio({apiKey: "YOUR_COMPOSIO_API_KEY"});
209
210
// Use the "AUTH CONFIG ID" from your dashboard
211
const authConfigId = 'your_auth_config_id';
@@ -249,12 +249,8 @@ connection_request = composio.connected_accounts.initiate(
249
```
250
</Tab>
251
<Tab value="TypeScript">
252
-```typescript twoslash
253
-import { Composio, AuthScheme } from '@composio/core';
254
-const composio = new Composio({ apiKey: "your_api_key" });
255
-const userId = 'user_123';
256
-const authConfigId = 'your_auth_config_id';
257
-// ---cut---
252
+```typescript
253
+import { AuthScheme } from '@composio/core';
254
// For Zendesk - include subdomain
255
const connRequest = await composio.connectedAccounts.initiate(userId, authConfigId, {
256
config: AuthScheme.OAuth2({
@@ -300,7 +296,7 @@ print(f"Connection established: {connection_request.id}")
296
```
297
</Tab>
298
<Tab value="TypeScript">
303
-```typescript twoslash
299
+```typescript
300
import { Composio, AuthScheme } from '@composio/core';
301
302
const composio = new Composio({ apiKey: 'your_api_key' });
@@ -350,7 +346,7 @@ print(f"Required fields: {auth_config.expected_input_fields}")
346
```
347
</Tab>
348
<Tab value="TypeScript">
353
-```typescript twoslash
349
+```typescript
350
import { Composio } from '@composio/core';
351
352
const composio = new Composio({ apiKey: 'your_api_key' });
@@ -420,11 +416,7 @@ print(connected_account.id)
416
```
417
</Tab>
418
<Tab value="TypeScript">
423
-```typescript twoslash
424
-import { Composio } from '@composio/core';
425
-const composio = new Composio({ apiKey: 'your_api_key' });
426
-const connectionRequest = await composio.connectedAccounts.initiate('user_123', 'auth_config_id', {});
427
-// ---cut---
419
+```typescript
420
// Wait for the connection to be established
421
const connectedAccount = await connectionRequest.waitForConnection();
422
console.log(connectedAccount.id);
@@ -466,10 +458,7 @@ for connection in filtered_connections.items:
458
```
459
</Tab>
460
<Tab value="TypeScript">
469
-```typescript twoslash
470
-import { Composio } from '@composio/core';
471
-const composio = new Composio({ apiKey: 'your_api_key' });
472
-// ---cut---
461
+```typescript
462
// Get a specific connected account by its nanoid
463
const connectedAccount = await composio.connectedAccounts.get('your_connected_account_id');
464
console.log(`Status: ${connectedAccount.status}`);
fumadocs/content/docs/connected-accounts.mdx
+8
-42
@@ -28,11 +28,7 @@ active_accounts = composio.connected_accounts.list(
28
```
29
</Tab>
30
<Tab value="TypeScript">
31
-```typescript twoslash
32
-import { Composio } from '@composio/core';
33
-const composio = new Composio({ apiKey: 'your_api_key' });
34
-const userId = 'user_123';
35
-// ---cut---
31
+```typescript
32
// List all accounts for a user
33
const accounts = await composio.connectedAccounts.list({
34
userIds: [userId]
@@ -61,11 +57,7 @@ print(f"Toolkit: {account.toolkit.slug}")
57
```
58
</Tab>
59
<Tab value="TypeScript">
64
-```typescript twoslash
65
-import { Composio } from '@composio/core';
66
-const composio = new Composio({ apiKey: 'your_api_key' });
67
-const connectedAccountId = 'ca_123';
68
-// ---cut---
60
+```typescript
61
const account = await composio.connectedAccounts.get(connectedAccountId);
62
63
console.log('Status:', account.status);
@@ -92,11 +84,7 @@ if account.state:
84
```
85
</Tab>
86
<Tab value="TypeScript">
95
-```typescript twoslash
96
-import { Composio } from '@composio/core';
97
-const composio = new Composio({ apiKey: 'your_api_key' });
98
-const account = await composio.connectedAccounts.get('ca_123');
99
-// ---cut---
87
+```typescript
88
// Get the connected account's authentication state
89
if (account.state) {
90
// The state contains the auth scheme and credentials
@@ -134,11 +122,7 @@ except Exception as e:
122
```
123
</Tab>
124
<Tab value="TypeScript">
137
-```typescript twoslash
138
-import { Composio } from '@composio/core';
139
-const composio = new Composio({ apiKey: 'your_api_key' });
140
-const connectedAccountId = 'ca_123';
141
-// ---cut---
125
+```typescript
126
try {
127
const refreshed = await composio.connectedAccounts.refresh(connectedAccountId);
128
console.log('Redirect URL:', refreshed.redirect_url);
@@ -171,11 +155,7 @@ print(f"Account enabled status: {enabled.success}")
155
```
156
</Tab>
157
<Tab value="TypeScript">
174
-```typescript twoslash
175
-import { Composio } from '@composio/core';
176
-const composio = new Composio({ apiKey: 'your_api_key' });
177
-const connectedAccountId = 'ca_123';
178
-// ---cut---
158
+```typescript
159
// Disable an account
160
const disabled = await composio.connectedAccounts.disable(connectedAccountId);
161
console.log('Account disabled status:', disabled.success);
@@ -204,11 +184,7 @@ print("Account deleted successfully")
184
```
185
</Tab>
186
<Tab value="TypeScript">
207
-```typescript twoslash
208
-import { Composio } from '@composio/core';
209
-const composio = new Composio({ apiKey: 'your_api_key' });
210
-const connectedAccountId = 'ca_123';
211
-// ---cut---
187
+```typescript
188
// Delete a connected account
189
await composio.connectedAccounts.delete(connectedAccountId);
190
console.log('Account deleted successfully');
@@ -258,12 +234,7 @@ except Exception as e:
234
```
235
</Tab>
236
<Tab value="TypeScript">
261
-```typescript twoslash
262
-import { Composio } from '@composio/core';
263
-const composio = new Composio({ apiKey: 'your_api_key' });
264
-const userId = 'user_123';
265
-const authConfigId = 'ac_123';
266
-// ---cut---
237
+```typescript
238
// First account
239
try {
240
const firstAccount = await composio.connectedAccounts.initiate(
@@ -315,12 +286,7 @@ print(f"Tool executed: {result}")
286
```
287
</Tab>
288
<Tab value="TypeScript">
318
-```typescript twoslash
319
-import { Composio } from '@composio/core';
320
-const composio = new Composio({ apiKey: 'your_api_key' });
321
-const userId = 'user_123';
322
-const connectedAccountId = 'ca_123';
323
-// ---cut---
289
+```typescript
290
// Execute tool with a specific connected account
291
const result = await composio.tools.execute('GMAIL_GET_PROFILE', {
292
userId: userId,
fumadocs/content/docs/custom-auth-configs.mdx
+2
-7
@@ -101,11 +101,7 @@ print(connected_account)
101
```
102
</Tab>
103
<Tab value="TypeScript">
104
-```typescript twoslash
105
-import { Composio } from '@composio/core';
106
-const composio = new Composio({ apiKey: 'your_api_key' });
107
-const userId = 'user_123';
108
-// ---cut---
104
+```typescript
105
const connReq = await composio.connectedAccounts.initiate(userId, "ac_1234");
106
107
console.log(connReq.redirectUrl);
@@ -179,8 +175,7 @@ def authorize_app(toolkit: str):
175
```
176
</Tab>
177
<Tab value="TypeScript">
182
-```typescript twoslash
183
-// @noErrors
178
+```typescript
179
import type { NextApiRequest, NextApiResponse } from 'next';
180
181
export default function handler(req: NextApiRequest, res: NextApiResponse) {
fumadocs/content/docs/custom-auth-params.mdx
+4
-12
@@ -19,7 +19,7 @@ composio = Composio()
19
```
20
</Tab>
21
<Tab value="TypeScript">
22
-```typescript twoslash
22
+```typescript
23
import { Composio } from "@composio/core";
24
25
const composio = new Composio({
@@ -64,12 +64,8 @@ def add_custom_auth(
64
```
65
</Tab>
66
<Tab value="TypeScript">
67
-```typescript twoslash
68
-const authModifier = ({ toolSlug, toolkitSlug, params }: {
69
- toolSlug: string;
70
- toolkitSlug: string;
71
- params: any;
72
-}) => {
67
+```typescript
68
+const authModifier = (toolSlug: string, toolkitSlug: string, params: any) => {
69
// Add authentication parameters for specific toolkits
70
if (toolkitSlug === "NOTION") {
71
if (!params.customAuthParams) {
@@ -116,11 +112,7 @@ print(result)
112
```
113
</Tab>
114
<Tab value="TypeScript">
119
-```typescript twoslash
120
-import { Composio } from '@composio/core';
121
-const composio = new Composio({ apiKey: 'your_api_key' });
122
-const authModifier = ({ params }: { toolSlug: string; toolkitSlug: string; params: any }) => params;
123
-// ---cut---
115
+```typescript
116
const result = await composio.tools.execute(
117
"NOTION_GET_DATABASE_ITEMS",
118
{
fumadocs/content/docs/custom-tools.mdx
+5
-28
@@ -44,12 +44,7 @@ def add_two_numbers(request: AddTwoNumbersInput) -> int:
44
```
45
</Tab>
46
<Tab value="TypeScript">
47
-```typescript twoslash
48
-// @noErrors
49
-import { Composio } from '@composio/core';
50
-import { z } from 'zod';
51
-const composio = new Composio({ apiKey: 'your_api_key' });
52
-// ---cut---
47
+```typescript
48
const tool = await composio.tools.createCustomTool({
49
slug: 'CALCULATE_SQUARE',
50
name: 'Calculate Square',
@@ -113,12 +108,7 @@ def get_issue_info(
108
```
109
</Tab>
110
<Tab value="TypeScript">
116
-```typescript twoslash
117
-// @noErrors
118
-import { Composio } from '@composio/core';
119
-import { z } from 'zod';
120
-const composio = new Composio({ apiKey: 'your_api_key' });
121
-// ---cut---
111
+```typescript
112
const tool = await composio.tools.createCustomTool({
113
slug: 'GITHUB_STAR_COMPOSIOHQ_REPOSITORY',
114
name: 'Github star composio repositories',
@@ -185,12 +175,7 @@ def get_issue_info_direct(
175
```
176
</Tab>
177
<Tab value="TypeScript">
188
-```typescript twoslash
189
-// @noErrors
190
-import { Composio } from '@composio/core';
191
-import { z } from 'zod';
192
-const composio = new Composio({ apiKey: 'your_api_key' });
193
-// ---cut---
178
+```typescript
179
const tool = await composio.tools.createCustomTool({
180
slug: 'GITHUB_DIRECT_API',
181
name: 'Direct GitHub API Call',
@@ -257,12 +242,7 @@ def get_issue_info(
242
```
243
</Tab>
244
<Tab value="TypeScript">
260
-```typescript twoslash
261
-// @noErrors
262
-import { Composio } from '@composio/core';
263
-import { z } from 'zod';
264
-const composio = new Composio({ apiKey: 'your_api_key' });
265
-// ---cut---
245
+```typescript
246
const tool = await composio.tools.createCustomTool({
247
slug: 'GITHUB_SEARCH_REPOSITORIES',
248
name: 'Search GitHub Repositories',
@@ -324,10 +304,7 @@ response = composio.tools.execute(
304
```
305
</Tab>
306
<Tab value="TypeScript">
327
-```typescript twoslash
328
-import { Composio } from '@composio/core';
329
-const composio = new Composio({ apiKey: 'your_api_key' });
330
-// ---cut---
307
+```typescript
308
const result = await composio.tools.execute('TOOL_SLUG', {
309
arguments: {
310
// Tool input parameters
fumadocs/content/docs/executing-tools.mdx
+8
-23
@@ -55,8 +55,7 @@ print(result)
55
```
56
</Tab>
57
<Tab value="TypeScript">
58
-```typescript twoslash
59
-// @noErrors
58
+```typescript
59
import { Composio } from '@composio/core';
60
import { AnthropicProvider } from '@composio/anthropic';
61
import { Anthropic } from '@anthropic-ai/sdk';
@@ -141,8 +140,7 @@ asyncio.run(main())
140
```
141
</Tab>
142
<Tab value="TypeScript">
144
-```typescript twoslash
145
-// @noErrors
143
+```typescript
144
import { Composio } from '@composio/core';
145
import { generateText } from 'ai';
146
import { anthropic } from '@ai-sdk/anthropic';
@@ -214,7 +212,7 @@ print(result)
212
```
213
</Tab>
214
<Tab value="TypeScript">
217
-```typescript twoslash
215
+```typescript
216
import { Composio } from "@composio/core";
217
218
const userId = "user-k7334";
@@ -270,10 +268,7 @@ print(response)
268
```
269
</Tab>
270
<Tab value="TypeScript">
273
-```typescript twoslash
274
-import { Composio } from '@composio/core';
275
-const composio = new Composio({ apiKey: 'your_api_key' });
276
-// ---cut---
271
+```typescript
272
// Send a proxy request to the endpoint
273
const { data } = await composio.tools.proxyExecute({
274
endpoint:'/repos/composiohq/composio/issues/1',
@@ -319,11 +314,7 @@ print(result) # Print Google Drive file details
314
```
315
</Tab>
316
<Tab value="TypeScript">
322
-```typescript twoslash
323
-import { Composio } from '@composio/core';
324
-import path from 'path';
325
-const composio = new Composio({ apiKey: 'your_api_key' });
326
-// ---cut---
317
+```typescript
318
// Upload a local file to Google Drive
319
const result = await composio.tools.execute('GOOGLEDRIVE_UPLOAD_FILE', {
320
userId: 'user-4235***',
@@ -360,10 +351,7 @@ print(result)
351
```
352
</Tab>
353
<Tab value="TypeScript">
363
-```typescript twoslash
364
-import { Composio } from '@composio/core';
365
-const composio = new Composio({ apiKey: 'your_api_key' });
366
-// ---cut---
354
+```typescript
355
// Download a file from Google Drive
356
const result = await composio.tools.execute('GOOGLEDRIVE_DOWNLOAD_FILE', {
357
userId: 'user-1235***',
@@ -382,10 +370,7 @@ console.log(result);
370
371
You can disable automatic file handling when initializing the TypeScript SDK. When disabled, handle file uploads and downloads manually using `files.upload` and `files.download`:
372
385
-```typescript twoslash
386
-import { Composio } from '@composio/core';
387
-import path from 'path';
388
-// ---cut---
373
+```typescript
374
const composio = new Composio({
375
apiKey: process.env.COMPOSIO_API_KEY,
376
autoUploadDownloadFiles: false
@@ -393,7 +378,7 @@ const composio = new Composio({
378
379
// Now you need to handle files manually using composio.files API
380
const fileData = await composio.files.upload({
396
- file: path.join(__dirname, 'document.pdf'),
381
+ filePath: path.join(__dirname, 'document.pdf'),
382
toolSlug: 'GOOGLEDRIVE_UPLOAD_FILE',
383
toolkitSlug: 'googledrive'
384
});
fumadocs/content/docs/fetching-tools.mdx
+6
-29
@@ -18,11 +18,7 @@ tools = composio.tools.get(
18
```
19
</Tab>
20
<Tab value="TypeScript">
21
-```typescript twoslash
22
-import { Composio } from '@composio/core';
23
-const composio = new Composio({ apiKey: 'your_api_key' });
24
-const userId = 'user_123';
25
-// ---cut---
21
+```typescript
22
const tools = await composio.tools.get(userId, {
23
toolkits: ["GITHUB"]
24
});
@@ -43,10 +39,7 @@ tool = composio.tools.get_raw_composio_tool_by_slug("GMAIL_SEND_EMAIL")
39
```
40
</Tab>
41
<Tab value="TypeScript">
46
-```typescript twoslash
47
-import { Composio } from '@composio/core';
48
-const composio = new Composio({ apiKey: 'your_api_key' });
49
-// ---cut---
42
+```typescript
43
const tool = await composio.tools.getRawComposioToolBySlug("GMAIL_SEND_EMAIL");
44
```
45
</Tab>
@@ -82,11 +75,7 @@ raw_tools = composio.tools.get_raw_composio_tools(
75
```
76
</Tab>
77
<Tab value="TypeScript">
85
-```typescript twoslash
86
-import { Composio } from '@composio/core';
87
-const composio = new Composio({ apiKey: 'your_api_key' });
88
-const userId = 'user_123';
89
-// ---cut---
78
+```typescript
79
// Fetch with limit for a specific user
80
const limitedTools = await composio.tools.get(userId, {
81
toolkits: ["GITHUB"],
@@ -122,11 +111,7 @@ raw_tools = composio.tools.get_raw_composio_tools(
111
```
112
</Tab>
113
<Tab value="TypeScript">
125
-```typescript twoslash
126
-import { Composio } from '@composio/core';
127
-const composio = new Composio({ apiKey: 'your_api_key' });
128
-const userId = 'user_123';
129
-// ---cut---
114
+```typescript
115
// Fetch specific tools by name
116
const specificTools = await composio.tools.get(userId, {
117
tools: ["GITHUB_LIST_STARGAZERS", "GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USER"]
@@ -156,11 +141,7 @@ tools = composio.tools.get(
141
```
142
</Tab>
143
<Tab value="TypeScript">
159
-```typescript twoslash
160
-import { Composio } from '@composio/core';
161
-const composio = new Composio({ apiKey: 'your_api_key' });
162
-const userId = 'user_123';
163
-// ---cut---
144
+```typescript
145
// Filter by OAuth scopes (single toolkit only)
146
const scopedTools = await composio.tools.get(userId, {
147
toolkits: ["GITHUB"],
@@ -203,11 +184,7 @@ raw_tools = composio.tools.get_raw_composio_tools(
184
```
185
</Tab>
186
<Tab value="TypeScript">
206
-```typescript twoslash
207
-import { Composio } from '@composio/core';
208
-const composio = new Composio({ apiKey: 'your_api_key' });
209
-const userId = 'user_123';
210
-// ---cut---
187
+```typescript
188
// Search tools semantically
189
const searchResults = await composio.tools.get(userId, {
190
search: "create google calendar event"
fumadocs/content/docs/quickstart.mdx
+2
-4
@@ -108,8 +108,7 @@ Composio supports multiple LLM providers. Here's how to use Composio with some o
108
npm i @composio/core @composio/anthropic @anthropic-ai/sdk
109
```
110
111
- ```typescript twoslash
112
- // @noErrors
111
+ ```typescript
112
import { Composio } from "@composio/core";
113
import { AnthropicProvider } from "@composio/anthropic";
114
import Anthropic from "@anthropic-ai/sdk";
@@ -175,8 +174,7 @@ Composio supports multiple LLM providers. Here's how to use Composio with some o
174
npm i @composio/core @composio/vercel ai @ai-sdk/openai
175
```
176
178
- ```typescript twoslash
179
- // @noErrors
177
+ ```typescript
178
import { Composio } from "@composio/core";
179
import { VercelProvider } from "@composio/vercel";
180
import { generateText } from "ai";