@devries-cameron20 / composio Mirror · read-only / commits / 867504947
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 22, 12:00 UTC

fix: Use operationId for endpoint URLs instead of slugified summary

fumadocs-openapi uses operationId (e.g., getToolRouterSessionBySessionId) not slugified summaries for page URLs. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Sushmithamallesh committed Jan 30, 2026 at 16:08 UTC 867504947e312f01fcceaf77fbdd6a9e627bf8f6
12 files changed +64 -64
docs/content/reference/api-reference/auth-configs/index.mdx
+6 -6
@@ -11,9 +11,9 @@ Authentication configuration management
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `POST /api/v3/auth_configs` | [Create new authentication configuration](/reference/api-reference/auth-configs/create-new-authentication-configuration) |
15 -| `GET /api/v3/auth_configs` | [List authentication configurations with optional filters](/reference/api-reference/auth-configs/list-authentication-configurations-with-optional-filters) |
16 -| `GET /api/v3/auth_configs/{nanoid}` | [Get single authentication configuration by ID](/reference/api-reference/auth-configs/get-single-authentication-configuration-by-id) |
17 -| `PATCH /api/v3/auth_configs/{nanoid}` | [Update an authentication configuration](/reference/api-reference/auth-configs/update-an-authentication-configuration) |
18 -| `DELETE /api/v3/auth_configs/{nanoid}` | [Delete an authentication configuration](/reference/api-reference/auth-configs/delete-an-authentication-configuration) |
19 -| `PATCH /api/v3/auth_configs/{nanoid}/{status}` | [Enable or disable an authentication configuration](/reference/api-reference/auth-configs/enable-or-disable-an-authentication-configuration) |
14 +| `POST /api/v3/auth_configs` | [Create new authentication configuration](/reference/api-reference/auth-configs/postAuthConfigs) |
15 +| `GET /api/v3/auth_configs` | [List authentication configurations with optional filters](/reference/api-reference/auth-configs/getAuthConfigs) |
16 +| `GET /api/v3/auth_configs/{nanoid}` | [Get single authentication configuration by ID](/reference/api-reference/auth-configs/getAuthConfigsByNanoid) |
17 +| `PATCH /api/v3/auth_configs/{nanoid}` | [Update an authentication configuration](/reference/api-reference/auth-configs/patchAuthConfigsByNanoid) |
18 +| `DELETE /api/v3/auth_configs/{nanoid}` | [Delete an authentication configuration](/reference/api-reference/auth-configs/deleteAuthConfigsByNanoid) |
19 +| `PATCH /api/v3/auth_configs/{nanoid}/{status}` | [Enable or disable an authentication configuration](/reference/api-reference/auth-configs/patchAuthConfigsByNanoidByStatus) |
docs/content/reference/api-reference/authentication/index.mdx
+1 -1
@@ -11,4 +11,4 @@ Authentication related endpoints
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `GET /api/v3/auth/session/info` | [Get current user session information](/reference/api-reference/authentication/get-current-user-session-information) |
14 +| `GET /api/v3/auth/session/info` | [Get current user session information](/reference/api-reference/authentication/getAuthSessionInfo) |
docs/content/reference/api-reference/connected-accounts/index.mdx
+7 -7
@@ -11,10 +11,10 @@ Connected account management
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `GET /api/v3/connected_accounts` | [List connected accounts with optional filters](/reference/api-reference/connected-accounts/list-connected-accounts-with-optional-filters) |
15 -| `POST /api/v3/connected_accounts` | [Create a new connected account](/reference/api-reference/connected-accounts/create-a-new-connected-account) |
16 -| `GET /api/v3/connected_accounts/{nanoid}` | [Get connected account details by ID](/reference/api-reference/connected-accounts/get-connected-account-details-by-id) |
17 -| `DELETE /api/v3/connected_accounts/{nanoid}` | [Delete a connected account](/reference/api-reference/connected-accounts/delete-a-connected-account) |
18 -| `PATCH /api/v3/connected_accounts/{nanoId}/status` | [Enable or disable a connected account](/reference/api-reference/connected-accounts/enable-or-disable-a-connected-account) |
19 -| `POST /api/v3/connected_accounts/{nanoid}/refresh` | [Refresh authentication for a connected account](/reference/api-reference/connected-accounts/refresh-authentication-for-a-connected-account) |
20 -| `POST /api/v3/connected_accounts/link` | [Create a new auth link session](/reference/api-reference/connected-accounts/create-a-new-auth-link-session) |
14 +| `GET /api/v3/connected_accounts` | [List connected accounts with optional filters](/reference/api-reference/connected-accounts/getConnectedAccounts) |
15 +| `POST /api/v3/connected_accounts` | [Create a new connected account](/reference/api-reference/connected-accounts/postConnectedAccounts) |
16 +| `GET /api/v3/connected_accounts/{nanoid}` | [Get connected account details by ID](/reference/api-reference/connected-accounts/getConnectedAccountsByNanoid) |
17 +| `DELETE /api/v3/connected_accounts/{nanoid}` | [Delete a connected account](/reference/api-reference/connected-accounts/deleteConnectedAccountsByNanoid) |
18 +| `PATCH /api/v3/connected_accounts/{nanoId}/status` | [Enable or disable a connected account](/reference/api-reference/connected-accounts/patchConnectedAccountsByNanoIdStatus) |
19 +| `POST /api/v3/connected_accounts/{nanoid}/refresh` | [Refresh authentication for a connected account](/reference/api-reference/connected-accounts/postConnectedAccountsByNanoidRefresh) |
20 +| `POST /api/v3/connected_accounts/link` | [Create a new auth link session](/reference/api-reference/connected-accounts/postConnectedAccountsLink) |
docs/content/reference/api-reference/files/index.mdx
+2 -2
@@ -11,5 +11,5 @@ File management
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `GET /api/v3/files/list` | [List files with optional app and action filters](/reference/api-reference/files/list-files-with-optional-app-and-action-filters) |
15 -| `POST /api/v3/files/upload/request` | [Create presigned URL for request file upload to S3](/reference/api-reference/files/create-presigned-url-for-request-file-upload-to-s3) |
14 +| `GET /api/v3/files/list` | [List files with optional app and action filters](/reference/api-reference/files/getFilesList) |
15 +| `POST /api/v3/files/upload/request` | [Create presigned URL for request file upload to S3](/reference/api-reference/files/postFilesUploadRequest) |
docs/content/reference/api-reference/mcp/index.mdx
+11 -11
@@ -11,14 +11,14 @@ MCP server management
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `GET /api/v3/mcp/servers` | [List MCP servers with optional filters and pagination](/reference/api-reference/mcp/list-mcp-servers-with-optional-filters-and-pagination) |
15 -| `POST /api/v3/mcp/servers` | [Create a new MCP server](/reference/api-reference/mcp/create-a-new-mcp-server) |
16 -| `POST /api/v3/mcp/servers/custom` | [Create a new custom MCP server with multiple apps](/reference/api-reference/mcp/create-a-new-custom-mcp-server-with-multiple-apps) |
17 -| `POST /api/v3/mcp/servers/generate` | [Generate MCP URL with custom parameters](/reference/api-reference/mcp/generate-mcp-url-with-custom-parameters) |
18 -| `GET /api/v3/mcp/{id}` | [Get MCP server details by ID](/reference/api-reference/mcp/get-mcp-server-details-by-id) |
19 -| `PATCH /api/v3/mcp/{id}` | [Update MCP server configuration](/reference/api-reference/mcp/update-mcp-server-configuration) |
20 -| `DELETE /api/v3/mcp/{id}` | [Delete an MCP server](/reference/api-reference/mcp/delete-an-mcp-server) |
21 -| `GET /api/v3/mcp/app/{appKey}` | [List MCP servers for a specific app](/reference/api-reference/mcp/list-mcp-servers-for-a-specific-app) |
22 -| `GET /api/v3/mcp/servers/{serverId}/instances` | [List all instances for an MCP server](/reference/api-reference/mcp/list-all-instances-for-an-mcp-server) |
23 -| `POST /api/v3/mcp/servers/{serverId}/instances` | [Create a new MCP server instance](/reference/api-reference/mcp/create-a-new-mcp-server-instance) |
24 -| `DELETE /api/v3/mcp/servers/{serverId}/instances/{instanceId}` | [Delete an MCP server instance and associated connected accounts](/reference/api-reference/mcp/delete-an-mcp-server-instance-and-associated-connected-accounts) |
14 +| `GET /api/v3/mcp/servers` | [List MCP servers with optional filters and pagination](/reference/api-reference/mcp/getMcpServers) |
15 +| `POST /api/v3/mcp/servers` | [Create a new MCP server](/reference/api-reference/mcp/postMcpServers) |
16 +| `POST /api/v3/mcp/servers/custom` | [Create a new custom MCP server with multiple apps](/reference/api-reference/mcp/postMcpServersCustom) |
17 +| `POST /api/v3/mcp/servers/generate` | [Generate MCP URL with custom parameters](/reference/api-reference/mcp/postMcpServersGenerate) |
18 +| `GET /api/v3/mcp/{id}` | [Get MCP server details by ID](/reference/api-reference/mcp/getMcpById) |
19 +| `PATCH /api/v3/mcp/{id}` | [Update MCP server configuration](/reference/api-reference/mcp/patchMcpById) |
20 +| `DELETE /api/v3/mcp/{id}` | [Delete an MCP server](/reference/api-reference/mcp/deleteMcpById) |
21 +| `GET /api/v3/mcp/app/{appKey}` | [List MCP servers for a specific app](/reference/api-reference/mcp/getMcpAppByAppKey) |
22 +| `GET /api/v3/mcp/servers/{serverId}/instances` | [List all instances for an MCP server](/reference/api-reference/mcp/getMcpServersByServerIdInstances) |
23 +| `POST /api/v3/mcp/servers/{serverId}/instances` | [Create a new MCP server instance](/reference/api-reference/mcp/postMcpServersByServerIdInstances) |
24 +| `DELETE /api/v3/mcp/servers/{serverId}/instances/{instanceId}` | [Delete an MCP server instance and associated connected accounts](/reference/api-reference/mcp/deleteMcpServersByServerIdInstancesByInstanceId) |
docs/content/reference/api-reference/migration/index.mdx
+1 -1
@@ -11,4 +11,4 @@ Endpoints to help with migration from v1 to v3
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `GET /api/v3/migration/get-nanoid` | [Get NanoId from UUID](/reference/api-reference/migration/get-nanoid-from-uuid) |
14 +| `GET /api/v3/migration/get-nanoid` | [Get NanoId from UUID](/reference/api-reference/migration/getMigrationGetNanoid) |
docs/content/reference/api-reference/projects/index.mdx
+7 -7
@@ -11,10 +11,10 @@ Projects API endpoints
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `GET /api/v3/org/project/config` | [Get project configuration](/reference/api-reference/projects/get-project-configuration) |
15 -| `PATCH /api/v3/org/project/config` | [Update project configuration](/reference/api-reference/projects/update-project-configuration) |
16 -| `POST /api/v3/org/owner/project/new` | [Create a new project](/reference/api-reference/projects/create-a-new-project) |
17 -| `GET /api/v3/org/owner/project/list` | [List all projects](/reference/api-reference/projects/list-all-projects) |
18 -| `GET /api/v3/org/owner/project/{nano_id}` | [Get project details by ID With Org Api key](/reference/api-reference/projects/get-project-details-by-id-with-org-api-key) |
19 -| `DELETE /api/v3/org/owner/project/{nano_id}` | [Delete a project](/reference/api-reference/projects/delete-a-project) |
20 -| `POST /api/v3/org/owner/project/{nano_id}/regenerate_api_key` | [Delete and generate new API key for project](/reference/api-reference/projects/delete-and-generate-new-api-key-for-project) |
14 +| `GET /api/v3/org/project/config` | [Get project configuration](/reference/api-reference/projects/getOrgProjectConfig) |
15 +| `PATCH /api/v3/org/project/config` | [Update project configuration](/reference/api-reference/projects/patchOrgProjectConfig) |
16 +| `POST /api/v3/org/owner/project/new` | [Create a new project](/reference/api-reference/projects/postOrgOwnerProjectNew) |
17 +| `GET /api/v3/org/owner/project/list` | [List all projects](/reference/api-reference/projects/getOrgOwnerProjectList) |
18 +| `GET /api/v3/org/owner/project/{nano_id}` | [Get project details by ID With Org Api key](/reference/api-reference/projects/getOrgOwnerProjectByNanoId) |
19 +| `DELETE /api/v3/org/owner/project/{nano_id}` | [Delete a project](/reference/api-reference/projects/deleteOrgOwnerProjectByNanoId) |
20 +| `POST /api/v3/org/owner/project/{nano_id}/regenerate_api_key` | [Delete and generate new API key for project](/reference/api-reference/projects/postOrgOwnerProjectByNanoIdRegenerateApiKey) |
docs/content/reference/api-reference/tool-router/index.mdx
+7 -7
@@ -11,10 +11,10 @@ description: "(Labs) Tool router endpoints"
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `POST /api/v3/tool_router/session` | [Create a new tool router session](/reference/api-reference/tool-router/create-a-new-tool-router-session) |
15 -| `POST /api/v3/tool_router/session/{session_id}/execute` | [Execute a tool within a tool router session](/reference/api-reference/tool-router/execute-a-tool-within-a-tool-router-session) |
16 -| `POST /api/v3/tool_router/session/{session_id}/execute_meta` | [Execute a meta tool within a tool router session](/reference/api-reference/tool-router/execute-a-meta-tool-within-a-tool-router-session) |
17 -| `GET /api/v3/tool_router/session/{session_id}` | [Get a tool router session by ID](/reference/api-reference/tool-router/get-a-tool-router-session-by-id) |
18 -| `POST /api/v3/tool_router/session/{session_id}/link` | [Create a link session for a toolkit in a tool router session](/reference/api-reference/tool-router/create-a-link-session-for-a-toolkit-in-a-tool-router-session) |
19 -| `GET /api/v3/tool_router/session/{session_id}/toolkits` | [Get toolkits for a tool router session](/reference/api-reference/tool-router/get-toolkits-for-a-tool-router-session) |
20 -| `GET /api/v3/tool_router/session/{session_id}/tools` | [List meta tools with schemas for a tool router session](/reference/api-reference/tool-router/list-meta-tools-with-schemas-for-a-tool-router-session) |
14 +| `POST /api/v3/tool_router/session` | [Create a new tool router session](/reference/api-reference/tool-router/postToolRouterSession) |
15 +| `POST /api/v3/tool_router/session/{session_id}/execute` | [Execute a tool within a tool router session](/reference/api-reference/tool-router/postToolRouterSessionBySessionIdExecute) |
16 +| `POST /api/v3/tool_router/session/{session_id}/execute_meta` | [Execute a meta tool within a tool router session](/reference/api-reference/tool-router/postToolRouterSessionBySessionIdExecuteMeta) |
17 +| `GET /api/v3/tool_router/session/{session_id}` | [Get a tool router session by ID](/reference/api-reference/tool-router/getToolRouterSessionBySessionId) |
18 +| `POST /api/v3/tool_router/session/{session_id}/link` | [Create a link session for a toolkit in a tool router session](/reference/api-reference/tool-router/postToolRouterSessionBySessionIdLink) |
19 +| `GET /api/v3/tool_router/session/{session_id}/toolkits` | [Get toolkits for a tool router session](/reference/api-reference/tool-router/getToolRouterSessionBySessionIdToolkits) |
20 +| `GET /api/v3/tool_router/session/{session_id}/tools` | [List meta tools with schemas for a tool router session](/reference/api-reference/tool-router/getToolRouterSessionBySessionIdTools) |
docs/content/reference/api-reference/toolkits/index.mdx
+5 -5
@@ -11,8 +11,8 @@ Toolkit and tool management
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `GET /api/v3/toolkits` | [List available toolkits](/reference/api-reference/toolkits/list-available-toolkits) |
15 -| `GET /api/v3/toolkits/categories` | [List toolkit categories](/reference/api-reference/toolkits/list-toolkit-categories) |
16 -| `GET /api/v3/toolkits/{slug}` | [Get toolkit by slug](/reference/api-reference/toolkits/get-toolkit-by-slug) |
17 -| `POST /api/v3/toolkits/multi` | [Fetch multiple toolkits](/reference/api-reference/toolkits/fetch-multiple-toolkits) |
18 -| `GET /api/v3/toolkits/changelog` | [Get toolkits changelog](/reference/api-reference/toolkits/get-toolkits-changelog) |
14 +| `GET /api/v3/toolkits` | [List available toolkits](/reference/api-reference/toolkits/getToolkits) |
15 +| `GET /api/v3/toolkits/categories` | [List toolkit categories](/reference/api-reference/toolkits/getToolkitsCategories) |
16 +| `GET /api/v3/toolkits/{slug}` | [Get toolkit by slug](/reference/api-reference/toolkits/getToolkitsBySlug) |
17 +| `POST /api/v3/toolkits/multi` | [Fetch multiple toolkits](/reference/api-reference/toolkits/postToolkitsMulti) |
18 +| `GET /api/v3/toolkits/changelog` | [Get toolkits changelog](/reference/api-reference/toolkits/getToolkitsChangelog) |
docs/content/reference/api-reference/tools/index.mdx
+6 -6
@@ -11,9 +11,9 @@ Tool execution endpoints
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `GET /api/v3/tools` | [List available tools](/reference/api-reference/tools/list-available-tools) |
15 -| `GET /api/v3/tools/enum` | [Get tool enum list](/reference/api-reference/tools/get-tool-enum-list) |
16 -| `GET /api/v3/tools/{tool_slug}` | [Get tool by slug](/reference/api-reference/tools/get-tool-by-slug) |
17 -| `POST /api/v3/tools/execute/{tool_slug}` | [Execute tool](/reference/api-reference/tools/execute-tool) |
18 -| `POST /api/v3/tools/execute/{tool_slug}/input` | [Generate tool inputs from natural language](/reference/api-reference/tools/generate-tool-inputs-from-natural-language) |
19 -| `POST /api/v3/tools/execute/proxy` | [Execute proxy request](/reference/api-reference/tools/execute-proxy-request) |
14 +| `GET /api/v3/tools` | [List available tools](/reference/api-reference/tools/getTools) |
15 +| `GET /api/v3/tools/enum` | [Get tool enum list](/reference/api-reference/tools/getToolsEnum) |
16 +| `GET /api/v3/tools/{tool_slug}` | [Get tool by slug](/reference/api-reference/tools/getToolsByToolSlug) |
17 +| `POST /api/v3/tools/execute/{tool_slug}` | [Execute tool](/reference/api-reference/tools/postToolsExecuteByToolSlug) |
18 +| `POST /api/v3/tools/execute/{tool_slug}/input` | [Generate tool inputs from natural language](/reference/api-reference/tools/postToolsExecuteByToolSlugInput) |
19 +| `POST /api/v3/tools/execute/proxy` | [Execute proxy request](/reference/api-reference/tools/postToolsExecuteProxy) |
docs/content/reference/api-reference/triggers/index.mdx
+7 -7
@@ -11,10 +11,10 @@ Trigger management and execution
11
12 | Endpoint | Quick Link |
13 |----------|------------|
14 -| `POST /api/v3/trigger_instances/{slug}/upsert` | [Create or update a trigger](/reference/api-reference/triggers/create-or-update-a-trigger) |
15 -| `GET /api/v3/trigger_instances/active` | [List active triggers](/reference/api-reference/triggers/list-active-triggers) |
16 -| `DELETE /api/v3/trigger_instances/manage/{triggerId}` | [Delete a trigger](/reference/api-reference/triggers/delete-a-trigger) |
17 -| `PATCH /api/v3/trigger_instances/manage/{triggerId}` | [Enable or disable a trigger](/reference/api-reference/triggers/enable-or-disable-a-trigger) |
18 -| `GET /api/v3/triggers_types/list/enum` | [List trigger type enums](/reference/api-reference/triggers/list-trigger-type-enums) |
19 -| `GET /api/v3/triggers_types/{slug}` | [Get trigger type by slug](/reference/api-reference/triggers/get-trigger-type-by-slug) |
20 -| `GET /api/v3/triggers_types` | [List trigger types](/reference/api-reference/triggers/list-trigger-types) |
14 +| `POST /api/v3/trigger_instances/{slug}/upsert` | [Create or update a trigger](/reference/api-reference/triggers/postTriggerInstancesBySlugUpsert) |
15 +| `GET /api/v3/trigger_instances/active` | [List active triggers](/reference/api-reference/triggers/getTriggerInstancesActive) |
16 +| `DELETE /api/v3/trigger_instances/manage/{triggerId}` | [Delete a trigger](/reference/api-reference/triggers/deleteTriggerInstancesManageByTriggerId) |
17 +| `PATCH /api/v3/trigger_instances/manage/{triggerId}` | [Enable or disable a trigger](/reference/api-reference/triggers/patchTriggerInstancesManageByTriggerId) |
18 +| `GET /api/v3/triggers_types/list/enum` | [List trigger type enums](/reference/api-reference/triggers/getTriggersTypesListEnum) |
19 +| `GET /api/v3/triggers_types/{slug}` | [Get trigger type by slug](/reference/api-reference/triggers/getTriggersTypesBySlug) |
20 +| `GET /api/v3/triggers_types` | [List trigger types](/reference/api-reference/triggers/getTriggersTypes) |
docs/scripts/generate-api-index.ts
+4 -4
@@ -12,7 +12,7 @@ import { join } from 'path';
12
13 interface OpenAPISpec {
14 tags: Array<{ name: string; description?: string }>;
15 - paths: Record<string, Record<string, { summary?: string; tags?: string[]; description?: string }>>;
15 + paths: Record<string, Record<string, { summary?: string; tags?: string[]; description?: string; operationId?: string }>>;
16 }
17
18 function slugify(text: string): string {
@@ -28,7 +28,7 @@ function generateIndexPages() {
28 const spec: OpenAPISpec = JSON.parse(readFileSync(specPath, 'utf-8'));
29
30 // Build tag -> operations map
31 - const tagOperations: Record<string, Array<{ summary: string; description?: string; method: string; path: string }>> = {};
31 + const tagOperations: Record<string, Array<{ summary: string; description?: string; method: string; path: string; operationId: string }>> = {};
32 const tagDescriptions: Record<string, string> = {};
33
34 // Get tag descriptions
@@ -50,6 +50,7 @@ function generateIndexPages() {
50 description: operation.description,
51 method: method.toUpperCase(),
52 path,
53 + operationId: operation.operationId || slugify(operation.summary || ''),
54 });
55 }
56 }
@@ -67,8 +68,7 @@ function generateIndexPages() {
68
69 // Generate endpoint table
70 const tableRows = operations.map(op => {
70 - const endpointSlug = slugify(op.summary);
71 - const url = `/reference/api-reference/${tagSlug}/${endpointSlug}`;
71 + const url = `/reference/api-reference/${tagSlug}/${op.operationId}`;
72
73 return `| \`${op.method} ${op.path}\` | [${op.summary}](${url}) |`;
74 }).join('\n');