6515
"/api/v3.1/custom/toolkits": {
6516
"post": {
6517
"summary": "Create a custom toolkit",
6518
- "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 (\"default\" and other spellings of \"all\" are rejected). Private toolkits require a Pro plan. Access cannot be changed later. For a private toolkit, the response can include a connect_link to send that user to.",
6518
+ "description": "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 (\"default\" and other spellings of \"all\" are rejected). Private toolkits require a Pro plan. Access cannot be changed later. For a private toolkit, the response can include a connect_link to send that user to.",
6519
"tags": [
6520
"Toolkits"
6521
],
6850
"/api/v3.1/custom/toolkits/{slug}": {
6851
"delete": {
6852
"summary": "Delete a custom toolkit",
6853
- "description": "Experimental: custom toolkits are in pilot and this contract may change. Deletes a custom toolkit owned by the project, along with its tools, auth configs, and connected accounts, and revokes the upstream credentials of those connected accounts. Pass `?revoke_on_delete=false` to keep the credentials. Composio-managed toolkits cannot be deleted and return 403.",
6853
+ "description": "Deletes a custom toolkit owned by the project, along with its tools, auth configs, and connected accounts, and revokes the upstream credentials of those connected accounts. Pass `?revoke_on_delete=false` to keep the credentials. Composio-managed toolkits cannot be deleted and return 403.",
6854
"tags": [
6855
"Toolkits"
6856
],
7013
},
7014
"patch": {
7015
"summary": "Update a custom toolkit",
7016
- "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 mcp_url, auth_schemes, or user_id, delete and re-create the toolkit. On a project with 2FA enabled, updating a private toolkit requires the user_id it is private to.",
7016
+ "description": "Updates a custom toolkit's name, logo, or API key field text. Omitted fields keep their current value. To change mcp_url, auth_schemes, or user_id, delete and re-create the toolkit. On a project with 2FA enabled, updating a private toolkit requires the user_id it is private to.",
7017
"tags": [
7018
"Toolkits"
7019
],
24651
"type": "string",
24652
"minLength": 1,
24653
"maxLength": 256,
24654
- "description": "[EXPERIMENTAL] List the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are listed.",
24655
- "example": "user_123",
24656
- "x-experimental": true
24654
+ "description": "List the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are listed.",
24655
+ "example": "user_123"
24656
},
24657
"required": false,
24659
- "description": "[EXPERIMENTAL] List the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are listed.",
24658
+ "description": "List the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are listed.",
24659
"name": "user_id",
24660
"in": "query"
24661
},
24746
"all",
24747
"user"
24748
],
24750
- "description": "[EXPERIMENTAL] Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
24751
- "example": "all",
24752
- "x-experimental": true
24749
+ "description": "Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
24750
+ "example": "all"
24751
},
24752
"auth_schemes": {
24753
"type": "array",
25086
},
25087
"/api/v3.1/custom/toolkits/upsert": {
25088
"post": {
25091
- "summary": "Upsert a custom toolkit",
25092
- "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. mcp_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).",
25089
+ "summary": "Upsert a custom toolkit (DEPRECATED)",
25090
+ "description": "DEPRECATED: use POST /api/v3.1/custom/toolkits to create a toolkit and PATCH /api/v3.1/custom/toolkits/{slug} to update it. 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. mcp_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).",
25091
+ "deprecated": true,
25092
"tags": [
25093
"Toolkits"
25094
],
25392
"/api/v3.1/custom/toolkits/sync": {
25393
"post": {
25394
"summary": "Sync a custom toolkit",
25396
- "description": "Experimental: custom toolkits are in pilot and this contract may change. Re-fetches tool definitions from the remote MCP server for the custom toolkit with the provided slug. Call it when automatic sync fails or the remote tool definitions change.",
25395
+ "description": "Re-fetches tool definitions from the remote MCP server for the custom toolkit with the provided slug. Call it when automatic sync fails or the remote tool definitions change.",
25396
"tags": [
25397
"Toolkits"
25398
],
25621
"all",
25622
"user"
25623
],
25625
- "description": "[EXPERIMENTAL] Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
25626
- "example": "all",
25627
- "x-experimental": true
25624
+ "description": "Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
25625
+ "example": "all"
25626
},
25627
"composio_managed_auth_schemes": {
25628
"type": "array",
26340
"all",
26341
"user"
26342
],
26345
- "description": "[EXPERIMENTAL] Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
26346
- "example": "all",
26347
- "x-experimental": true
26343
+ "description": "Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
26344
+ "example": "all"
26345
},
26346
"auth_schemes": {
26347
"type": "array",
32928
"type": "string",
32929
"minLength": 1,
32930
"maxLength": 256,
32934
- "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
32935
- "example": "user_123",
32936
- "x-experimental": true
32931
+ "description": "Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
32932
+ "example": "user_123"
32933
},
32934
"required": false,
32939
- "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
32935
+ "description": "Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
32936
"name": "user_id",
32937
"in": "query"
32938
}