Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
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.mdxnew file mode 100644index 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` |