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: update documentation for new changelog entries (#4137)

sdkrelease[bot]9dd762c9bdcd
diff --git a/docs/content/docs/auth-configuration/connected-accounts.mdx b/docs/content/docs/auth-configuration/connected-accounts.mdx
index 3abd0242c..3bf1eeda4 100644
--- a/docs/content/docs/auth-configuration/connected-accounts.mdx
+++ b/docs/content/docs/auth-configuration/connected-accounts.mdx
@@ -245,7 +245,7 @@ If your use case requires calling a provider API directly, use [Proxy execute](/
Users can connect multiple accounts for the same toolkit (e.g., personal and work Gmail).
<Callout type="warn">
-**For Composio-managed OAuth, prefer `link()`.** The `initiate()` examples below will stop working for Composio-managed OAuth auth configs starting **2026-05-08** (new orgs) / **2026-07-03** (all orgs). `link()` provides hosted authentication, allows multiple accounts by default, and is unaffected by the rollout. See [Connect Link authentication](/docs/tools-direct/authenticating-tools#hosted-authentication-connect-link), the [migration guide](/docs/auth-configuration/migrating-initiate-to-link), or the [changelog entry](/docs/changelog/2026/04/24).
+**For Composio-managed OAuth, prefer `link()`.** The `initiate()` examples below will stop working for Composio-managed OAuth auth configs starting **2026-05-08** (new orgs) / **2026-07-03** (all orgs). `link()` provides hosted authentication and is unaffected by the rollout. Like `initiate()`, it refuses to create a second active connection for the same user and auth config unless you pass `allow_multiple=True` (Python) or `allowMultiple: true` (TypeScript). See [Connect Link authentication](/docs/tools-direct/authenticating-tools#hosted-authentication-connect-link), the [migration guide](/docs/auth-configuration/migrating-initiate-to-link), or the [changelog entry](/docs/changelog/2026/04/24).
The `initiate()` examples remain accurate for **custom auth configs** (your own OAuth app) and **non-OAuth schemes** (API key, bearer, basic) — those are unaffected.
</Callout>
diff --git a/docs/content/docs/authentication/managing-multiple-connected-accounts.mdx b/docs/content/docs/authentication/managing-multiple-connected-accounts.mdx
index bbd82afd4..24f384514 100644
--- a/docs/content/docs/authentication/managing-multiple-connected-accounts.mdx
+++ b/docs/content/docs/authentication/managing-multiple-connected-accounts.mdx
@@ -125,7 +125,7 @@ const connectionRequest = await session.authorize("gmail", { alias: "work-gmail"
</Tab>
</Tabs>
-The direct-execution methods `connectedAccounts.initiate()` and `connectedAccounts.link()` accept the same `alias` parameter.
+The direct-execution methods `connectedAccounts.initiate()` and `connectedAccounts.link()` accept the same `alias` parameter. To create another active connection for the same user and auth config, also pass `allow_multiple=True` in Python or `allowMultiple: true` in TypeScript.
### Updating or clearing an alias
diff --git a/docs/content/docs/tools-direct/authenticating-tools.mdx b/docs/content/docs/tools-direct/authenticating-tools.mdx
index 98d57e359..531448c31 100644
--- a/docs/content/docs/tools-direct/authenticating-tools.mdx
+++ b/docs/content/docs/tools-direct/authenticating-tools.mdx
@@ -155,6 +155,8 @@ console.log(`Visit: ${redirectUrl} to authenticate your account`);
</Tab>
</Tabs>
+By default, `link()` refuses to create a second active connection for the same user and auth config. If your user intentionally needs another account on that auth config, pass `allow_multiple=True` in Python or `allowMultiple: true` in TypeScript. Enable [multi-account mode](/docs/authentication/managing-multiple-connected-accounts) when a session needs to use those accounts together.
+
#### Customizing Connect Link
You can customize the Connect Link with your logo and app title, or fully white-label OAuth consent screens with your own developer apps.