@devries-cameron20 / composio Mirror · read-only / commits / 21bff478a
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 22:15 UTC

docs: address review — drop errors.mdx Error 600 section + custom-auth-configs callout

Per PR review feedback: - `reference/errors.mdx`: revert the entire `Specific error codes` / `Error 600` addition. The numeric code section was speculative scope for this PR. - `auth-configuration/custom-auth-configs.mdx`: drop the clarification callout. The page is already scoped to custom auth configs, so the "this is safe for custom auth configs" note is redundant for any reader who landed here. - `auth-configuration/migrating-initiate-to-link.mdx`: remove the `Related` bullet pointing at `/reference/errors#error-600` so we don't leave a broken link behind. The migration guide and the canonical doc callouts on authenticating-tools.mdx and connected-accounts.mdx remain unchanged. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Composio committed May 4, 2026 at 10:46 UTC 21bff478a61ddf25cb166e105032c27eb893bc51
3 files changed -37
docs/content/docs/auth-configuration/custom-auth-configs.mdx
-4
@@ -98,10 +98,6 @@ Once you have the OAuth credentials, you can add them to the auth config in the
98
99 This auth config is now ready to be used in your application!
100
101 -<Callout type="info">
102 -The `initiate()` example below is **safe for custom auth configs**. The `initiate()` retirement announced in the [2026-04-24 changelog](/docs/changelog/2026/04/24) only affects **Composio-managed** auth configs on OAuth1 / OAuth2 / DCR_OAUTH — not the custom OAuth app you just configured here. Custom auth configs continue to work on `initiate()` indefinitely.
103 -</Callout>
104 -
101 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
102 <Tab value="Python">
103 ```python
docs/content/docs/auth-configuration/migrating-initiate-to-link.mdx
-1
@@ -209,5 +209,4 @@ This is meant as a safety net during migration — the long-term answer is to sw
209
210 - [Connected accounts → Multiple accounts](/docs/auth-configuration/connected-accounts#multiple-accounts) — using `link()` for multi-account flows
211 - [Authenticating tools → Hosted Authentication](/docs/tools-direct/authenticating-tools#hosted-authentication-connect-link) — the canonical `link()` flow
212 -- [API errors → Error 600](/reference/errors#error-600) — the 400 response shape
212 - [Changelog: Link Auth Migration](/docs/changelog/2026/04/24) — the announcement
docs/content/reference/errors.mdx
-32
@@ -98,38 +98,6 @@ Errors related to trigger subscriptions.
98 See [Triggers Troubleshooting](/docs/troubleshooting/triggers) for more help.
99 </Callout>
100
101 -## Specific error codes
102 -
103 -When the API response includes a numeric `code` in the error object, you can look it up here for a focused explanation and the canonical fix. The `suggested_fix` field on each error response also points back to this section.
104 -
105 -### Error 600
106 -
107 -`ConnectedAccount_BadRequest`. Returned by `POST /api/v3/connected_accounts` (HTTP 400) when the request is for a **Composio-managed auth config on a redirectable OAuth scheme** (OAuth1, OAuth2, DCR_OAUTH). This combination is being retired on the legacy create endpoint — **2026-05-08** for new organizations and **2026-07-03** for all remaining organizations.
108 -
109 -**Example response:**
110 -
111 -```json
112 -{
113 - "error": {
114 - "message": "Creating connections on this endpoint for Composio-managed OAuth auth configs is no longer supported. Use POST /api/v3/connected_accounts/link instead.",
115 - "code": 600,
116 - "slug": "ConnectedAccount_BadRequest",
117 - "status": 400,
118 - "request_id": "...",
119 - "suggested_fix": "Call POST /api/v3/connected_accounts/link with the same auth_config_id and user_id to get a redirect URL for the end user."
120 - }
121 -}
122 -```
123 -
124 -**Fix.** Switch the call to `POST /api/v3/connected_accounts/link`, or use the SDK helper:
125 -
126 -- TypeScript: `composio.connectedAccounts.link(userId, authConfigId, options?)` (replaces `composio.connectedAccounts.initiate(...)`).
127 -- Python: `composio.connected_accounts.link(user_id, auth_config_id, **options)` (replaces `composio.connected_accounts.initiate(...)`).
128 -
129 -The return shape is the same — both methods give you a `redirect_url` (or `redirectUrl`) and a `wait_for_connection()` / `waitForConnection()` helper. See the [migration guide](/docs/auth-configuration/migrating-initiate-to-link) and the [changelog entry](/docs/changelog/2026/04/24).
130 -
131 -**Not affected by error 600:** custom auth configs (your own OAuth app) and non-OAuth schemes (API key, bearer token, basic auth) continue to work on `POST /api/v3/connected_accounts` indefinitely.
132 -
101 ## Rate limiting
102
103 When you hit rate limits, you'll receive a `429` status code. See [Rate Limits](/reference/rate-limits) for details on limits by plan and best practices for handling rate limit errors.