> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# May 8, 2026

> Latest updates and announcements

## Session reuse, update, and connected accounts as arrays

### 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()`:

> [tab] Python
>
> ```python theme={null}
> 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] TypeScript
>
> ```typescript theme={null}
> import { Composio } from '@composio/core';
> const composio = new Composio({ apiKey: 'your_api_key' });
> // First request
> const session = await composio.create("user_123");
> const sessionId = session.sessionId;
>
> // Subsequent requests
> const session = await composio.use(sessionId);
> const tools = await session.tools();
> ```

Custom tools can also be attached when reusing a session. See [Reusing a session](https://composio-preview.mintlify.site/docs/how-composio-works.md#how-sessions-behave) and [Custom tools](https://composio-preview.mintlify.site/docs/extending-sessions/custom-tools-and-toolkits.md#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:

> [tab] Python
>
> ```python theme={null}
> session.update(
>     toolkits=["gmail", "slack"],
>     auth_configs={"gmail": "ac_new_config"},
> )
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> import { Composio } from '@composio/core';
> const composio = new Composio({ apiKey: 'your_api_key' });
> const session = await composio.create("user_123");
> await session.update({
>   toolkits: ["gmail", "slack"],
>   authConfigs: { gmail: "ac_new_config" },
> });
> ```

See [Updating a session](https://composio-preview.mintlify.site/docs/how-composio-works.md#how-sessions-behave).

### `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.

> [tab] Python
>
> ```python theme={null}
> session = composio.create(
>     user_id="user_123",
>     connected_accounts={
>         "gmail": ["ca_work_gmail"],
>     },
> )
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> import { Composio } from '@composio/core';
> const composio = new Composio({ apiKey: 'your_api_key' });
> const session = await composio.create("user_123", {
>   connectedAccounts: {
>     gmail: ["ca_work_gmail"],
>   },
> });
> ```

Only one account per toolkit is allowed when [multi-account mode](https://composio-preview.mintlify.site/docs/authentication/managing-multiple-connected-accounts.md) is disabled.

### SDK versions

| SDK | Minimum version |
| - | - |
| TypeScript `@composio/core` | `0.9.1` |
| Python `composio` | `0.13.0` |
