Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: revamp tool router beta migration guide
Improve title, add context on who the guide is for, remove link dump, and add CTA linking to quickstart and configuring sessions. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sushmithamallesh committed
Feb 19, 2026 at 18:17 UTC
5c5c14a88c421b0f0dc3e3440104ccb24b1cfdec
2 files changed
+14
-18
docs/content/docs/migration-guide/index.mdx
+2
-2
@@ -18,8 +18,8 @@ description: Guides for migrating to newer versions of Composio
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.
21
+ <Accordion title="Migrating from Experimental Tool Router">
22
+ Migrate from `composio.experimental.tool_router` to the stable sessions API.
23
24
[View Tool Router migration guide →](/docs/migration-guide/tool-router-beta)
25
</Accordion>
docs/content/docs/migration-guide/tool-router-beta.mdx
+12
-16
@@ -1,10 +1,12 @@
1
---
2
-title: Beta to Stable Migration
3
-description: Migrate from Tool Router beta to the stable version
4
-keywords: [upgrade, migrate, experimental, beta]
2
+title: Migrating from Experimental Tool Router
3
+description: Migrate from the experimental tool router to Composio sessions
4
+keywords: [upgrade, migrate, experimental, beta, tool router]
5
---
6
7
-The stable version includes improved session management, multiple configuring options, and enhanced authentication capabilities.
7
+This guide is for users who adopted the **experimental tool router** (`composio.experimental.tool_router`) during its beta period. The tool router has now graduated to a stable, first-class feature called **sessions** — with a simpler API, better auth handling, and full framework support.
8
+
9
+If you never used `composio.experimental.tool_router`, you can skip this guide and head straight to the [Quickstart](/docs/quickstart).
10
11
## The basics
12
@@ -97,17 +99,11 @@ const session = await composio.create('user_123',
99
</Tab>
100
</Tabs>
101
</Step>
102
+</Steps>
103
101
-<Step>
102
-<StepTitle>Explore new capabilities</StepTitle>
103
-
104
-Check out these new features available in the stable version:
104
+## Get started
105
106
-- **[Native tools](/docs/providers/openai-agents)**: Use Tool Router with any AI framework
107
-- **Better [session](/docs/users-and-sessions) and [auth](/docs/authentication) config**
108
-- **[Multi-account support](/docs/managing-multiple-connected-accounts)**: Manage multiple accounts per user seamlessly
109
-- **[Manual authentication](/docs/authenticating-users/manually-authenticating)**: Control when and how users authenticate
110
-- **[Custom auth](/docs/using-custom-auth-configuration)**: Support for toolkits that don't have composio managed auth
111
-- **[White labeling](/docs/white-labeling-authentication)**: Customize authentication screens with your branding
112
-</Step>
113
-</Steps>
106
+<Cards>
107
+ <Card icon={<Rocket />} title="Quickstart" href="/docs/quickstart" description="Build your first agent with the stable sessions API" />
108
+ <Card icon={<Wrench />} title="Configuring Sessions" href="/docs/configuring-sessions" description="Restrict toolkits, set auth configs, and select connected accounts" />
109
+</Cards>