Skip to content

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

Sushmithamallesh5c5c14a88c42
diff --git a/docs/content/docs/migration-guide/index.mdx b/docs/content/docs/migration-guide/index.mdx
index caad30d4a..73f973e58 100644
--- a/docs/content/docs/migration-guide/index.mdx
+++ b/docs/content/docs/migration-guide/index.mdx
@@ -18,8 +18,8 @@ description: Guides for migrating to newer versions of Composio
[View versioning migration guide →](/docs/migration-guide/toolkit-versioning)
</Accordion>
- <Accordion title="Tool Router Beta to Stable">
- Migrate from the Tool Router Beta to the stable release.
+ <Accordion title="Migrating from Experimental Tool Router">
+ Migrate from `composio.experimental.tool_router` to the stable sessions API.
[View Tool Router migration guide →](/docs/migration-guide/tool-router-beta)
</Accordion>
diff --git a/docs/content/docs/migration-guide/tool-router-beta.mdx b/docs/content/docs/migration-guide/tool-router-beta.mdx
index a7b8addbf..a4e5cf9ce 100644
--- a/docs/content/docs/migration-guide/tool-router-beta.mdx
+++ b/docs/content/docs/migration-guide/tool-router-beta.mdx
@@ -1,10 +1,12 @@
---
-title: Beta to Stable Migration
-description: Migrate from Tool Router beta to the stable version
-keywords: [upgrade, migrate, experimental, beta]
+title: Migrating from Experimental Tool Router
+description: Migrate from the experimental tool router to Composio sessions
+keywords: [upgrade, migrate, experimental, beta, tool router]
---
-The stable version includes improved session management, multiple configuring options, and enhanced authentication capabilities.
+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.
+
+If you never used `composio.experimental.tool_router`, you can skip this guide and head straight to the [Quickstart](/docs/quickstart).
## The basics
@@ -97,17 +99,11 @@ const session = await composio.create('user_123',
</Tab>
</Tabs>
</Step>
+</Steps>
-<Step>
-<StepTitle>Explore new capabilities</StepTitle>
-
-Check out these new features available in the stable version:
+## Get started
-- **[Native tools](/docs/providers/openai-agents)**: Use Tool Router with any AI framework
-- **Better [session](/docs/users-and-sessions) and [auth](/docs/authentication) config**
-- **[Multi-account support](/docs/managing-multiple-connected-accounts)**: Manage multiple accounts per user seamlessly
-- **[Manual authentication](/docs/authenticating-users/manually-authenticating)**: Control when and how users authenticate
-- **[Custom auth](/docs/using-custom-auth-configuration)**: Support for toolkits that don't have composio managed auth
-- **[White labeling](/docs/white-labeling-authentication)**: Customize authentication screens with your branding
-</Step>
-</Steps>
+<Cards>
+ <Card icon={<Rocket />} title="Quickstart" href="/docs/quickstart" description="Build your first agent with the stable sessions API" />
+ <Card icon={<Wrench />} title="Configuring Sessions" href="/docs/configuring-sessions" description="Restrict toolkits, set auth configs, and select connected accounts" />
+</Cards>