Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Move Tool Router migration guide to docs
- Create tool-router-beta.mdx in docs/migration-guide/ - Add to migration guide index and meta - Remove from tool-router meta.json - Add redirect from /tool-router/migration-guide
Sushmithamallesh committed
Jan 22, 2026 at 01:21 UTC
0cf789601ac1a8459d3044a0cd8751e0498ed9b2
5 files changed
+53
-4
docs/content/docs/migration-guide/index.mdx
+6
@@ -17,4 +17,10 @@ description: Guides for migrating to newer versions of Composio
17
18
[View versioning migration guide →](/docs/migration-guide/toolkit-versioning)
19
</Accordion>
20
+
21
+ <Accordion title="Tool Router Beta to Stable">
22
+ Migrate from the Tool Router Beta to the stable release.
23
+
24
+ [View Tool Router migration guide →](/docs/migration-guide/tool-router-beta)
25
+ </Accordion>
26
</Accordions>
docs/content/docs/migration-guide/meta.json
+2
-1
@@ -3,6 +3,7 @@
3
"pages": [
4
"index",
5
"new-sdk",
6
- "toolkit-versioning"
6
+ "toolkit-versioning",
7
+ "tool-router-beta"
8
]
9
}
docs/content/docs/migration-guide/tool-router-beta.mdx
new
+39
@@ -0,0 +1,39 @@
1
+---
2
+title: Tool Router Beta to Stable Migration
3
+description: Migrate from Tool Router Beta to the stable release
4
+---
5
+
6
+This guide helps you migrate from the Tool Router Beta to the stable release.
7
+
8
+## Breaking changes
9
+
10
+### Session creation
11
+
12
+The `create` method now accepts a user ID directly instead of an options object:
13
+
14
+```typescript
15
+// Before (Beta)
16
+const session = await composio.create({ userId: 'user_123' });
17
+
18
+// After (Stable)
19
+const session = await composio.create('user_123');
20
+```
21
+
22
+### Tool fetching
23
+
24
+Tools are now fetched from the session object:
25
+
26
+```typescript
27
+// Before (Beta)
28
+const tools = await composio.tools.get('user_123', { toolkits: ['GITHUB'] });
29
+
30
+// After (Stable)
31
+const session = await composio.create('user_123');
32
+const tools = await session.tools();
33
+```
34
+
35
+## New features
36
+
37
+- Simplified session-based API
38
+- Built-in provider support for popular AI frameworks
39
+- Improved type safety and error handling
docs/content/tool-router/meta.json
+1
-3
@@ -11,8 +11,6 @@
11
"white-labeling-authentication",
12
"using-custom-auth-configs",
13
"using-with-mcp-clients",
14
- "using-as-a-native-tool",
15
- "---Resources---",
16
- "migration-guide"
14
+ "using-as-a-native-tool"
15
]
16
}
docs/next.config.mjs
+5
@@ -41,6 +41,11 @@ const config = {
41
destination: '/docs/users-and-sessions',
42
permanent: true,
43
},
44
+ {
45
+ source: '/tool-router/migration-guide',
46
+ destination: '/docs/migration-guide/tool-router-beta',
47
+ permanent: true,
48
+ },
49
{
50
source: '/tool-router/authentication',
51
destination: '/docs/authentication',