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
- Bump @composio/core to ^0.6.9 for multiAccount type support - Add // ---cut--- preamble to changelog TypeScript code blocks - Add // @errors: 2353 for session.authorize alias (pending SDK type fix in #3167) - Add missing session variable to Python code blocks - Add Python snake_case names to config options table - Fix changelog intro sentence fragment Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: Zen Agent <zen@composio.dev>
abir committed
Apr 10, 2026 at 08:19 UTC
cf8a9a0305a10e4657ecc96c8094f7f7a7d674f3
3 files changed
+19
-4
docs/bun.lock
+1
@@ -1,5 +1,6 @@
1
{
2
"lockfileVersion": 1,
3
+ "configVersion": 0,
4
"workspaces": {
5
"": {
6
"name": "fumadocs",
docs/content/changelog/04-09-26-multi-account-aliases.mdx
+9
-1
@@ -4,13 +4,16 @@ description: "Enable multiple connected accounts per toolkit and label them with
4
date: "2026-04-09"
5
---
6
7
-Two features for managing multiple accounts per toolkit.
7
+This release adds two features for managing multiple accounts per toolkit.
8
9
## Multi-account mode
10
11
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.
12
13
```typescript
14
+import { Composio } from '@composio/core';
15
+const composio = new Composio({ apiKey: 'your_api_key' });
16
+// ---cut---
17
const session = await composio.create('user_123', {
18
toolkits: ['gmail'],
19
multiAccount: {
@@ -27,6 +30,11 @@ By default, multi-account mode is disabled and each session uses one account per
30
Connected accounts can now have human-readable aliases (e.g., `"work-gmail"`, `"personal-github"`). Aliases can be set during connection or updated after.
31
32
```typescript
33
+// @errors: 2353
34
+import { Composio } from '@composio/core';
35
+const composio = new Composio({ apiKey: 'your_api_key' });
36
+const session = await composio.create('user_123');
37
+// ---cut---
38
// Set alias during connection
39
await session.authorize('gmail', { alias: 'work-gmail' });
40
docs/content/docs/managing-multiple-connected-accounts.mdx
+9
-3
@@ -41,11 +41,11 @@ const session = await composio.create("user_123", {
41
42
### Configuration options
43
44
-| Option | Type | Default | Description |
44
+| Option (TS / Python) | Type | Default | Description |
45
|--------|------|---------|-------------|
46
| `enable` | `boolean` | `false` | Enable multi-account mode for this session |
47
-| `maxAccountsPerToolkit` | `number` | `5` | Maximum connected accounts per toolkit (2-10) |
48
-| `requireExplicitSelection` | `boolean` | `false` | When true, the agent must specify which account to use instead of defaulting to the most recent |
47
+| `maxAccountsPerToolkit` / `max_accounts_per_toolkit` | `number` | `5` | Maximum connected accounts per toolkit (2-10) |
48
+| `requireExplicitSelection` / `require_explicit_selection` | `boolean` | `false` | When true, the agent must specify which account to use instead of defaulting to the most recent |
49
50
When multi-account mode is disabled (the default), each session uses the most recently connected account for each toolkit.
51
@@ -56,6 +56,8 @@ Call `session.authorize()` multiple times for the same toolkit. Each call create
56
<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
57
<Tab value="Python">
58
```python
59
+session = composio.create(user_id="user_123", multi_account={"enable": True})
60
+
61
# Connect work account
62
work_auth = session.authorize("gmail", alias="work-gmail")
63
print(f"Connect work Gmail: {work_auth.redirect_url}")
@@ -69,6 +71,7 @@ personal_connection = personal_auth.wait_for_connection()
71
</Tab>
72
<Tab value="TypeScript">
73
```typescript
74
+// @errors: 2353
75
import { Composio } from '@composio/core';
76
const composio = new Composio({ apiKey: 'your_api_key' });
77
const session = await composio.create("user_123");
@@ -100,6 +103,8 @@ Pass `alias` to `session.authorize()`, `connectedAccounts.initiate()`, or `conne
103
<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
104
<Tab value="Python">
105
```python
106
+session = composio.create(user_id="user_123")
107
+
108
# Via session.authorize()
109
connection_request = session.authorize("gmail", alias="work-gmail")
110
@@ -120,6 +125,7 @@ connection_request = composio.connected_accounts.link(
125
</Tab>
126
<Tab value="TypeScript">
127
```typescript
128
+// @errors: 2353
129
import { Composio } from '@composio/core';
130
const composio = new Composio({ apiKey: 'your_api_key' });
131
const session = await composio.create("user_123");