@devries-cameron20 / composio-1 / commits / 3f25fe577
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: update generic v3 API references to v3.1

Update `/api/v3/` URLs to `/api/v3.1/` across generic feature docs so users are pointed at the latest default API version. Explicit v3 references (changelog, v3 reference section, v3-vs-v3.1 explainer, SDK migration guide) are intentionally left untouched. Files updated: - auth-configuration/custom-auth-configs.mdx - auth-configuration/programmatic-auth-configs.mdx - auth-configuration/white-labeling.mdx - custom-app-vs-managed-app.mdx - importing-existing-connections.mdx - troubleshooting/mcp.mdx - white-labeling-authentication.mdx - toolkits/faq/slack.md Kept as v3 (non-generic): - `/api/v3/s/...` shortlink URLs (Apollo returns literal v3 path) - `/v3/mcp/<UUID>` MCP server URL (App Router path, no v3.1 equivalent) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: rahul.lingala <rahul.lingala@composio.dev>

Zen Agent committed Apr 21, 2026 at 19:14 UTC 3f25fe577df33329de1b011de4a31cd684695c52
8 files changed +16 -16
docs/content/docs/auth-configuration/custom-auth-configs.mdx
+1 -1
@@ -78,7 +78,7 @@ Examples for Google and GitHub:
78 When creating your OAuth app, make sure to configure the Authorized Redirect URI to point to the Composio callback URL below:
79
80 ```
81 -https://backend.composio.dev/api/v3/toolkits/auth/callback
81 +https://backend.composio.dev/api/v3.1/toolkits/auth/callback
82 ```
83 </Step>
84
docs/content/docs/auth-configuration/programmatic-auth-configs.mdx
+3 -3
@@ -76,7 +76,7 @@ auth_config = composio.auth_configs.create(
76 "credentials": {
77 "client_id": "1234567890",
78 "client_secret": "1234567890",
79 - "oauth_redirect_uri": "https://backend.composio.dev/api/v3/toolkits/auth/callback",
79 + "oauth_redirect_uri": "https://backend.composio.dev/api/v3.1/toolkits/auth/callback",
80 },
81 },
82 )
@@ -94,7 +94,7 @@ const authConfig = await composio.authConfigs.create("NOTION", {
94 credentials: {
95 client_id: "1234567890",
96 client_secret: "1234567890",
97 - oauth_redirect_uri: "https://backend.composio.dev/api/v3/toolkits/auth/callback",
97 + oauth_redirect_uri: "https://backend.composio.dev/api/v3.1/toolkits/auth/callback",
98 },
99 authScheme: "OAUTH2",
100 });
@@ -119,7 +119,7 @@ The **authorized redirect URI** is the URI that captures the OAuth code that is
119 While doing so, you must ensure to set the **authorized redirect URI** in the OAuth configuration to:
120
121 ```
122 -https://backend.composio.dev/api/v3/toolkits/auth/callback
122 +https://backend.composio.dev/api/v3.1/toolkits/auth/callback
123 ```
124
125 <Tabs items={['GitHub', 'Google']}>
docs/content/docs/auth-configuration/white-labeling.mdx
+3 -3
@@ -56,7 +56,7 @@ Only white-label toolkits where users see a consent screen (Google, GitHub, Slac
56 Register a new OAuth app with the toolkit. Set the callback URL to:
57
58 ```
59 -https://backend.composio.dev/api/v3/toolkits/auth/callback
59 +https://backend.composio.dev/api/v3.1/toolkits/auth/callback
60 ```
61
62 You'll get a **Client ID** and **Client Secret**.
@@ -214,7 +214,7 @@ app = FastAPI()
214
215 @app.get("/api/composio-redirect")
216 def composio_redirect(request: Request):
217 - composio_url = "https://backend.composio.dev/api/v3/toolkits/auth/callback"
217 + composio_url = "https://backend.composio.dev/api/v3.1/toolkits/auth/callback"
218 return RedirectResponse(url=f"{composio_url}?{request.url.query}")
219 ```
220 </Tab>
@@ -224,7 +224,7 @@ def composio_redirect(request: Request):
224 import type { NextApiRequest, NextApiResponse } from "next";
225
226 export default function handler(req: NextApiRequest, res: NextApiResponse) {
227 - const composioUrl = "https://backend.composio.dev/api/v3/toolkits/auth/callback";
227 + const composioUrl = "https://backend.composio.dev/api/v3.1/toolkits/auth/callback";
228 const params = new URLSearchParams(req.query as Record<string, string>);
229 res.redirect(302, `${composioUrl}?${params.toString()}`);
230 }
docs/content/docs/custom-app-vs-managed-app.mdx
+1 -1
@@ -35,7 +35,7 @@ Bring your own credentials when any of these apply:
35 Go to the toolkit's developer portal and register a new OAuth app. You'll need to set the authorized redirect URI to:
36
37 ```
38 -https://backend.composio.dev/api/v3/toolkits/auth/callback
38 +https://backend.composio.dev/api/v3.1/toolkits/auth/callback
39 ```
40
41 Once registered, copy your **Client ID** and **Client Secret**.
docs/content/docs/importing-existing-connections.mdx
+3 -3
@@ -205,7 +205,7 @@ await composio.connectedAccounts.update('ca_your_connection_id', {
205 </Tab>
206 <Tab value="curl">
207 ```bash
208 -curl -X PATCH https://backend.composio.dev/api/v3/connected_accounts/ca_xxx \
208 +curl -X PATCH https://backend.composio.dev/api/v3.1/connected_accounts/ca_xxx \
209 -H 'x-api-key: YOUR_API_KEY' \
210 -H 'Content-Type: application/json' \
211 -d '{"connection":{"state":{"authScheme":"BEARER_TOKEN","val":{"token":"new-access-token"}}}}'
@@ -245,7 +245,7 @@ await composio.connectedAccounts.update('ca_your_connection_id', {
245 </Tab>
246 <Tab value="curl">
247 ```bash
248 -curl -X PATCH https://backend.composio.dev/api/v3/connected_accounts/ca_xxx \
248 +curl -X PATCH https://backend.composio.dev/api/v3.1/connected_accounts/ca_xxx \
249 -H 'x-api-key: YOUR_API_KEY' \
250 -H 'Content-Type: application/json' \
251 -d '{"connection":{"state":{"authScheme":"API_KEY","val":{"generic_api_key":"new-api-key"}}}}'
@@ -285,7 +285,7 @@ await composio.connectedAccounts.update('ca_your_connection_id', {
285 </Tab>
286 <Tab value="curl">
287 ```bash
288 -curl -X PATCH https://backend.composio.dev/api/v3/connected_accounts/ca_xxx \
288 +curl -X PATCH https://backend.composio.dev/api/v3.1/connected_accounts/ca_xxx \
289 -H 'x-api-key: YOUR_API_KEY' \
290 -H 'Content-Type: application/json' \
291 -d '{"connection":{"state":{"authScheme":"BASIC","val":{"username":"user@example.com","password":"new-password"}}}}'
docs/content/docs/troubleshooting/mcp.mdx
+1 -1
@@ -13,7 +13,7 @@ This error occurs when MCP cannot find a valid connected account for authenticat
13 - Account status is `ACTIVE` (not deleted)
14 - Account belongs to the same auth config used to create the MCP server. MCP servers only resolve connected accounts through their bound auth configs, so connections under a different auth config will not be found.
15
16 -To fix a mismatched auth config, update the MCP server's `auth_config_ids` using the [`PATCH /api/v3/mcp/{id}`](/reference/api-reference/mcp/patchMcpById) endpoint.
16 +To fix a mismatched auth config, update the MCP server's `auth_config_ids` using the [`PATCH /api/v3.1/mcp/{id}`](/reference/api-reference/mcp/patchMcpById) endpoint.
17
18 Learn more: [Single Toolkit MCP](/docs/single-toolkit-mcp)
19
docs/content/docs/white-labeling-authentication.mdx
+3 -3
@@ -50,7 +50,7 @@ Only white-label toolkits where users see a consent screen (Google, GitHub, Slac
50 Register a new OAuth app with the toolkit. Set the callback URL to:
51
52 ```
53 -https://backend.composio.dev/api/v3/toolkits/auth/callback
53 +https://backend.composio.dev/api/v3.1/toolkits/auth/callback
54 ```
55
56 You'll get a **Client ID** and **Client Secret**.
@@ -193,7 +193,7 @@ app = FastAPI()
193
194 @app.get("/api/composio-redirect")
195 def composio_redirect(request: Request):
196 - composio_url = "https://backend.composio.dev/api/v3/toolkits/auth/callback"
196 + composio_url = "https://backend.composio.dev/api/v3.1/toolkits/auth/callback"
197 return RedirectResponse(url=f"{composio_url}?{request.url.query}")
198 ```
199 </Tab>
@@ -203,7 +203,7 @@ def composio_redirect(request: Request):
203 import type { NextApiRequest, NextApiResponse } from "next";
204
205 export default function handler(req: NextApiRequest, res: NextApiResponse) {
206 - const composioUrl = "https://backend.composio.dev/api/v3/toolkits/auth/callback";
206 + const composioUrl = "https://backend.composio.dev/api/v3.1/toolkits/auth/callback";
207 const params = new URLSearchParams(req.query as Record<string, string>);
208 res.redirect(302, `${composioUrl}?${params.toString()}`);
209 }
docs/content/toolkits/faq/slack.md
+1 -1
@@ -24,7 +24,7 @@ Update the redirect URL in your Slack App under OAuth & Permissions → Redirect
24
25 ## How do I set up Slack event webhooks?
26
27 -Enable Event Subscriptions in your Slack app. Set the Request URL to `https://backend.composio.dev/api/v3/trigger_instances/slack/default/handle`. Add events (e.g., `reaction_added`) to Subscribe to Bot Events and save. If using the Slackbot integration, add the bot to the channels you want to monitor.
27 +Enable Event Subscriptions in your Slack app. Set the Request URL to `https://backend.composio.dev/api/v3.1/trigger_instances/slack/default/handle`. Add events (e.g., `reaction_added`) to Subscribe to Bot Events and save. If using the Slackbot integration, add the bot to the channels you want to monitor.
28
29 ## Why am I getting scope errors on Slack?
30