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.

fix: address CI errors and PR review comments

abircf8a9a0305a1
diff --git a/docs/bun.lock b/docs/bun.lock
index be911352e..77c478661 100644
--- a/docs/bun.lock
+++ b/docs/bun.lock
@@ -1,5 +1,6 @@
{
"lockfileVersion": 1,
+ "configVersion": 0,
"workspaces": {
"": {
"name": "fumadocs",
diff --git a/docs/content/changelog/04-09-26-multi-account-aliases.mdx b/docs/content/changelog/04-09-26-multi-account-aliases.mdx
index 06d5748ec..9706a3770 100644
--- a/docs/content/changelog/04-09-26-multi-account-aliases.mdx
+++ b/docs/content/changelog/04-09-26-multi-account-aliases.mdx
@@ -4,13 +4,16 @@ description: "Enable multiple connected accounts per toolkit and label them with
date: "2026-04-09"
---
-Two features for managing multiple accounts per toolkit.
+This release adds two features for managing multiple accounts per toolkit.
## Multi-account mode
Sessions now support a `multiAccount` config that lets users connect and use multiple accounts for the same toolkit (e.g., work and personal Gmail) within a single session.
```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
const session = await composio.create('user_123', {
toolkits: ['gmail'],
multiAccount: {
@@ -27,6 +30,11 @@ By default, multi-account mode is disabled and each session uses one account per
Connected accounts can now have human-readable aliases (e.g., `"work-gmail"`, `"personal-github"`). Aliases can be set during connection or updated after.
```typescript
+// @errors: 2353
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+const session = await composio.create('user_123');
+// ---cut---
// Set alias during connection
await session.authorize('gmail', { alias: 'work-gmail' });
diff --git a/docs/content/docs/managing-multiple-connected-accounts.mdx b/docs/content/docs/managing-multiple-connected-accounts.mdx
index b986a3ca9..92f7dcf5e 100644
--- a/docs/content/docs/managing-multiple-connected-accounts.mdx
+++ b/docs/content/docs/managing-multiple-connected-accounts.mdx
@@ -41,11 +41,11 @@ const session = await composio.create("user_123", {
### Configuration options
-| Option | Type | Default | Description |
+| Option (TS / Python) | Type | Default | Description |
|--------|------|---------|-------------|
| `enable` | `boolean` | `false` | Enable multi-account mode for this session |
-| `maxAccountsPerToolkit` | `number` | `5` | Maximum connected accounts per toolkit (2-10) |
-| `requireExplicitSelection` | `boolean` | `false` | When true, the agent must specify which account to use instead of defaulting to the most recent |
+| `maxAccountsPerToolkit` / `max_accounts_per_toolkit` | `number` | `5` | Maximum connected accounts per toolkit (2-10) |
+| `requireExplicitSelection` / `require_explicit_selection` | `boolean` | `false` | When true, the agent must specify which account to use instead of defaulting to the most recent |
When multi-account mode is disabled (the default), each session uses the most recently connected account for each toolkit.
@@ -56,6 +56,8 @@ Call `session.authorize()` multiple times for the same toolkit. Each call create
<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
<Tab value="Python">
```python
+session = composio.create(user_id="user_123", multi_account={"enable": True})
+
# Connect work account
work_auth = session.authorize("gmail", alias="work-gmail")
print(f"Connect work Gmail: {work_auth.redirect_url}")
@@ -69,6 +71,7 @@ personal_connection = personal_auth.wait_for_connection()
</Tab>
<Tab value="TypeScript">
```typescript
+// @errors: 2353
import { Composio } from '@composio/core';
const composio = new Composio({ apiKey: 'your_api_key' });
const session = await composio.create("user_123");
@@ -100,6 +103,8 @@ Pass `alias` to `session.authorize()`, `connectedAccounts.initiate()`, or `conne
<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
<Tab value="Python">
```python
+session = composio.create(user_id="user_123")
+
# Via session.authorize()
connection_request = session.authorize("gmail", alias="work-gmail")
@@ -120,6 +125,7 @@ connection_request = composio.connected_accounts.link(
</Tab>
<Tab value="TypeScript">
```typescript
+// @errors: 2353
import { Composio } from '@composio/core';
const composio = new Composio({ apiKey: 'your_api_key' });
const session = await composio.create("user_123");