@devries-cameron20 / composio-1 / commits / dfd1e44a0
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.

docs: update toolkits, API spec, and meta tools data (#5307)

## Summary Automated sync of backend data into the docs site. - Trigger: `schedule` - Dispatch action: `n/a` - Source commit: `n/a` ## What changed - **Toolkit catalog** (`docs/public/data/toolkits.json`, `toolkits-list.json`) — refreshed list of available toolkits, auth schemes, and tools from the backend API - **OpenAPI specs** (`docs/public/openapi.json`, `docs/public/openapi-v3.json`, `docs/public/openapi-webhooks.json`) — latest v3.1 and v3.0 API specifications plus the webhook-events spec, fetched from production - **API reference pages** (`docs/content/reference/api-reference/`, `docs/content/reference/v3/api-reference/`) — regenerated index pages for both API versions - **Meta tools reference** (`docs/public/data/meta-tools.json`, `docs/content/toolkits/meta-tools/*.mdx`) — updated meta tool schemas and reference docs Co-authored-by: Sushmithamallesh <19796925+Sushmithamallesh@users.noreply.github.com>

sdkrelease[bot] committed Nov 11, 2026 at 03:34 UTC dfd1e44a001ea4b5e6198f906f2b2b69117a60b8
4 files changed +37 -45
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":"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 (DEPRECATED)","href":"/reference/api-reference/toolkits/postCustomToolkitsUpsert","legacy":true},{"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/content/reference/v3/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":"GET","pathV31":"/api/v3.1/toolkits","pathV3":"/api/v3/toolkits","summary":"List available toolkits","href":"/reference/v3/api-reference/toolkits/getToolkits"},{"method":"GET","pathV31":"/api/v3.1/toolkits/categories","pathV3":"/api/v3/toolkits/categories","summary":"List toolkit categories","href":"/reference/v3/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/v3/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/v3/api-reference/toolkits/postCustomToolkitsSync"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{slug}","pathV3":"/api/v3/toolkits/{slug}","summary":"Get toolkit by slug","href":"/reference/v3/api-reference/toolkits/getToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/multi","pathV3":"/api/v3/toolkits/multi","summary":"Fetch multiple toolkits","href":"/reference/v3/api-reference/toolkits/postToolkitsMulti"},{"method":"GET","pathV31":"/api/v3.1/toolkits/changelog","pathV3":"/api/v3/toolkits/changelog","summary":"Get toolkits changelog","href":"/reference/v3/api-reference/toolkits/getToolkitsChangelog"}]} />
28 +<ApiEndpointsTable endpoints={[{"method":"GET","pathV31":"/api/v3.1/toolkits","pathV3":"/api/v3/toolkits","summary":"List available toolkits","href":"/reference/v3/api-reference/toolkits/getToolkits"},{"method":"GET","pathV31":"/api/v3.1/toolkits/categories","pathV3":"/api/v3/toolkits/categories","summary":"List toolkit categories","href":"/reference/v3/api-reference/toolkits/getToolkitsCategories"},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/upsert","pathV3":"/api/v3/custom/toolkits/upsert","summary":"Upsert a custom toolkit (DEPRECATED)","href":"/reference/v3/api-reference/toolkits/postCustomToolkitsUpsert","legacy":true},{"method":"POST","pathV31":"/api/v3.1/custom/toolkits/sync","pathV3":"/api/v3/custom/toolkits/sync","summary":"Sync a custom toolkit","href":"/reference/v3/api-reference/toolkits/postCustomToolkitsSync"},{"method":"GET","pathV31":"/api/v3.1/toolkits/{slug}","pathV3":"/api/v3/toolkits/{slug}","summary":"Get toolkit by slug","href":"/reference/v3/api-reference/toolkits/getToolkitsBySlug"},{"method":"POST","pathV31":"/api/v3.1/toolkits/multi","pathV3":"/api/v3/toolkits/multi","summary":"Fetch multiple toolkits","href":"/reference/v3/api-reference/toolkits/postToolkitsMulti"},{"method":"GET","pathV31":"/api/v3.1/toolkits/changelog","pathV3":"/api/v3/toolkits/changelog","summary":"Get toolkits changelog","href":"/reference/v3/api-reference/toolkits/getToolkitsChangelog"}]} />
docs/public/openapi-v3.json
+16 -20
@@ -9550,12 +9550,11 @@
9550 "type": "string",
9551 "minLength": 1,
9552 "maxLength": 256,
9553 - "description": "[EXPERIMENTAL] List the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are listed.",
9554 - "example": "user_123",
9555 - "x-experimental": true
9553 + "description": "List the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are listed.",
9554 + "example": "user_123"
9555 },
9556 "required": false,
9558 - "description": "[EXPERIMENTAL] List the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are listed.",
9557 + "description": "List the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are listed.",
9558 "name": "user_id",
9559 "in": "query"
9560 },
@@ -9646,9 +9645,8 @@
9645 "all",
9646 "user"
9647 ],
9649 - "description": "[EXPERIMENTAL] Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
9650 - "example": "all",
9651 - "x-experimental": true
9648 + "description": "Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
9649 + "example": "all"
9650 },
9651 "auth_schemes": {
9652 "type": "array",
@@ -9987,8 +9985,9 @@
9985 },
9986 "/api/v3/custom/toolkits/upsert": {
9987 "post": {
9990 - "summary": "Upsert a custom toolkit",
9991 - "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).",
9988 + "summary": "Upsert a custom toolkit (DEPRECATED)",
9989 + "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).",
9990 + "deprecated": true,
9991 "tags": [
9992 "Toolkits"
9993 ],
@@ -10292,7 +10291,7 @@
10291 "/api/v3/custom/toolkits/sync": {
10292 "post": {
10293 "summary": "Sync a custom toolkit",
10295 - "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.",
10294 + "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.",
10295 "tags": [
10296 "Toolkits"
10297 ],
@@ -10521,9 +10520,8 @@
10520 "all",
10521 "user"
10522 ],
10524 - "description": "[EXPERIMENTAL] Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
10525 - "example": "all",
10526 - "x-experimental": true
10523 + "description": "Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
10524 + "example": "all"
10525 },
10526 "composio_managed_auth_schemes": {
10527 "type": "array",
@@ -11729,9 +11727,8 @@
11727 "all",
11728 "user"
11729 ],
11732 - "description": "[EXPERIMENTAL] Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
11733 - "example": "all",
11734 - "x-experimental": true
11730 + "description": "Custom toolkits only. \"all\": every user in the project can use it. \"user\": only the user it was created for can.",
11731 + "example": "all"
11732 },
11733 "auth_schemes": {
11734 "type": "array",
@@ -26319,12 +26316,11 @@
26316 "type": "string",
26317 "minLength": 1,
26318 "maxLength": 256,
26322 - "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
26323 - "example": "user_123",
26324 - "x-experimental": true
26319 + "description": "Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
26320 + "example": "user_123"
26321 },
26322 "required": false,
26327 - "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
26323 + "description": "Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
26324 "name": "user_id",
26325 "in": "query"
26326 }
docs/public/openapi.json
+19 -23
@@ -6515,7 +6515,7 @@
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,7 +6850,7 @@
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,7 +7013,7 @@
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,12 +24651,11 @@
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 },
@@ -24747,9 +24746,8 @@
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",
@@ -25088,8 +25086,9 @@
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 ],
@@ -25393,7 +25392,7 @@
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 ],
@@ -25622,9 +25621,8 @@
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",
@@ -26342,9 +26340,8 @@
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",
@@ -32931,12 +32928,11 @@
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 }