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: replace hardcoded IGNORED_PATHS with x-internal tag filter
The OpenAPI spec now uses `x-internal` as a tag on internal endpoints. Instead of maintaining a hardcoded list of paths to ignore, filter any operation tagged with `x-internal` automatically. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sushmitha Mallesh committed
Mar 2, 2026 at 09:48 UTC
64599271d86e328a45624cb2998ec5433d7f43cb
2 files changed
+7
-23
docs/public/openapi.json
+4
-4
@@ -1335,10 +1335,10 @@
1335
{
1336
"schema": {
1337
"type": "string",
1338
- "description": "Search auth configs by name"
1338
+ "description": "Search auth configs by name or id"
1339
},
1340
"required": false,
1341
- "description": "Search auth configs by name",
1341
+ "description": "Search auth configs by name or id",
1342
"name": "search",
1343
"in": "query"
1344
},
@@ -2809,7 +2809,7 @@
2809
"status_reason": {
2810
"type": "string",
2811
"nullable": true,
2812
- "description": "The reason the connection is disabled"
2812
+ "description": "The reason the connection status changed. Possible reasons: Connection initiation did not complete within 10 minutes, Permanent auth error during token refresh, Max auth failures reached, OAuth callback failed during token exchange, Connection status updated by user, Auth config is disabled"
2813
},
2814
"is_disabled": {
2815
"type": "boolean",
@@ -3731,7 +3731,7 @@
3731
"status_reason": {
3732
"type": "string",
3733
"nullable": true,
3734
- "description": "The reason the connection is disabled"
3734
+ "description": "The reason the connection status changed. Possible reasons: Connection initiation did not complete within 10 minutes, Permanent auth error during token refresh, Max auth failures reached, OAuth callback failed during token exchange, Connection status updated by user, Auth config is disabled"
3735
},
3736
"is_disabled": {
3737
"type": "boolean",
docs/scripts/fetch-openapi.mjs
+3
-19
@@ -11,23 +11,13 @@ import { dirname, join } from 'node:path';
11
12
const OPENAPI_URL = process.env.OPENAPI_SPEC_URL || 'https://backend.composio.dev/api/v3/openapi.json';
13
14
-// Endpoints to ignore (same as fern openapi-overrides.yml)
15
-const IGNORED_PATHS = [
16
- '/api/v3/mcp/validate/{uuid}',
17
- '/api/v3/labs/tool_router/session',
18
- '/api/v3/cli/get-session',
19
- '/api/v3/cli/create-session',
20
- '/api/v3/auth/session/logout',
21
- '/api/v3/cli/realtime/credentials',
22
- '/api/v3/cli/realtime/auth',
23
-];
24
-
14
// Tags to ignore (internal/admin)
15
const IGNORED_TAGS = [
16
'CLI',
17
'Admin',
18
'Profiling',
19
'User',
20
+ 'x-internal',
21
];
22
23
async function fetchAndFilterSpec() {
@@ -45,12 +35,6 @@ async function fetchAndFilterSpec() {
35
let removedCount = 0;
36
37
for (const [path, methods] of Object.entries(spec.paths)) {
48
- // Skip ignored paths
49
- if (IGNORED_PATHS.includes(path)) {
50
- removedCount++;
51
- continue;
52
- }
53
-
38
const filteredMethods = {};
39
40
for (const [method, operation] of Object.entries(methods)) {
@@ -63,8 +47,8 @@ async function fetchAndFilterSpec() {
47
continue;
48
}
49
66
- // Skip if marked as internal
67
- if (operation['x-internal'] === true) {
50
+ // Skip if marked as internal (property or tag)
51
+ if (operation['x-internal'] === true || tags.includes('x-internal')) {
52
removedCount++;
53
continue;
54
}