Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 22:15 UTC
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