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:
- Python
- TypeScript
2
Update session creation
Beta (before):Stable (after):
- Python (previous)
- TypeScript (previous)
- Python
- TypeScript
- API
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.
- Python
- TypeScript
- API