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: update toolkits, API spec, and meta tools data (#4752)
sdkrelease[bot] committed
Oct 5, 2026 at 22:52 UTC
900bbb390d4b2aebe683b843d5f8967063b7c994
3 files changed
+33
-514
docs/content/reference/api-reference/toolkits/index.mdx
+1
-1
@@ -25,4 +25,4 @@ To browse toolkits visually, see the [toolkits catalog](/toolkits). For the conc
25
26
## Endpoints
27
28
-<ApiEndpointsTable endpoints={[{"method":"POST","pathV31":"/api/v3.1/custom/toolkits","pathV3":"/api/v3/custom/toolkits","summary":"Create a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkits"},{"method":"DELETE","pathV31":"/api/v3.1/custom/toolkits/{slug}","pathV3":"/api/v3/custom/toolkits/{slug}","summary":"Delete a custom toolkit","href":"/reference/api-reference/toolkits/deleteCustomToolkitsBySlug"},{"method":"PATCH","pathV31":"/api/v3.1/custom/toolkits/{slug}","pathV3":"/api/v3/custom/toolkits/{slug}","summary":"Update a custom toolkit","href":"/reference/api-reference/toolkits/patchCustomToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/{toolkit_slug}/scopes/recommended","pathV3":"/api/v3/toolkits/{toolkit_slug}/scopes/recommended","summary":"Get required scopes","href":"/reference/api-reference/toolkits/recommendToolkitScopes"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{toolkit_slug}/scopes/grant_context","pathV3":"/api/v3/toolkits/{toolkit_slug}/scopes/grant_context","summary":"List grant contexts","href":"/reference/api-reference/toolkits/recommendToolkitScopesGrantContext"},{"method":"GET","pathV31":"/api/v3.1/toolkits","pathV3":"/api/v3/toolkits","summary":"List available toolkits","href":"/reference/api-reference/toolkits/getToolkits"},{"method":"GET","pathV31":"/api/v3.1/toolkits/categories","pathV3":"/api/v3/toolkits/categories","summary":"List toolkit categories","href":"/reference/api-reference/toolkits/getToolkitsCategories"},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/upsert","pathV3":"/api/v3/custom/toolkits/upsert","summary":"Upsert a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkitsUpsert"},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/sync","pathV3":"/api/v3/custom/toolkits/sync","summary":"Sync a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkitsSync"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{slug}","pathV3":"/api/v3/toolkits/{slug}","summary":"Get toolkit by slug","href":"/reference/api-reference/toolkits/getToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/multi","pathV3":"/api/v3/toolkits/multi","summary":"Fetch multiple toolkits","href":"/reference/api-reference/toolkits/postToolkitsMulti"},{"method":"GET","pathV31":"/api/v3.1/toolkits/changelog","pathV3":"/api/v3/toolkits/changelog","summary":"Get toolkits changelog","href":"/reference/api-reference/toolkits/getToolkitsChangelog"}]} />
28
+<ApiEndpointsTable endpoints={[{"method":"DELETE","pathV31":"/api/v3.1/custom/toolkits/{slug}","pathV3":"/api/v3/custom/toolkits/{slug}","summary":"Delete a custom toolkit","href":"/reference/api-reference/toolkits/deleteCustomToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/{toolkit_slug}/scopes/recommended","pathV3":"/api/v3/toolkits/{toolkit_slug}/scopes/recommended","summary":"Get required scopes","href":"/reference/api-reference/toolkits/recommendToolkitScopes"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{toolkit_slug}/scopes/grant_context","pathV3":"/api/v3/toolkits/{toolkit_slug}/scopes/grant_context","summary":"List grant contexts","href":"/reference/api-reference/toolkits/recommendToolkitScopesGrantContext"},{"method":"GET","pathV31":"/api/v3.1/toolkits","pathV3":"/api/v3/toolkits","summary":"List available toolkits","href":"/reference/api-reference/toolkits/getToolkits"},{"method":"GET","pathV31":"/api/v3.1/toolkits/categories","pathV3":"/api/v3/toolkits/categories","summary":"List toolkit categories","href":"/reference/api-reference/toolkits/getToolkitsCategories"},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/upsert","pathV3":"/api/v3/custom/toolkits/upsert","summary":"Upsert a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkitsUpsert"},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/sync","pathV3":"/api/v3/custom/toolkits/sync","summary":"Sync a custom toolkit","href":"/reference/api-reference/toolkits/postCustomToolkitsSync"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{slug}","pathV3":"/api/v3/toolkits/{slug}","summary":"Get toolkit by slug","href":"/reference/api-reference/toolkits/getToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/multi","pathV3":"/api/v3/toolkits/multi","summary":"Fetch multiple toolkits","href":"/reference/api-reference/toolkits/postToolkitsMulti"},{"method":"GET","pathV31":"/api/v3.1/toolkits/changelog","pathV3":"/api/v3/toolkits/changelog","summary":"Get toolkits changelog","href":"/reference/api-reference/toolkits/getToolkitsChangelog"}]} />
docs/public/openapi-v3.json
+16
-4
@@ -9289,7 +9289,7 @@
9289
"/api/v3/custom/toolkits/upsert": {
9290
"post": {
9291
"summary": "Upsert a custom toolkit",
9292
- "description": "Experimental: custom toolkits are in pilot and this contract may change. Prefer POST /api/v3.1/custom/toolkits (which sets which users can use a toolkit) and PATCH /api/v3.1/custom/toolkits/{slug}. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. app_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
9292
+ "description": "Experimental: custom toolkits are in pilot and this contract may change. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. app_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
9293
"tags": [
9294
"Toolkits"
9295
],
@@ -9330,7 +9330,7 @@
9330
"app_url": {
9331
"type": "string",
9332
"format": "uri",
9333
- "description": "MCP server URL"
9333
+ "description": "MCP server URL. Must use https."
9334
},
9335
"logo_file": {
9336
"type": "object",
@@ -9431,7 +9431,8 @@
9431
"discovery_url": {
9432
"type": "string",
9433
"format": "uri",
9434
- "description": "OAuth authorization server metadata URL, usually <MCP URL>/.well-known/oauth-authorization-server"
9434
+ "description": "OAuth authorization server metadata URL, for example https://<auth server host>/.well-known/oauth-authorization-server. Use the URL your authorization server publishes; it can be on a different host from the MCP server or include a path.",
9435
+ "example": "https://mcp.example.com/.well-known/oauth-authorization-server"
9436
}
9437
},
9438
"required": [
@@ -9657,6 +9658,16 @@
9658
}
9659
}
9660
},
9661
+ "403": {
9662
+ "description": "Forbidden - The caller cannot write custom toolkits",
9663
+ "content": {
9664
+ "application/json": {
9665
+ "schema": {
9666
+ "$ref": "#/components/schemas/Error"
9667
+ }
9668
+ }
9669
+ }
9670
+ },
9671
"404": {
9672
"description": "Not found - Toolkit not found",
9673
"content": {
@@ -19090,7 +19101,8 @@
19101
"COMPOSIO_REMOTE_WORKBENCH",
19102
"COMPOSIO_REMOTE_BASH_TOOL",
19103
"COMPOSIO_GET_TOOL_SCHEMAS",
19093
- "COMPOSIO_SUBMIT_FEEDBACK"
19104
+ "COMPOSIO_SUBMIT_FEEDBACK",
19105
+ "COMPOSIO_PROXY_EXECUTE"
19106
],
19107
"description": "The unique slug identifier of the meta tool to execute",
19108
"example": "COMPOSIO_MANAGE_CONNECTIONS"
docs/public/openapi.json
+16
-509
@@ -5667,309 +5667,6 @@
5667
"x-api-version": "3.1"
5668
}
5669
},
5670
- "/api/v3.1/custom/toolkits": {
5671
- "post": {
5672
- "summary": "Create a custom toolkit",
5673
- "description": "Experimental: this endpoint may change. Creates a custom MCP toolkit and returns its slug. Set user_id to \"all\" to share the toolkit with every user in the project, or to a user ID to make it private to that user. Access cannot be changed later. For a private toolkit, the response can include a connect_link to send that user to.",
5674
- "tags": [
5675
- "Toolkits"
5676
- ],
5677
- "operationId": "postCustomToolkits",
5678
- "security": [
5679
- {
5680
- "ApiKeyAuth": []
5681
- },
5682
- {
5683
- "UserApiKeyAuth": []
5684
- }
5685
- ],
5686
- "requestBody": {
5687
- "required": true,
5688
- "description": "Toolkit to create",
5689
- "content": {
5690
- "application/json": {
5691
- "schema": {
5692
- "type": "object",
5693
- "properties": {
5694
- "name": {
5695
- "type": "string",
5696
- "minLength": 1,
5697
- "maxLength": 200,
5698
- "description": "Display name of the toolkit"
5699
- },
5700
- "app_url": {
5701
- "type": "string",
5702
- "format": "uri",
5703
- "description": "MCP server URL"
5704
- },
5705
- "logo_file": {
5706
- "type": "object",
5707
- "properties": {
5708
- "content": {
5709
- "type": "string",
5710
- "minLength": 1,
5711
- "maxLength": 4000000,
5712
- "pattern": "^[A-Za-z0-9+/]+={0,2}$",
5713
- "description": "Base64-encoded image, max 3MB decoded"
5714
- },
5715
- "mime_type": {
5716
- "type": "string",
5717
- "enum": [
5718
- "image/png",
5719
- "image/jpeg"
5720
- ],
5721
- "description": "Image MIME type"
5722
- }
5723
- },
5724
- "required": [
5725
- "content",
5726
- "mime_type"
5727
- ],
5728
- "additionalProperties": false,
5729
- "description": "Square PNG or JPEG logo, 256-1024px, max 3MB. Defaults to the Model Context Protocol logo."
5730
- },
5731
- "auth_schemes": {
5732
- "type": "array",
5733
- "items": {
5734
- "oneOf": [
5735
- {
5736
- "type": "object",
5737
- "properties": {
5738
- "mode": {
5739
- "type": "string",
5740
- "enum": [
5741
- "NO_AUTH"
5742
- ]
5743
- }
5744
- },
5745
- "required": [
5746
- "mode"
5747
- ],
5748
- "additionalProperties": false
5749
- },
5750
- {
5751
- "type": "object",
5752
- "properties": {
5753
- "mode": {
5754
- "type": "string",
5755
- "enum": [
5756
- "API_KEY"
5757
- ]
5758
- },
5759
- "headers": {
5760
- "type": "object",
5761
- "additionalProperties": {
5762
- "type": "string"
5763
- },
5764
- "description": "Headers sent to the MCP server. Use {{generic_api_key}} where the API key goes."
5765
- },
5766
- "api_key_field": {
5767
- "type": "object",
5768
- "properties": {
5769
- "display_name": {
5770
- "type": "string",
5771
- "minLength": 1,
5772
- "maxLength": 100,
5773
- "description": "Label for the API key input"
5774
- },
5775
- "description": {
5776
- "type": "string",
5777
- "minLength": 1,
5778
- "maxLength": 500,
5779
- "description": "Help text below the API key input"
5780
- }
5781
- },
5782
- "additionalProperties": false,
5783
- "description": "Label and help text for the API key input on the connect page"
5784
- }
5785
- },
5786
- "required": [
5787
- "mode",
5788
- "headers"
5789
- ],
5790
- "additionalProperties": false
5791
- },
5792
- {
5793
- "type": "object",
5794
- "properties": {
5795
- "mode": {
5796
- "type": "string",
5797
- "enum": [
5798
- "DCR_OAUTH"
5799
- ]
5800
- },
5801
- "discovery_url": {
5802
- "type": "string",
5803
- "format": "uri",
5804
- "description": "OAuth authorization server metadata URL, usually <MCP URL>/.well-known/oauth-authorization-server"
5805
- }
5806
- },
5807
- "required": [
5808
- "mode",
5809
- "discovery_url"
5810
- ],
5811
- "additionalProperties": false
5812
- }
5813
- ]
5814
- },
5815
- "minItems": 1,
5816
- "description": "How users authenticate to the MCP server"
5817
- },
5818
- "user_id": {
5819
- "anyOf": [
5820
- {
5821
- "type": "string",
5822
- "enum": [
5823
- "all"
5824
- ]
5825
- },
5826
- {
5827
- "type": "string",
5828
- "minLength": 1,
5829
- "maxLength": 256
5830
- }
5831
- ],
5832
- "description": "\"all\" to share the toolkit with every user in the project, or a user ID to make it private to that user. Cannot be changed after create.",
5833
- "example": "all"
5834
- },
5835
- "callback_url": {
5836
- "type": "string",
5837
- "format": "uri",
5838
- "description": "URL to send the user to after they connect. Used only for connect_link."
5839
- }
5840
- },
5841
- "required": [
5842
- "name",
5843
- "app_url",
5844
- "auth_schemes",
5845
- "user_id"
5846
- ],
5847
- "additionalProperties": false
5848
- }
5849
- }
5850
- }
5851
- },
5852
- "responses": {
5853
- "200": {
5854
- "description": "Successfully created toolkit",
5855
- "content": {
5856
- "application/json": {
5857
- "schema": {
5858
- "type": "object",
5859
- "properties": {
5860
- "slug": {
5861
- "type": "string",
5862
- "description": "Slug of the created toolkit",
5863
- "example": "CUSTOM_NOTION_K7F2Q"
5864
- },
5865
- "connect_link": {
5866
- "type": "object",
5867
- "nullable": true,
5868
- "properties": {
5869
- "redirect_url": {
5870
- "type": "string",
5871
- "description": "Hosted connect page. Send the user here."
5872
- },
5873
- "expires_at": {
5874
- "type": "string",
5875
- "description": "When the link expires (ISO 8601)"
5876
- },
5877
- "connected_account_id": {
5878
- "type": "string",
5879
- "format": "connectedAccountId",
5880
- "description": "Connected account for the user. It becomes ACTIVE once they connect."
5881
- }
5882
- },
5883
- "required": [
5884
- "redirect_url",
5885
- "expires_at",
5886
- "connected_account_id"
5887
- ],
5888
- "description": "Link for a private toolkit's user to connect. Null for shared or no-auth toolkits, or if the link could not be created. To retry, call POST /api/v3/connected_accounts/link with an auth config for the toolkit, creating one with POST /api/v3/auth_configs if needed."
5889
- }
5890
- },
5891
- "required": [
5892
- "slug",
5893
- "connect_link"
5894
- ]
5895
- }
5896
- }
5897
- }
5898
- },
5899
- "400": {
5900
- "description": "Bad request - Invalid parameters",
5901
- "content": {
5902
- "application/json": {
5903
- "schema": {
5904
- "$ref": "#/components/schemas/Error"
5905
- }
5906
- }
5907
- }
5908
- },
5909
- "401": {
5910
- "description": "Unauthorized - Invalid or missing credentials",
5911
- "content": {
5912
- "application/json": {
5913
- "schema": {
5914
- "$ref": "#/components/schemas/Error"
5915
- }
5916
- }
5917
- }
5918
- },
5919
- "403": {
5920
- "description": "Forbidden - Your role cannot create custom toolkits",
5921
- "content": {
5922
- "application/json": {
5923
- "schema": {
5924
- "$ref": "#/components/schemas/Error"
5925
- }
5926
- }
5927
- }
5928
- },
5929
- "408": {
5930
- "description": "Request timeout",
5931
- "content": {
5932
- "application/json": {
5933
- "schema": {
5934
- "$ref": "#/components/schemas/Error"
5935
- }
5936
- }
5937
- }
5938
- },
5939
- "409": {
5940
- "description": "Conflict - This user already has a private toolkit for this MCP URL",
5941
- "content": {
5942
- "application/json": {
5943
- "schema": {
5944
- "$ref": "#/components/schemas/Error"
5945
- }
5946
- }
5947
- }
5948
- },
5949
- "429": {
5950
- "description": "Too many requests - Retry after a short backoff",
5951
- "content": {
5952
- "application/json": {
5953
- "schema": {
5954
- "$ref": "#/components/schemas/Error"
5955
- }
5956
- }
5957
- }
5958
- },
5959
- "500": {
5960
- "description": "Internal server error - Failed to create toolkit",
5961
- "content": {
5962
- "application/json": {
5963
- "schema": {
5964
- "$ref": "#/components/schemas/Error"
5965
- }
5966
- }
5967
- }
5968
- }
5969
- },
5970
- "x-api-version": "3.1"
5971
- }
5972
- },
5670
"/api/v3.1/custom/toolkits/{slug}": {
5671
"delete": {
5672
"summary": "Delete a custom toolkit",
@@ -6121,208 +5818,6 @@
5818
}
5819
},
5820
"x-api-version": "3.1"
6124
- },
6125
- "patch": {
6126
- "summary": "Update a custom toolkit",
6127
- "description": "Experimental: this endpoint may change. Updates a custom toolkit's name, logo, or API key field text. Omitted fields keep their current value. To change app_url, auth_schemes, or user_id, delete and re-create the toolkit.",
6128
- "tags": [
6129
- "Toolkits"
6130
- ],
6131
- "operationId": "patchCustomToolkitsBySlug",
6132
- "security": [
6133
- {
6134
- "ApiKeyAuth": []
6135
- },
6136
- {
6137
- "UserApiKeyAuth": []
6138
- }
6139
- ],
6140
- "parameters": [
6141
- {
6142
- "schema": {
6143
- "type": "string",
6144
- "minLength": 1,
6145
- "maxLength": 37,
6146
- "pattern": "^[a-zA-Z0-9_]+$",
6147
- "description": "Slug returned when the toolkit was created",
6148
- "example": "CUSTOM_NOTION_K7F2Q"
6149
- },
6150
- "required": true,
6151
- "description": "Custom toolkit slug",
6152
- "name": "slug",
6153
- "in": "path"
6154
- }
6155
- ],
6156
- "requestBody": {
6157
- "required": true,
6158
- "description": "Fields to update",
6159
- "content": {
6160
- "application/json": {
6161
- "schema": {
6162
- "type": "object",
6163
- "properties": {
6164
- "name": {
6165
- "type": "string",
6166
- "minLength": 1,
6167
- "maxLength": 200,
6168
- "description": "Display name of the toolkit"
6169
- },
6170
- "logo_file": {
6171
- "type": "object",
6172
- "properties": {
6173
- "content": {
6174
- "type": "string",
6175
- "minLength": 1,
6176
- "maxLength": 4000000,
6177
- "pattern": "^[A-Za-z0-9+/]+={0,2}$",
6178
- "description": "Base64-encoded image, max 3MB decoded"
6179
- },
6180
- "mime_type": {
6181
- "type": "string",
6182
- "enum": [
6183
- "image/png",
6184
- "image/jpeg"
6185
- ],
6186
- "description": "Image MIME type"
6187
- }
6188
- },
6189
- "required": [
6190
- "content",
6191
- "mime_type"
6192
- ],
6193
- "additionalProperties": false,
6194
- "description": "Square PNG or JPEG logo, 256-1024px, max 3MB. Defaults to the Model Context Protocol logo."
6195
- },
6196
- "api_key_field": {
6197
- "type": "object",
6198
- "properties": {
6199
- "display_name": {
6200
- "type": "string",
6201
- "minLength": 1,
6202
- "maxLength": 100,
6203
- "description": "Label for the API key input"
6204
- },
6205
- "description": {
6206
- "type": "string",
6207
- "minLength": 1,
6208
- "maxLength": 500,
6209
- "description": "Help text below the API key input"
6210
- }
6211
- },
6212
- "additionalProperties": false,
6213
- "description": "Label and help text for the API key input on the connect page. API_KEY toolkits only."
6214
- }
6215
- },
6216
- "additionalProperties": false
6217
- }
6218
- }
6219
- }
6220
- },
6221
- "responses": {
6222
- "200": {
6223
- "description": "Successfully updated toolkit",
6224
- "content": {
6225
- "application/json": {
6226
- "schema": {
6227
- "type": "object",
6228
- "properties": {
6229
- "success": {
6230
- "type": "boolean",
6231
- "enum": [
6232
- true
6233
- ],
6234
- "description": "The toolkit was updated"
6235
- }
6236
- },
6237
- "required": [
6238
- "success"
6239
- ]
6240
- }
6241
- }
6242
- }
6243
- },
6244
- "400": {
6245
- "description": "Bad request - Invalid parameters",
6246
- "content": {
6247
- "application/json": {
6248
- "schema": {
6249
- "$ref": "#/components/schemas/Error"
6250
- }
6251
- }
6252
- }
6253
- },
6254
- "401": {
6255
- "description": "Unauthorized - Invalid or missing credentials",
6256
- "content": {
6257
- "application/json": {
6258
- "schema": {
6259
- "$ref": "#/components/schemas/Error"
6260
- }
6261
- }
6262
- }
6263
- },
6264
- "403": {
6265
- "description": "Forbidden - Your role cannot update custom toolkits",
6266
- "content": {
6267
- "application/json": {
6268
- "schema": {
6269
- "$ref": "#/components/schemas/Error"
6270
- }
6271
- }
6272
- }
6273
- },
6274
- "404": {
6275
- "description": "Not found - Toolkit not found",
6276
- "content": {
6277
- "application/json": {
6278
- "schema": {
6279
- "$ref": "#/components/schemas/Error"
6280
- }
6281
- }
6282
- }
6283
- },
6284
- "408": {
6285
- "description": "Request timeout",
6286
- "content": {
6287
- "application/json": {
6288
- "schema": {
6289
- "$ref": "#/components/schemas/Error"
6290
- }
6291
- }
6292
- }
6293
- },
6294
- "409": {
6295
- "description": "Conflict - The toolkit cannot be updated right now",
6296
- "content": {
6297
- "application/json": {
6298
- "schema": {
6299
- "$ref": "#/components/schemas/Error"
6300
- }
6301
- }
6302
- }
6303
- },
6304
- "429": {
6305
- "description": "Too many requests - Retry after a short backoff",
6306
- "content": {
6307
- "application/json": {
6308
- "schema": {
6309
- "$ref": "#/components/schemas/Error"
6310
- }
6311
- }
6312
- }
6313
- },
6314
- "500": {
6315
- "description": "Internal server error - Failed to update toolkit",
6316
- "content": {
6317
- "application/json": {
6318
- "schema": {
6319
- "$ref": "#/components/schemas/Error"
6320
- }
6321
- }
6322
- }
6323
- }
6324
- },
6325
- "x-api-version": "3.1"
5821
}
5822
},
5823
"/api/v3.1/toolkits/{toolkit_slug}/scopes/recommended": {
@@ -13159,7 +12654,8 @@
12654
"COMPOSIO_REMOTE_WORKBENCH",
12655
"COMPOSIO_REMOTE_BASH_TOOL",
12656
"COMPOSIO_GET_TOOL_SCHEMAS",
13162
- "COMPOSIO_SUBMIT_FEEDBACK"
12657
+ "COMPOSIO_SUBMIT_FEEDBACK",
12658
+ "COMPOSIO_PROXY_EXECUTE"
12659
],
12660
"description": "The unique slug identifier of the meta tool to execute",
12661
"example": "COMPOSIO_MANAGE_CONNECTIONS"
@@ -21928,7 +21424,7 @@
21424
"/api/v3.1/custom/toolkits/upsert": {
21425
"post": {
21426
"summary": "Upsert a custom toolkit",
21931
- "description": "Experimental: custom toolkits are in pilot and this contract may change. Prefer POST /api/v3.1/custom/toolkits (which sets which users can use a toolkit) and PATCH /api/v3.1/custom/toolkits/{slug}. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. app_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
21427
+ "description": "Experimental: custom toolkits are in pilot and this contract may change. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. app_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
21428
"tags": [
21429
"Toolkits"
21430
],
@@ -21969,7 +21465,7 @@
21465
"app_url": {
21466
"type": "string",
21467
"format": "uri",
21972
- "description": "MCP server URL"
21468
+ "description": "MCP server URL. Must use https."
21469
},
21470
"logo_file": {
21471
"type": "object",
@@ -22070,7 +21566,8 @@
21566
"discovery_url": {
21567
"type": "string",
21568
"format": "uri",
22073
- "description": "OAuth authorization server metadata URL, usually <MCP URL>/.well-known/oauth-authorization-server"
21569
+ "description": "OAuth authorization server metadata URL, for example https://<auth server host>/.well-known/oauth-authorization-server. Use the URL your authorization server publishes; it can be on a different host from the MCP server or include a path.",
21570
+ "example": "https://mcp.example.com/.well-known/oauth-authorization-server"
21571
}
21572
},
21573
"required": [
@@ -22296,6 +21793,16 @@
21793
}
21794
}
21795
},
21796
+ "403": {
21797
+ "description": "Forbidden - The caller cannot write custom toolkits",
21798
+ "content": {
21799
+ "application/json": {
21800
+ "schema": {
21801
+ "$ref": "#/components/schemas/Error"
21802
+ }
21803
+ }
21804
+ }
21805
+ },
21806
"404": {
21807
"description": "Not found - Toolkit not found",
21808
"content": {