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)
## Summary Automated documentation updates triggered by new changelog entries merged to next. Generated by Codex via GitHub Actions. Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
sdkrelease[bot] committed
Aug 18, 2026 at 23:56 UTC
9dd762c9bdcda0202e32d219082057cbbdeb5bad
3 files changed
+4
-2
docs/content/docs/auth-configuration/connected-accounts.mdx
+1
-1
@@ -245,7 +245,7 @@ If your use case requires calling a provider API directly, use [Proxy execute](/
245
Users can connect multiple accounts for the same toolkit (e.g., personal and work Gmail).
246
247
<Callout type="warn">
248
-**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).
248
+**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).
249
250
The `initiate()` examples remain accurate for **custom auth configs** (your own OAuth app) and **non-OAuth schemes** (API key, bearer, basic) — those are unaffected.
251
</Callout>
docs/content/docs/authentication/managing-multiple-connected-accounts.mdx
+1
-1
@@ -125,7 +125,7 @@ const connectionRequest = await session.authorize("gmail", { alias: "work-gmail"
125
</Tab>
126
</Tabs>
127
128
-The direct-execution methods `connectedAccounts.initiate()` and `connectedAccounts.link()` accept the same `alias` parameter.
128
+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.
129
130
### Updating or clearing an alias
131
docs/content/docs/tools-direct/authenticating-tools.mdx
+2
@@ -155,6 +155,8 @@ console.log(`Visit: ${redirectUrl} to authenticate your account`);
155
</Tab>
156
</Tabs>
157
158
+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.
159
+
160
#### Customizing Connect Link
161
162
You can customize the Connect Link with your logo and app title, or fully white-label OAuth consent screens with your own developer apps.