Beta to Stable Migration

Upgrade composio package

Upgrade to the latest stable version:

pip install --upgrade composio

npm install @composio/core@latest

Update session creation

# Beta (before)
session = composio.experimental.tool_router.create_session(
    user_id="user@example.com"
)

# Stable (after)
session = composio.create(
    user_id="user@example.com"
)

// Beta (before)
const session = await composio.experimental.toolRouter.createSession('user_123');

// Stable (after)
const session = await composio.create('user_123');

Moving users (optional)

If you have existing users on tool router and you don't want them to authenticate again:

• Tool Router will auto-detect auth configs and connected accounts it created (from the beta version).
• If you have custom auth configs (not created by Tool Router):
  • Search for the Auth config for that connected account. See 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.

session = composio.create(
    user_id="user_123",
    auth_configs={
        "github": "ac_your_github_config",
        "slack": "ac_your_slack_config"
    }
)

const session = await composio.create('user_123',
    {
        authConfigs: {
            github: "ac_your_github_config",
            slack: "ac_your_slack_config",
        },
    }
);

Explore new capabilities

Check out these new features available in the stable version:

• Native tools: Use Tool Router with any AI framework
• Better session and auth config
• Multi-account support: Manage multiple accounts per user seamlessly
• Manual authentication: Control when and how users authenticate
• Custom auth: Support for toolkits that don't have composio managed auth
• White labeling: Customize authentication screens with your branding