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.

docs: add changelog for session.use(), session.update(), connectedAccounts arrays

Abir Taheerf4d942d791a1
diff --git a/docs/content/changelog/05-08-26-session-use-update-connected-accounts.mdx b/docs/content/changelog/05-08-26-session-use-update-connected-accounts.mdx
new file mode 100644
index 000000000..ea324c608
--- /dev/null
+++ b/docs/content/changelog/05-08-26-session-use-update-connected-accounts.mdx
@@ -0,0 +1,110 @@
+---
+title: "Session reuse, update, and connected accounts as arrays"
+description: "composio.use() rehydrates sessions for multi-turn chat, session.update() patches config in-place, and connectedAccounts now accepts arrays."
+date: "2026-05-08"
+---
+
+### Session reuse with `composio.use()`
+
+`composio.create()` now returns a new session ID on every call, even for identical configs, for better isolation and observability. For multi-turn conversations, store the session ID and reuse it with `composio.use()`:
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+<Tab value="Python">
+```python
+from composio import Composio
+
+composio = Composio()
+
+# First request
+session = composio.create(user_id="user_123")
+session_id = session.session_id
+
+# Subsequent requests
+session = composio.use(session_id)
+tools = session.tools()
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+// First request
+const session = await composio.create("user_123");
+const sessionId = session.sessionId;
+
+// Subsequent requests
+const session2 = await composio.use(sessionId);
+const tools = await session2.tools();
+```
+</Tab>
+</Tabs>
+
+Custom tools can also be attached when reusing a session. See [Reusing a session](/docs/users-and-sessions#reusing-a-session) and [Custom tools](/docs/toolkits/custom-tools-and-toolkits#reusing-a-session-with-custom-tools).
+
+### Update session config with `session.update()`
+
+Modify a session's toolkits, auth configs, connected accounts, and other settings without creating a new session. Only the fields you pass are changed:
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+<Tab value="Python">
+```python
+session.update(
+ toolkits=["gmail", "slack"],
+ auth_configs={"gmail": "ac_new_config"},
+)
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+const session = await composio.create("user_123");
+// ---cut---
+await session.update({
+ toolkits: ["gmail", "slack"],
+ authConfigs: { gmail: "ac_new_config" },
+});
+```
+</Tab>
+</Tabs>
+
+See [Updating a session](/docs/users-and-sessions#updating-a-session).
+
+### `connectedAccounts` accepts arrays
+
+`connectedAccounts` (TypeScript) and `connected_accounts` (Python) now accept an array of connected account IDs per toolkit. A single string is still accepted for backwards compatibility and is automatically coerced to an array.
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+<Tab value="Python">
+```python
+session = composio.create(
+ user_id="user_123",
+ connected_accounts={
+ "gmail": ["ca_work_gmail"],
+ },
+)
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+const session = await composio.create("user_123", {
+ connectedAccounts: {
+ gmail: ["ca_work_gmail"],
+ },
+});
+```
+</Tab>
+</Tabs>
+
+Only one account per toolkit is allowed when [multi-account mode](/docs/managing-multiple-connected-accounts) is disabled.
+
+### SDK versions
+
+| SDK | Minimum version |
+| --- | --- |
+| TypeScript `@composio/core` | `0.10.0` |
+| Python `composio` | `0.13.0` |