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` |