@devries-cameron20 / composio Mirror · read-only / commits / 900bbb390
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 09:45 UTC

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": {