@devries-cameron20 / composio-1 / commits / 66d6ea499
Fork 0

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(auth): align allow_multiple section with link() parity (#3305)

#3305 (merged 2026-05-01) brought `allow_multiple` / `allowMultiple` to `link()` with the same default and same exception as `initiate()`, in TS v0.8.1 and Python v0.12.1 (2026-04-28). The migration is now a true pass-through — pass the flag unchanged. Update the comparison table and the dedicated section to reflect that, and link to the 04-28 changelog for the full release note. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Composio committed May 4, 2026 at 11:03 UTC 66d6ea4998c8c7ba227f9c6ac22eb17a0ae28f1c
1 file changed +3 -5
docs/content/docs/auth-configuration/migrating-initiate-to-link.mdx
+3 -5
@@ -82,14 +82,12 @@ const connectedAccount = await connectionRequest.waitForConnection();
82 | `callback_url` / `callbackUrl` | ✓ | ✓ |
83 | `alias` | ✓ | ✓ |
84 | Pre-filled connection state (`config`) | ✓ — for non-OAuth schemes | Not needed — OAuth uses redirect; non-OAuth users keep `initiate()` |
85 -| `allow_multiple` / `allowMultiple` | ✓ — guards against duplicates | Not applicable — `link()` always creates a new connection by design |
85 +| `allow_multiple` / `allowMultiple` | ✓ — guards against duplicates | ✓ — same default (`False`), same exception ([since 2026-04-28](/docs/changelog/2026/04/28)) |
86 | Affected by the 2026-05-08 / 2026-07-03 retirement (Composio-managed OAuth) | Yes | No |
87
88 -## `allow_multiple` is no longer needed
88 +## `allow_multiple` carries over unchanged
89
90 -`initiate()` accepts an `allow_multiple` / `allowMultiple` flag that defaults to `False` — calling it twice for the same `(user_id, auth_config_id)` raises an error unless you opt in. `link()` does not need this flag and does not accept it: every call creates a fresh connection request, which is the right default for the common case where a user connects more than one account for the same toolkit (for example, a personal and a work Google account).
91 -
92 -If your application logic should keep a user to at most one active connection per auth config, enforce that in your own UI rather than at the SDK layer — for example, list the user's active connections with `composio.connected_accounts.list({...})` before showing the Connect button and skip the call to `link()` when one already exists.
90 +`link()` accepts `allow_multiple` (Python) / `allowMultiple` (TypeScript) with the same default (`False`), same semantics, and same exception (`ComposioMultipleConnectedAccountsError`) as `initiate()`. Pass the flag through unchanged — see the [SDK link allow_multiple changelog](/docs/changelog/2026/04/28) for the full release note. Requires `@composio/core` v0.8.1+ (TypeScript) or `composio` v0.12.1+ (Python).
91
92 ## How to know which auth config is which
93