@devries-cameron20 / composio-1 / commits / 84445bcac
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: add MCP, files, and realtime routes to scoped API key permissions

Catalog additions from ComposioHQ/platform#10638 (PLEN-2623): - sessions now covers MCP server management and both MCP transports - tool execution adds files upload/response and files list - triggers adds the SDK/CLI realtime subscribe endpoints Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

shams haroon committed Jun 11, 2026 at 10:21 UTC 84445bcacb4b638ea6514e45f04849f1c6fc0884
1 file changed +24 -2
docs/content/reference/authentication/project-api-key-permissions.mdx
+24 -2
@@ -98,6 +98,8 @@ Execute predefined Composio tools.
98 | Write | `POST` | `/api/v3/tools/execute/{tool_slug}` |
99 | Write | `POST` | `/api/v3.1/tools/execute/{tool_slug}` |
100 | Write | `POST` | `/api/v3/files/upload/request` |
101 +| Write | `POST` | `/api/v3/files/upload/response` |
102 +| Write | `GET` | `/api/v3/files/list` |
103
104 ## Proxy execute
105
@@ -124,7 +126,7 @@ View and install toolkits.
126
127 ## Triggers
128
127 -View trigger types and manage trigger instances.
129 +View trigger types, manage trigger instances, and subscribe to trigger events. The realtime routes are called by the SDK (`triggers.subscribe()`) and the CLI to receive trigger events.
130
131 | Access | Method | Endpoint |
132 |---|---|---|
@@ -132,6 +134,10 @@ View trigger types and manage trigger instances.
134 | Read | `GET` | `/api/v3/triggers_types/{slug}` |
135 | Read | `GET` | `/api/v3/triggers_types/list/enum` |
136 | Read | `GET` | `/api/v3/trigger_instances/active` |
137 +| Read | `GET` | `/api/v3/cli/realtime/credentials` |
138 +| Read | `POST` | `/api/v3/cli/realtime/auth` |
139 +| Read | `GET` | `/api/v3/internal/sdk/realtime/credentials` |
140 +| Read | `POST` | `/api/v3/internal/sdk/realtime/auth` |
141 | Write | `POST` | `/api/v3/trigger_instances/{slug}/upsert` |
142 | Write | `PATCH` | `/api/v3/trigger_instances/manage/{triggerId}` |
143 | Write | `DELETE` | `/api/v3/trigger_instances/manage/{triggerId}` |
@@ -170,10 +176,15 @@ View execution logs and project usage summaries.
176
177 ## Sessions
178
173 -Create and operate sessions.
179 +Create and operate sessions and MCP servers. This permission area covers MCP server management, the MCP runtime transport, and the tool router MCP transport.
180
181 | Access | Method | Endpoint |
182 |---|---|---|
183 +| Read | `GET` | `/api/v3/mcp/servers` |
184 +| Read | `GET` | `/api/v3/mcp/{id}` |
185 +| Read | `GET` | `/api/v3/mcp/app/{app_key}` |
186 +| Read | `GET` | `/api/v3/mcp/servers/{server_id}/instances` |
187 +| Read | `GET` | `/tool_router/{session_id}/mcp` |
188 | Read | `GET` | `/api/v3/tool_router/session/{session_id}` |
189 | Read | `GET` | `/api/v3/tool_router/session/{session_id}/toolkits` |
190 | Read | `GET` | `/api/v3/tool_router/session/{session_id}/tools` |
@@ -181,6 +192,17 @@ Create and operate sessions.
192 | Read | `GET` | `/api/v3.1/tool_router/session/{session_id}` |
193 | Read | `GET` | `/api/v3.1/tool_router/session/{session_id}/config_history` |
194 | Read | `GET` | `/api/v3.1/tool_router/session/{session_id}/tools` |
195 +| Write | `POST` | `/api/v3/mcp/servers` |
196 +| Write | `POST` | `/api/v3/mcp/servers/generate` |
197 +| Write | `POST` | `/api/v3/mcp/servers/custom` |
198 +| Write | `PATCH` | `/api/v3/mcp/{id}` |
199 +| Write | `DELETE` | `/api/v3/mcp/{id}` |
200 +| Write | `POST` | `/api/v3/mcp/servers/{server_id}/instances` |
201 +| Write | `DELETE` | `/api/v3/mcp/servers/{server_id}/instances/{instance_id}` |
202 +| Write | `POST` | `/api/v3/mcp/{server_id}/{transport}` |
203 +| Write | `DELETE` | `/api/v3/mcp/{server_id}/{transport}` |
204 +| Write | `POST` | `/tool_router/{session_id}/mcp` |
205 +| Write | `DELETE` | `/tool_router/{session_id}/mcp` |
206 | Write | `POST` | `/api/v3/tool_router/session` |
207 | Write | `POST` | `/api/v3/tool_router/session/{session_id}/execute` |
208 | Write | `POST` | `/api/v3/tool_router/session/{session_id}/execute_meta` |