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: simplify scoped key permissions and reconcile current routes
Mukund committed
Sep 15, 2026 at 13:49 UTC
61a2674ef5303df8286a6726d0c5694e2b121f52
1 file changed
+146
-167
docs/content/reference/authenticating-to-composio/project-api-key-permissions.mdx
+146
-167
@@ -23,7 +23,7 @@ Create a scoped key from the dashboard:
23
24
<Steps>
25
<Step>
26
-Go to the [Composio Dashboard](https://dashboard.composio.dev).
26
+Go to the [Composio Dashboard](https://dashboard.composio.dev?utm_source=docs&utm_medium=content&utm_campaign=project-api-key-permissions).
27
</Step>
28
<Step>
29
Select **Platform**.
@@ -53,161 +53,140 @@ Click **Create API Key**, then choose the permission areas and access levels bel
53
54
Some read routes use `POST` because the request body carries filters or lookup input. The access level is based on what the route does, not only the HTTP method.
55
56
-The session, MCP, and proxy tables list both v3 and v3.1 routes explicitly. Elsewhere, equivalent routes may be represented by one version. Version-specific routes are listed separately, and MCP transport routes use their public paths.
56
+The REST tables show paths relative to the API base URL, with each operation listed once. Use the [API reference](/reference) for the full request URL and endpoint availability. MCP transports use the URL returned when you create a session or MCP server.
57
58
## Permission areas
59
60
-Jump to each permission area to see the routes it covers.
61
-
62
-| Permission area | Available levels | Routes |
63
-| ------------------------ | ------------------------------------------------ | --------------------------------------- |
64
-| Auth configs | No access, Read only, Write only, Read and write | [View routes](#auth-configs) |
65
-| Connected accounts | No access, Read only, Write only, Read and write | [View routes](#connected-accounts) |
66
-| Tools | No access, Read only | [View routes](#tools) |
67
-| Tool execution (Legacy) | No access, Write only | [View routes](#tool-execution-legacy) |
68
-| Session management | No access, Read only, Write only, Read and write | [View routes](#session-management) |
69
-| Session tool execution | No access, Write only | [View routes](#session-tool-execution) |
70
-| MCP (Legacy) | No access, Read only, Write only, Read and write | [View routes](#mcp-legacy) |
71
-| Proxy execute (Legacy) | No access, Write only | [View routes](#proxy-execute-legacy) |
72
-| Toolkits | No access, Read only, Write only, Read and write | [View routes](#toolkits) |
73
-| Triggers | No access, Read only, Write only, Read and write | [View routes](#triggers) |
74
-| Webhooks | No access, Read only, Write only, Read and write | [View routes](#webhooks) |
75
-| Observability | No access, Read only | [View routes](#observability) |
76
-| Sessions (legacy) | Existing keys only | [View routes](#sessions-legacy) |
60
+For a session-based integration, grant **Session management** to create and configure sessions, and **Session tool execution** to search and execute tools. Write only is enough to create sessions. Choose Read and write if you also need to retrieve them.
61
+
62
+Jump to each permission area to see the routes it covers. The dashboard labels **Tool execution (Legacy)** and **Proxy execute (Legacy)** still use the permission identifiers `tool_execution` and `proxy_execute`.
63
+
64
+| Permission area | Available levels | Routes |
65
+| ----------------------- | ------------------------------------------------ | -------------------------------------- |
66
+| Auth configs | No access, Read only, Write only, Read and write | [View routes](#auth-configs) |
67
+| Connected accounts | No access, Read only, Write only, Read and write | [View routes](#connected-accounts) |
68
+| Tools | No access, Read only | [View routes](#tools) |
69
+| Tool execution (Legacy) | No access, Write only | [View routes](#tool-execution-legacy) |
70
+| Session management | No access, Read only, Write only, Read and write | [View routes](#session-management) |
71
+| Session tool execution | No access, Write only | [View routes](#session-tool-execution) |
72
+| MCP (Legacy) | No access, Read only, Write only, Read and write | [View routes](#mcp-legacy) |
73
+| Proxy execute (Legacy) | No access, Write only | [View routes](#proxy-execute-legacy) |
74
+| Toolkits | No access, Read only, Write only, Read and write | [View routes](#toolkits) |
75
+| Triggers | No access, Read only, Write only, Read and write | [View routes](#triggers) |
76
+| Webhooks | No access, Read only, Write only, Read and write | [View routes](#webhooks) |
77
+| Observability | No access, Read only | [View routes](#observability) |
78
+| Sessions (legacy) | Existing keys only | [View routes](#sessions-legacy) |
79
80
## Auth configs
81
82
View and modify auth configs.
83
82
-| Access | Method | Endpoint |
83
-| ------ | -------- | ---------------------------------------- |
84
-| Read | `GET` | `/api/v3/auth_configs` |
85
-| Read | `GET` | `/api/v3/auth_configs/{nanoid}` |
86
-| Write | `POST` | `/api/v3/auth_configs` |
87
-| Write | `PATCH` | `/api/v3/auth_configs/{nanoid}` |
88
-| Write | `DELETE` | `/api/v3/auth_configs/{nanoid}` |
89
-| Write | `PATCH` | `/api/v3/auth_configs/{nanoid}/{status}` |
84
+| Access | Method | Route |
85
+| ------ | -------- | --------------------------------- |
86
+| Read | `GET` | `/auth_configs` |
87
+| Read | `GET` | `/auth_configs/{nanoid}` |
88
+| Write | `POST` | `/auth_configs` |
89
+| Write | `PATCH` | `/auth_configs/{nanoid}` |
90
+| Write | `DELETE` | `/auth_configs/{nanoid}` |
91
+| Write | `PATCH` | `/auth_configs/{nanoid}/{status}` |
92
93
## Connected accounts
94
95
View and manage connected accounts.
96
95
-| Access | Method | Endpoint |
96
-| ------ | -------- | ---------------------------------------------- |
97
-| Read | `GET` | `/api/v3/connected_accounts` |
98
-| Read | `GET` | `/api/v3/connected_accounts/{nanoid}` |
99
-| Write | `POST` | `/api/v3/connected_accounts` |
100
-| Write | `POST` | `/api/v3/connected_accounts/link` |
101
-| Write | `PATCH` | `/api/v3/connected_accounts/{nanoid}` |
102
-| Write | `PATCH` | `/api/v3/connected_accounts/{nanoid}/status` |
103
-| Write | `POST` | `/api/v3/connected_accounts/{nanoid}/refresh` |
104
-| Write | `DELETE` | `/api/v3/connected_accounts/{nanoid}` |
105
-| Write | `POST` | `/api/v3.1/connected_accounts/{nanoid}/revoke` |
97
+| Access | Method | Route |
98
+| ------ | -------- | -------------------------------------- |
99
+| Read | `GET` | `/connected_accounts` |
100
+| Read | `GET` | `/connected_accounts/{nanoid}` |
101
+| Write | `POST` | `/connected_accounts` |
102
+| Write | `POST` | `/connected_accounts/link` |
103
+| Write | `PATCH` | `/connected_accounts/{nanoid}` |
104
+| Write | `PATCH` | `/connected_accounts/{nanoid}/status` |
105
+| Write | `POST` | `/connected_accounts/{nanoid}/refresh` |
106
+| Write | `DELETE` | `/connected_accounts/{nanoid}` |
107
+| Write | `POST` | `/connected_accounts/{nanoid}/revoke` |
108
109
## Tools
110
111
View tool definitions, inputs, scopes, and versions.
112
111
-| Access | Method | Endpoint |
112
-| ------ | ------ | ---------------------------------------------- |
113
-| Read | `GET` | `/api/v3.1/tools` |
114
-| Read | `GET` | `/api/v3.1/tools/enum` |
115
-| Read | `GET` | `/api/v3.1/tools/{tool_slug}` |
116
-| Read | `GET` | `/api/v3/tools/{tool_slug}/get_latest_version` |
117
-| Read | `GET` | `/api/v3.1/tools/scopes/required` |
118
-| Read | `GET` | `/api/v3.1/tools/get_scopes_required` |
119
-| Read | `POST` | `/api/v3.1/tools/execute/{tool_slug}/input` |
113
+| Access | Method | Route |
114
+| ------ | ------ | --------------------------------------- |
115
+| Read | `GET` | `/tools` |
116
+| Read | `GET` | `/tools/enum` |
117
+| Read | `GET` | `/tools/{tool_slug}` |
118
+| Read | `GET` | `/tools/{tool_slug}/get_latest_version` |
119
+| Read | `GET` | `/tools/scopes/required` |
120
+| Read | `GET` | `/tools/get_scopes_required` |
121
+| Read | `POST` | `/tools/execute/{tool_slug}/input` |
122
123
## Tool execution (Legacy)
124
125
Execute tools through the legacy direct execution API.
126
125
-| Access | Method | Endpoint |
126
-| ------ | ------ | ------------------------------------- |
127
-| Write | `POST` | `/api/v3/tools/execute/{tool_slug}` |
128
-| Write | `POST` | `/api/v3.1/tools/execute/{tool_slug}` |
129
-| Write | `POST` | `/api/v3/files/upload/request` |
130
-| Write | `POST` | `/api/v3/files/upload/response` |
131
-| Write | `GET` | `/api/v3/files/list` |
127
+| Access | Method | Route |
128
+| ------ | ------ | ---------------------------- |
129
+| Write | `POST` | `/tools/execute/{tool_slug}` |
130
+| Write | `POST` | `/files/upload/request` |
131
+| Write | `POST` | `/files/upload/response` |
132
+| Write | `GET` | `/files/list` |
133
134
## Session management
135
136
Create, view, configure, and delete sessions. This permission does not allow tool execution.
137
137
-| Access | Method | Endpoint |
138
-| ------ | -------- | ------------------------------------------------------------------------- |
139
-| Read | `GET` | `/api/v3/tool_router/session/{session_id}` |
140
-| Read | `GET` | `/api/v3/tool_router/session/{session_id}/toolkits` |
141
-| Read | `GET` | `/api/v3/tool_router/session/{session_id}/tools` |
142
-| Read | `GET` | `/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/items` |
143
-| Read | `GET` | `/api/v3.1/tool_router/session/{session_id}` |
144
-| Read | `GET` | `/api/v3.1/tool_router/session/{session_id}/toolkits` |
145
-| Read | `GET` | `/api/v3.1/tool_router/session/{session_id}/config_history` |
146
-| Read | `GET` | `/api/v3.1/tool_router/session/{session_id}/tools` |
147
-| Read | `GET` | `/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/items` |
148
-| Write | `POST` | `/api/v3/tool_router/session` |
149
-| Write | `POST` | `/api/v3/tool_router/session/{session_id}/link` |
150
-| Write | `PATCH` | `/api/v3/tool_router/session/{session_id}` |
151
-| Write | `POST` | `/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/upload_url` |
152
-| Write | `POST` | `/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/download_url` |
153
-| Write | `POST` | `/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/delete` |
154
-| Write | `POST` | `/api/v3.1/tool_router/session` |
155
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/attach` |
156
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/link` |
157
-| Write | `PATCH` | `/api/v3.1/tool_router/session/{session_id}` |
158
-| Write | `DELETE` | `/api/v3.1/tool_router/session/{session_id}` |
159
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/upload_url` |
160
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/download_url` |
161
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/mounts/{mount_id}/delete` |
138
+The Session config read routes below are experimental and require Session configs to be enabled for your project. Existing `sessions` grants do not cover these routes.
139
+
140
+| Access | Method | Route |
141
+| ------ | -------- | ------------------------------------------------------------------ |
142
+| Read | `GET` | `/session_configs` |
143
+| Read | `GET` | `/session_configs/{session_config_id}` |
144
+| Read | `GET` | `/tool_router/session/{session_id}` |
145
+| Read | `GET` | `/tool_router/session/{session_id}/toolkits` |
146
+| Read | `GET` | `/tool_router/session/{session_id}/tools` |
147
+| Read | `GET` | `/tool_router/session/{session_id}/mounts/{mount_id}/items` |
148
+| Read | `GET` | `/tool_router/session/{session_id}/config_history` |
149
+| Write | `POST` | `/tool_router/session` |
150
+| Write | `POST` | `/tool_router/session/{session_id}/link` |
151
+| Write | `PATCH` | `/tool_router/session/{session_id}` |
152
+| Write | `POST` | `/tool_router/session/{session_id}/mounts/{mount_id}/upload_url` |
153
+| Write | `POST` | `/tool_router/session/{session_id}/mounts/{mount_id}/download_url` |
154
+| Write | `POST` | `/tool_router/session/{session_id}/mounts/{mount_id}/delete` |
155
+| Write | `POST` | `/tool_router/session/{session_id}/attach` |
156
+| Write | `DELETE` | `/tool_router/session/{session_id}` |
157
158
## Session tool execution
159
160
Search and execute tools through sessions and session-linked MCP servers. This includes session proxy execution, so it grants every execution capability exposed through a session.
161
167
-| Access | Method | Endpoint |
168
-| ------ | ------ | -------------------------------------------------------------- |
169
-| Write | `POST` | `/api/v3/tool_router/session/{session_id}/execute` |
170
-| Write | `POST` | `/api/v3/tool_router/session/{session_id}/execute_meta` |
171
-| Write | `POST` | `/api/v3/tool_router/session/{session_id}/search` |
172
-| Write | `POST` | `/api/v3/tool_router/session/{session_id}/proxy_execute` |
173
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/execute` |
174
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/execute_meta` |
175
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/search` |
176
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/proxy_execute` |
177
-| Write | `POST` | `/tool_router/{session_id}/mcp` |
162
+| Access | Method | Route |
163
+| ------ | ------ | ------------------------------------------------- |
164
+| Write | `POST` | `/tool_router/session/{session_id}/execute` |
165
+| Write | `POST` | `/tool_router/session/{session_id}/execute_meta` |
166
+| Write | `POST` | `/tool_router/session/{session_id}/search` |
167
+| Write | `POST` | `/tool_router/session/{session_id}/proxy_execute` |
168
+
169
+For [session-linked MCP access](/docs/sessions-via-mcp), use `session.mcp.url` and `session.mcp.headers` unchanged. `POST` requests require Session tool execution with Write only access. The transport does not support `GET` (SSE) or `DELETE`; granting additional permissions does not enable those methods.
170
171
## MCP (Legacy)
172
173
Create, manage, and connect to MCP servers. Transport access grants every capability exposed by the configured MCP server.
174
183
-| Access | Method | Endpoint |
184
-| ------ | -------- | ------------------------------------------------------------------- |
185
-| Read | `GET` | `/api/v3/mcp/servers` |
186
-| Read | `GET` | `/api/v3.1/mcp/servers` |
187
-| Read | `GET` | `/api/v3/mcp/{id}` |
188
-| Read | `GET` | `/api/v3.1/mcp/{id}` |
189
-| Read | `GET` | `/api/v3/mcp/app/{app_key}` |
190
-| Read | `GET` | `/api/v3.1/mcp/app/{app_key}` |
191
-| Read | `GET` | `/api/v3/mcp/servers/{server_id}/instances` |
192
-| Read | `GET` | `/api/v3.1/mcp/servers/{server_id}/instances` |
193
-| Write | `POST` | `/api/v3/mcp/servers` |
194
-| Write | `POST` | `/api/v3.1/mcp/servers` |
195
-| Write | `POST` | `/api/v3/mcp/servers/generate` |
196
-| Write | `POST` | `/api/v3.1/mcp/servers/generate` |
197
-| Write | `POST` | `/api/v3/mcp/servers/custom` |
198
-| Write | `POST` | `/api/v3.1/mcp/servers/custom` |
199
-| Write | `PATCH` | `/api/v3/mcp/{id}` |
200
-| Write | `PATCH` | `/api/v3.1/mcp/{id}` |
201
-| Write | `DELETE` | `/api/v3/mcp/{id}` |
202
-| Write | `DELETE` | `/api/v3.1/mcp/{id}` |
203
-| Write | `POST` | `/api/v3/mcp/servers/{server_id}/instances` |
204
-| Write | `POST` | `/api/v3.1/mcp/servers/{server_id}/instances` |
205
-| Write | `DELETE` | `/api/v3/mcp/servers/{server_id}/instances/{instance_id}` |
206
-| Write | `DELETE` | `/api/v3.1/mcp/servers/{server_id}/instances/{instance_id}` |
207
-| Write | `POST` | `/v3/mcp/{server_id}/{transport}` |
208
-| Write | `POST` | `/v3.1/mcp/{server_id}/{transport}` |
209
-| Write | `DELETE` | `/v3/mcp/{server_id}/{transport}` |
210
-| Write | `DELETE` | `/v3.1/mcp/{server_id}/{transport}` |
175
+| Access | Method | Route |
176
+| ------ | -------- | -------------------------------------------------- |
177
+| Read | `GET` | `/mcp/servers` |
178
+| Read | `GET` | `/mcp/{id}` |
179
+| Read | `GET` | `/mcp/app/{app_key}` |
180
+| Read | `GET` | `/mcp/servers/{server_id}/instances` |
181
+| Write | `POST` | `/mcp/servers` |
182
+| Write | `POST` | `/mcp/servers/generate` |
183
+| Write | `POST` | `/mcp/servers/custom` |
184
+| Write | `PATCH` | `/mcp/{id}` |
185
+| Write | `DELETE` | `/mcp/{id}` |
186
+| Write | `POST` | `/mcp/servers/{server_id}/instances` |
187
+| Write | `DELETE` | `/mcp/servers/{server_id}/instances/{instance_id}` |
188
+
189
+For MCP transport access, use the returned MCP server URL unchanged. `POST` and `DELETE` requests require MCP (Legacy) with Write only or Read and write access.
190
191
## Proxy execute (Legacy)
192
@@ -215,78 +194,78 @@ Execute raw proxy requests against connected accounts through direct and session
194
195
Proxy execute is separate from tool execution. Session proxy routes accept either Session tool execution or Proxy execute (Legacy). Use Session tool execution for new session-based integrations; existing Proxy execute keys retain their access.
196
218
-| Access | Method | Endpoint |
219
-| ------ | ------ | ----------------------------------------------------------------- |
220
-| Write | `POST` | `/api/v3/tools/execute/proxy` |
221
-| Write | `POST` | `/api/v3.1/tools/execute/proxy` |
222
-| Write | `POST` | `/api/v3/tool_router/session/{session_id}/proxy_execute` |
223
-| Write | `POST` | `/api/v3.1/tool_router/session/{session_id}/proxy_execute` |
197
+| Access | Method | Route |
198
+| ------ | ------ | ------------------------------------------------- |
199
+| Write | `POST` | `/tools/execute/proxy` |
200
+| Write | `POST` | `/tool_router/session/{session_id}/proxy_execute` |
201
202
## Toolkits
203
204
View and install toolkits.
205
229
-| Access | Method | Endpoint |
230
-| ------ | ------ | ----------------------------- |
231
-| Read | `GET` | `/api/v3/toolkits` |
232
-| Read | `GET` | `/api/v3/toolkits/{slug}` |
233
-| Read | `GET` | `/api/v3/toolkits/categories` |
234
-| Read | `GET` | `/api/v3/toolkits/changelog` |
235
-| Write | `POST` | `/api/v3/toolkits/multi` |
206
+| Access | Method | Route |
207
+| ------ | ------ | ----------------------------------------------- |
208
+| Read | `GET` | `/toolkits` |
209
+| Read | `GET` | `/toolkits/{slug}` |
210
+| Read | `GET` | `/toolkits/categories` |
211
+| Read | `GET` | `/toolkits/changelog` |
212
+| Read | `POST` | `/toolkits/{toolkit_slug}/scopes/recommended` |
213
+| Read | `GET` | `/toolkits/{toolkit_slug}/scopes/grant_context` |
214
+| Write | `POST` | `/toolkits/multi` |
215
216
## Triggers
217
218
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.
219
241
-| Access | Method | Endpoint |
242
-| ------ | -------- | ---------------------------------------------- |
243
-| Read | `GET` | `/api/v3/triggers_types` |
244
-| Read | `GET` | `/api/v3/triggers_types/{slug}` |
245
-| Read | `GET` | `/api/v3/triggers_types/list/enum` |
246
-| Read | `GET` | `/api/v3/trigger_instances/active` |
247
-| Read | `GET` | `/api/v3/cli/realtime/credentials` |
248
-| Read | `POST` | `/api/v3/cli/realtime/auth` |
249
-| Read | `GET` | `/api/v3/internal/sdk/realtime/credentials` |
250
-| Read | `POST` | `/api/v3/internal/sdk/realtime/auth` |
251
-| Write | `POST` | `/api/v3/trigger_instances/{slug}/upsert` |
252
-| Write | `PATCH` | `/api/v3/trigger_instances/manage/{triggerId}` |
253
-| Write | `DELETE` | `/api/v3/trigger_instances/manage/{triggerId}` |
220
+| Access | Method | Route |
221
+| ------ | -------- | --------------------------------------- |
222
+| Read | `GET` | `/triggers_types` |
223
+| Read | `GET` | `/triggers_types/{slug}` |
224
+| Read | `GET` | `/triggers_types/list/enum` |
225
+| Read | `GET` | `/trigger_instances/active` |
226
+| Read | `GET` | `/cli/realtime/credentials` |
227
+| Read | `POST` | `/cli/realtime/auth` |
228
+| Read | `GET` | `/internal/sdk/realtime/credentials` |
229
+| Read | `POST` | `/internal/sdk/realtime/auth` |
230
+| Write | `POST` | `/trigger_instances/{slug}/upsert` |
231
+| Write | `PATCH` | `/trigger_instances/manage/{triggerId}` |
232
+| Write | `DELETE` | `/trigger_instances/manage/{triggerId}` |
233
234
## Webhooks
235
236
View and manage webhook endpoints and subscriptions.
237
259
-| Access | Method | Endpoint |
260
-| ------ | -------- | -------------------------------------------------- |
261
-| Read | `GET` | `/api/v3/webhook_endpoints` |
262
-| Read | `GET` | `/api/v3/webhook_endpoints/{nano_id}` |
263
-| Read | `GET` | `/api/v3/webhook_endpoints/schema` |
264
-| Read | `GET` | `/api/v3/webhook_subscriptions` |
265
-| Read | `GET` | `/api/v3/webhook_subscriptions/{id}` |
266
-| Read | `GET` | `/api/v3/webhook_subscriptions/event_types` |
267
-| Write | `POST` | `/api/v3/webhook_endpoints` |
268
-| Write | `POST` | `/api/v3/webhook_endpoints/{nano_id}` |
269
-| Write | `PATCH` | `/api/v3/webhook_endpoints/{nano_id}` |
270
-| Write | `DELETE` | `/api/v3/webhook_endpoints/{nano_id}` |
271
-| Write | `POST` | `/api/v3/webhook_subscriptions` |
272
-| Write | `PATCH` | `/api/v3/webhook_subscriptions/{id}` |
273
-| Write | `DELETE` | `/api/v3/webhook_subscriptions/{id}` |
274
-| Write | `POST` | `/api/v3/webhook_subscriptions/{id}/rotate_secret` |
238
+| Access | Method | Route |
239
+| ------ | -------- | ------------------------------------------- |
240
+| Read | `GET` | `/webhook_endpoints` |
241
+| Read | `GET` | `/webhook_endpoints/{nano_id}` |
242
+| Read | `GET` | `/webhook_endpoints/schema` |
243
+| Read | `GET` | `/webhook_subscriptions` |
244
+| Read | `GET` | `/webhook_subscriptions/{id}` |
245
+| Read | `GET` | `/webhook_subscriptions/event_types` |
246
+| Write | `POST` | `/webhook_endpoints` |
247
+| Write | `POST` | `/webhook_endpoints/{nano_id}` |
248
+| Write | `PATCH` | `/webhook_endpoints/{nano_id}` |
249
+| Write | `DELETE` | `/webhook_endpoints/{nano_id}` |
250
+| Write | `POST` | `/webhook_subscriptions` |
251
+| Write | `PATCH` | `/webhook_subscriptions/{id}` |
252
+| Write | `DELETE` | `/webhook_subscriptions/{id}` |
253
+| Write | `POST` | `/webhook_subscriptions/{id}/rotate_secret` |
254
255
## Observability
256
257
View execution logs and project usage summaries.
258
280
-| Access | Method | Endpoint |
281
-| ------ | ------ | --------------------------------------- |
282
-| Read | `POST` | `/api/v3.1/logs/tool_execution` |
283
-| Read | `GET` | `/api/v3.1/logs/tool_execution/{id}` |
284
-| Read | `POST` | `/api/v3.1/project/usage/{entity_type}` |
285
-| Read | `POST` | `/api/v3.1/project/usage/summary` |
259
+| Access | Method | Route |
260
+| ------ | ------ | ------------------------------ |
261
+| Read | `POST` | `/logs/tool_execution` |
262
+| Read | `GET` | `/logs/tool_execution/{id}` |
263
+| Read | `POST` | `/project/usage/{entity_type}` |
264
+| Read | `POST` | `/project/usage/summary` |
265
266
## Sessions (legacy)
267
289
-The `sessions` permission is no longer available when you create a scoped API key. Existing keys keep their original access unchanged.
268
+The `sessions` permission is no longer available when you create a scoped API key. Existing keys keep their original permission grants. New routes, such as Session config reads, are not added to these grants.
269
270
- Existing `sessions: read` grants continue to cover session reads and legacy MCP server reads.
271
- Existing `sessions: write` grants continue to cover session management writes, legacy MCP server writes, session `execute`, `execute_meta`, and `search` routes, and MCP transport writes. They do not cover session proxy execution.