Skip to main content
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 start with Configuring Sessions.

The basics

1

Upgrade composio package

Upgrade to the latest stable version:
2

Update session creation

Beta (before):
Stable (after):
3

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.

Next

Configuring Sessions