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: Migration, dogfooding fixes (#2287)

Sushmitha Mallesh4076de404929
diff --git a/fern/docs.yml b/fern/docs.yml
index 6fe3a33f6..5647a702d 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -329,6 +329,16 @@ navigation:
- page: Using as a native tool
path: pages/dist/tool-router/using-as-a-native-tool.mdx
slug: using-as-a-native-tool
+ - section: Resources
+ icon: fa-light fa-book
+ skip-slug: true
+ contents:
+ - section: Migration Guides
+ slug: migration-guide
+ contents:
+ - page: Beta to Stable Migration
+ path: pages/dist/tool-router/migration/tool-router-beta-to-stable.mdx
+ slug: tool-router/migration-guide/beta-to-stable
- tab: providers
layout:
- section: Supported Providers
diff --git a/fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdx b/fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdx
new file mode 100644
index 000000000..8c7683133
--- /dev/null
+++ b/fern/pages/src/tool-router/migration/tool-router-beta-to-stable.mdx
@@ -0,0 +1,84 @@
+---
+title: Migration from the beta release version
+subtitle: Migrate from Tool Router beta to the stable version
+image: "https://og.composio.dev/api/og?title=Tool%20Router%20Migration"
+keywords: "tool router migration"
+hide-nav-links: false
+---
+The stable version includes improved session management, multiple configuring options, and enhanced authentication capabilities.
+
+## The basics
+
+<Steps>
+ <Step title="Upgrade composio package">
+ Upgrade to the latest stable version:
+ <CodeGroup>
+ ```bash title="Python" for="python"
+ pip install --upgrade composio
+ ```
+ ```bash title="TypeScript" for="typescript"
+ npm install @composio/core@latest
+ ```
+ </CodeGroup>
+ </Step>
+ <Step title="Update session creation">
+ <CodeGroup>
+ ```python title="Python" for="python"
+ # Beta (before)
+ session = composio.experimental.tool_router.create_session(
+ user_id="[email protected]"
+ )
+
+ # Stable (after)
+ session = composio.create(
+ user_id="[email protected]"
+ )
+ ```
+ ```typescript title="TypeScript" for="typescript"
+ // Beta (before)
+ const session = await composio.experimental.toolRouter.createSession('user_123');
+
+ // Stable (after)
+ const session = await composio.create('user_123');
+ ```
+ </CodeGroup>
+ </Step>
+ <Step title="Moving users (optional)">
+ If you have existing users on tool router and you don't want them to authenticate again:
+ - Search for the Auth config created by Tool Router for that connected account. See [Connected Accounts](/docs/connected-accounts) to fetch existing accounts programmatically.
+ - While creating a session configure to use this Auth config.
+ - You need to repeat this for each toolkit you want to enable for that session.
+ <CodeGroup>
+ ```python title="Python" for="python"
+ session = composio.create(
+ user_id="user_123",
+ auth_configs={
+ "github": "ac_your_github_config",
+ "slack": "ac_your_slack_config"
+ }
+ )
+ ```
+ ```typescript title="TypeScript" for="typescript"
+ const session = await composio.create('user_123',
+ {
+ authConfigs: {
+ github: "ac_your_github_config",
+ slack: "ac_your_slack_config",
+ },
+ }
+ );
+ ```
+ </CodeGroup>
+ </Step>
+ <Step title="Explore new capabilities">
+ Check out these new features available in the stable version:
+
+ - **[Native tools](/tool-router/using-as-a-native-tool)**: Use Tool Router with any AI framework
+ - **Better [session](/tool-router/users-and-sessions) and [auth](/tool-router/authentication) config**
+ - **[Multi-account support](/tool-router/managing-multiple-accounts)**: Manage multiple accounts per user seamlessly
+ - **[Manual authentication](/tool-router/manually-authenticating-users)**: Control when and how users authenticate
+ - **[Custom auth](/tool-router/using-custom-auth-configs)**: Support for toolkits that don't have composio managed auth
+ - **[White labeling](/tool-router/white-labeling-authentication)**: Customize authentication screens with your branding
+ </Step>
+</Steps>
+
diff --git a/fern/snippets/tool-router/python/mcp-openai.py b/fern/snippets/tool-router/python/mcp-openai.py
index e3596b612..c68472bd5 100644
--- a/fern/snippets/tool-router/python/mcp-openai.py
+++ b/fern/snippets/tool-router/python/mcp-openai.py
@@ -22,10 +22,7 @@ agent = Agent(
"You are a helpful assistant with access to external tools. "
"Always use the available tools to complete user requests instead of just explaining how to do them."
),
- model="gpt-5.1",
- model_settings=ModelSettings(
- reasoning={"effort": "low"},
- ),
+ model="gpt-5.2",
tools=[
HostedMCPTool(
tool_config={
diff --git a/fern/snippets/tool-router/python/quickstart-mcp-openai.py b/fern/snippets/tool-router/python/quickstart-mcp-openai.py
index 53435135e..d02a8b222 100644
--- a/fern/snippets/tool-router/python/quickstart-mcp-openai.py
+++ b/fern/snippets/tool-router/python/quickstart-mcp-openai.py
@@ -15,10 +15,7 @@ session = composio.create(user_id=user_id)
agent = Agent(
name="Personal Assistant",
instructions="You are a helpful personal assistant. Use Composio tools to take action.",
- model="gpt-5.1",
- model_settings= ModelSettings(
- reasoning={"effort": "low"},
- ),
+ model="gpt-5.2",
tools=[
HostedMCPTool(
tool_config={
diff --git a/fern/snippets/tool-router/typescript/mcp-openai.ts b/fern/snippets/tool-router/typescript/mcp-openai.ts
index f2082daea..8d1661849 100644
--- a/fern/snippets/tool-router/typescript/mcp-openai.ts
+++ b/fern/snippets/tool-router/typescript/mcp-openai.ts
@@ -15,8 +15,7 @@ const agent = new Agent({
instructions:
"You are a helpful assistant with access to external tools. " +
"Always use the available tools to complete user requests instead of just explaining how to do them.",
- model: "gpt-5.1",
- modelSettings: { reasoning: { effort: "low" } },
+ model: "gpt-5.2",
tools: [
hostedMcpTool({
serverLabel: "composio",
diff --git a/fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts b/fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts
index 2a2232118..8ac06aeb3 100644
--- a/fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts
+++ b/fern/snippets/tool-router/typescript/quickstart-mcp-openai.ts
@@ -12,10 +12,7 @@ const { mcp } = await composio.create(userId);
const agent = new Agent({
name: "Personal Assistant",
instructions: "You are a helpful personal assistant. Use Composio tools to take action.",
- model: "gpt-5.1",
- modelSettings: {
- reasoning: { effort: "low" },
- },
+ model: "gpt-5.2",
tools: [
hostedMcpTool({
serverLabel: "composio",