@devries-cameron20 / composio Mirror · read-only / commits / 5c337af92
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 22, 13:15 UTC

fix: remove CookieAuth and add missing ignored path to OpenAPI filter

- Add /api/v3/labs/tool_router/session to IGNORED_PATHS - Remove CookieAuth from securitySchemes - Remove CookieAuth from all endpoint security arrays - Mirrors filtering done in fern/apis/openapi-overrides.yml Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Sushmithamallesh committed Jan 26, 2026 at 18:53 UTC 5c337af92e6aa25a2a99567f462be47d926ae5d5
2 files changed +511 -590
docs/public/openapi.json
+485 -590
@@ -110,12 +110,6 @@
110 "name": "x-api-key",
111 "description": "API key authentication"
112 },
113 - "CookieAuth": {
114 - "type": "apiKey",
115 - "in": "cookie",
116 - "name": "authToken",
117 - "description": "Cookie-based session authentication"
118 - },
113 "OrgApiKeyAuth": {
114 "type": "apiKey",
115 "in": "header",
@@ -136,6 +130,9 @@
130 "code": {
131 "type": "number"
132 },
133 + "slug": {
134 + "type": "string"
135 + },
136 "status": {
137 "type": "number"
138 },
@@ -155,6 +152,7 @@
152 "required": [
153 "message",
154 "code",
155 + "slug",
156 "status"
157 ]
158 }
@@ -312,6 +310,11 @@
310 "devops"
311 ]
312 },
313 + "status": {
314 + "type": "string",
315 + "description": "Lifecycle status of the tool",
316 + "example": "active"
317 + },
318 "is_deprecated": {
319 "type": "boolean",
320 "description": "Indicates if this tool is deprecated and may be removed in the future",
@@ -381,6 +384,7 @@
384 "output_parameters",
385 "scopes",
386 "tags",
387 + "status",
388 "is_deprecated",
389 "deprecated"
390 ]
@@ -568,9 +572,6 @@
572 "security": [
573 {
574 "ApiKeyAuth": []
571 - },
572 - {
573 - "CookieAuth": []
575 }
576 ],
577 "responses": {
@@ -907,9 +908,6 @@
908 "security": [
909 {
910 "ApiKeyAuth": []
910 - },
911 - {
912 - "CookieAuth": []
911 }
912 ],
913 "requestBody": {
@@ -1004,7 +1002,12 @@
1002 "additionalProperties": {
1003 "nullable": true
1004 },
1007 - "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config"
1005 + "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config",
1006 + "x-experimental": true
1007 + },
1008 + "is_enabled_for_tool_router": {
1009 + "type": "boolean",
1010 + "description": "Whether this auth config is enabled for tool router"
1011 }
1012 },
1013 "required": [
@@ -1076,6 +1079,7 @@
1079 },
1080 "proxy_config": {
1081 "type": "object",
1082 + "nullable": true,
1083 "properties": {
1084 "proxy_url": {
1085 "type": "string",
@@ -1118,7 +1122,12 @@
1122 "additionalProperties": {
1123 "nullable": true
1124 },
1121 - "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config"
1125 + "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config",
1126 + "x-experimental": true
1127 + },
1128 + "is_enabled_for_tool_router": {
1129 + "type": "boolean",
1130 + "description": "Whether this auth config is enabled for tool router"
1131 }
1132 },
1133 "required": [
@@ -1252,9 +1261,6 @@
1261 "security": [
1262 {
1263 "ApiKeyAuth": []
1255 - },
1256 - {
1257 - "CookieAuth": []
1264 }
1265 ],
1266 "parameters": [
@@ -1431,6 +1437,7 @@
1437 },
1438 "proxy_config": {
1439 "type": "object",
1440 + "nullable": true,
1441 "properties": {
1442 "proxy_url": {
1443 "type": "string",
@@ -1511,7 +1518,12 @@
1518 "additionalProperties": {
1519 "nullable": true
1520 },
1514 - "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config"
1521 + "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config",
1522 + "x-experimental": true
1523 + },
1524 + "is_enabled_for_tool_router": {
1525 + "type": "boolean",
1526 + "description": "Whether this auth config is enabled for tool router"
1527 },
1528 "deprecated_params": {
1529 "type": "object",
@@ -1637,9 +1649,6 @@
1649 "security": [
1650 {
1651 "ApiKeyAuth": []
1640 - },
1641 - {
1642 - "CookieAuth": []
1652 }
1653 ],
1654 "parameters": [
@@ -1734,6 +1743,7 @@
1743 },
1744 "proxy_config": {
1745 "type": "object",
1746 + "nullable": true,
1747 "properties": {
1748 "proxy_url": {
1749 "type": "string",
@@ -1814,7 +1824,12 @@
1824 "additionalProperties": {
1825 "nullable": true
1826 },
1817 - "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config"
1827 + "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config",
1828 + "x-experimental": true
1829 + },
1830 + "is_enabled_for_tool_router": {
1831 + "type": "boolean",
1832 + "description": "Whether this auth config is enabled for tool router"
1833 },
1834 "deprecated_params": {
1835 "type": "object",
@@ -1916,9 +1931,6 @@
1931 "security": [
1932 {
1933 "ApiKeyAuth": []
1919 - },
1920 - {
1921 - "CookieAuth": []
1934 }
1935 ],
1936 "parameters": [
@@ -1981,6 +1993,7 @@
1993 },
1994 "proxy_config": {
1995 "type": "object",
1996 + "nullable": true,
1997 "properties": {
1998 "proxy_url": {
1999 "type": "string",
@@ -2001,7 +2014,6 @@
2014 "items": {
2015 "type": "string"
2016 },
2004 - "default": [],
2017 "description": "Use tool_access_config instead. This field will be deprecated in the future.",
2018 "deprecated": true
2019 },
@@ -2013,7 +2025,6 @@
2025 "items": {
2026 "type": "string"
2027 },
2016 - "default": [],
2028 "description": "Tools used to generate the minimum required scopes for the auth config (only valid for OAuth). If passed, this will update the scopes."
2029 },
2030 "tools_available_for_execution": {
@@ -2021,7 +2032,6 @@
2032 "items": {
2033 "type": "string"
2034 },
2024 - "default": [],
2035 "description": "The actions that the user can perform on the auth config. If passed, this will update the actions that the user can perform on the auth config."
2036 }
2037 }
@@ -2032,11 +2042,14 @@
2042 "nullable": true
2043 },
2044 "description": "Shared credentials that will be inherited by connected accounts. For eg: this can be used to share the API key for a tool with all connected accounts using this auth config."
2045 + },
2046 + "is_enabled_for_tool_router": {
2047 + "type": "boolean",
2048 + "description": "Whether this auth config is enabled for tool router"
2049 }
2050 },
2051 "required": [
2038 - "type",
2039 - "credentials"
2052 + "type"
2053 ]
2054 },
2055 {
@@ -2066,7 +2079,6 @@
2079 "items": {
2080 "type": "string"
2081 },
2069 - "default": [],
2082 "description": "Use tool_access_config instead. This field will be deprecated in the future.",
2083 "deprecated": true
2084 },
@@ -2078,7 +2090,6 @@
2090 "items": {
2091 "type": "string"
2092 },
2081 - "default": [],
2093 "description": "Tools used to generate the minimum required scopes for the auth config (only valid for OAuth). If passed, this will update the scopes."
2094 },
2095 "tools_available_for_execution": {
@@ -2086,7 +2097,6 @@
2097 "items": {
2098 "type": "string"
2099 },
2089 - "default": [],
2100 "description": "The actions that the user can perform on the auth config. If passed, this will update the actions that the user can perform on the auth config."
2101 }
2102 }
@@ -2097,6 +2107,10 @@
2107 "nullable": true
2108 },
2109 "description": "Shared credentials that will be inherited by connected accounts. For eg: this can be used to share the API key for a tool with all connected accounts using this auth config."
2110 + },
2111 + "is_enabled_for_tool_router": {
2112 + "type": "boolean",
2113 + "description": "Whether this auth config is enabled for tool router"
2114 }
2115 },
2116 "required": [
@@ -2189,9 +2203,6 @@
2203 "security": [
2204 {
2205 "ApiKeyAuth": []
2192 - },
2193 - {
2194 - "CookieAuth": []
2206 }
2207 ],
2208 "parameters": [
@@ -2274,9 +2285,6 @@
2285 "security": [
2286 {
2287 "ApiKeyAuth": []
2277 - },
2278 - {
2279 - "CookieAuth": []
2288 }
2289 ],
2290 "parameters": [
@@ -2371,9 +2379,6 @@
2379 "security": [
2380 {
2381 "ApiKeyAuth": []
2374 - },
2375 - {
2376 - "CookieAuth": []
2382 }
2383 ],
2384 "parameters": [
@@ -9315,9 +9320,6 @@
9320 "security": [
9321 {
9322 "ApiKeyAuth": []
9318 - },
9319 - {
9320 - "CookieAuth": []
9323 }
9324 ],
9325 "requestBody": {
@@ -15925,7 +15927,8 @@
15927 "validate_credentials": {
15928 "type": "boolean",
15929 "default": false,
15928 - "description": "[EXPERIMENTAL] Whether to validate the provided credentials, validates only for API Key Auth scheme"
15930 + "description": "[EXPERIMENTAL] Whether to validate the provided credentials, validates only for API Key Auth scheme",
15931 + "x-experimental": true
15932 }
15933 },
15934 "required": [
@@ -22618,9 +22621,6 @@
22621 ],
22622 "operationId": "getConnectedAccountsByNanoid",
22623 "security": [
22621 - {
22622 - "CookieAuth": []
22623 - },
22624 {
22625 "ApiKeyAuth": []
22626 }
@@ -29434,9 +29434,6 @@
29434 ],
29435 "operationId": "deleteConnectedAccountsByNanoid",
29436 "security": [
29437 - {
29438 - "CookieAuth": []
29439 - },
29437 {
29438 "ApiKeyAuth": []
29439 }
@@ -29543,9 +29540,6 @@
29540 "security": [
29541 {
29542 "ApiKeyAuth": []
29546 - },
29547 - {
29548 - "CookieAuth": []
29543 }
29544 ],
29545 "parameters": [
@@ -29671,9 +29665,6 @@
29665 "security": [
29666 {
29667 "ApiKeyAuth": []
29674 - },
29675 - {
29676 - "CookieAuth": []
29668 }
29669 ],
29670 "parameters": [
@@ -29709,7 +29700,8 @@
29700 "validate_credentials": {
29701 "type": "boolean",
29702 "default": false,
29712 - "description": "[EXPERIMENTAL] Whether to validate the provided credentials, validates only for API Key Auth scheme"
29703 + "description": "[EXPERIMENTAL] Whether to validate the provided credentials, validates only for API Key Auth scheme",
29704 + "x-experimental": true
29705 }
29706 }
29707 }
@@ -29835,9 +29827,6 @@
29827 "security": [
29828 {
29829 "ApiKeyAuth": []
29838 - },
29839 - {
29840 - "CookieAuth": []
29830 }
29831 ],
29832 "requestBody": {
@@ -35716,9 +35705,6 @@
35705 ],
35706 "operationId": "getOrgProjectConfig",
35707 "security": [
35719 - {
35720 - "CookieAuth": []
35721 - },
35708 {
35709 "ApiKeyAuth": []
35710 }
@@ -35752,6 +35738,15 @@
35738 },
35739 "require_mcp_api_key": {
35740 "type": "boolean"
35741 + },
35742 + "is_composio_link_enabled_for_managed_auth": {
35743 + "type": "boolean",
35744 + "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."
35745 + },
35746 + "signed_url_file_expiry_in_seconds": {
35747 + "type": "number",
35748 + "minimum": 1,
35749 + "maximum": 86400
35750 }
35751 },
35752 "required": [
@@ -35813,9 +35808,6 @@
35808 ],
35809 "operationId": "patchOrgProjectConfig",
35810 "security": [
35816 - {
35817 - "CookieAuth": []
35818 - },
35811 {
35812 "ApiKeyAuth": []
35813 }
@@ -35847,6 +35839,15 @@
35839 },
35840 "require_mcp_api_key": {
35841 "type": "boolean"
35842 + },
35843 + "is_composio_link_enabled_for_managed_auth": {
35844 + "type": "boolean",
35845 + "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."
35846 + },
35847 + "signed_url_file_expiry_in_seconds": {
35848 + "type": "number",
35849 + "minimum": 1,
35850 + "maximum": 86400
35851 }
35852 }
35853 },
@@ -35894,6 +35895,15 @@
35895 },
35896 "require_mcp_api_key": {
35897 "type": "boolean"
35898 + },
35899 + "is_composio_link_enabled_for_managed_auth": {
35900 + "type": "boolean",
35901 + "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."
35902 + },
35903 + "signed_url_file_expiry_in_seconds": {
35904 + "type": "number",
35905 + "minimum": 1,
35906 + "maximum": 86400
35907 }
35908 },
35909 "required": [
@@ -36005,6 +36015,15 @@
36015 },
36016 "require_mcp_api_key": {
36017 "type": "boolean"
36018 + },
36019 + "is_composio_link_enabled_for_managed_auth": {
36020 + "type": "boolean",
36021 + "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."
36022 + },
36023 + "signed_url_file_expiry_in_seconds": {
36024 + "type": "number",
36025 + "minimum": 1,
36026 + "maximum": 86400
36027 }
36028 },
36029 "required": [
@@ -36496,6 +36515,16 @@
36515 }
36516 }
36517 },
36518 + "404": {
36519 + "description": "Not found. The specified project does not exist or you do not have access to it.",
36520 + "content": {
36521 + "application/json": {
36522 + "schema": {
36523 + "$ref": "#/components/schemas/Error"
36524 + }
36525 + }
36526 + }
36527 + },
36528 "500": {
36529 "description": "Internal server error. An unexpected error occurred while processing the request.",
36530 "content": {
@@ -36589,6 +36618,16 @@
36618 }
36619 }
36620 },
36621 + "404": {
36622 + "description": "Not found. The specified project does not exist or has already been deleted.",
36623 + "content": {
36624 + "application/json": {
36625 + "schema": {
36626 + "$ref": "#/components/schemas/Error"
36627 + }
36628 + }
36629 + }
36630 + },
36631 "500": {
36632 "description": "Internal server error. An unexpected error occurred while processing the request.",
36633 "content": {
@@ -36703,6 +36742,16 @@
36742 }
36743 }
36744 },
36745 + "404": {
36746 + "description": "Not found. The specified project does not exist or you do not have access to it.",
36747 + "content": {
36748 + "application/json": {
36749 + "schema": {
36750 + "$ref": "#/components/schemas/Error"
36751 + }
36752 + }
36753 + }
36754 + },
36755 "500": {
36756 "description": "Internal server error. An unexpected error occurred while processing the request.",
36757 "content": {
@@ -36727,9 +36776,6 @@
36776 "security": [
36777 {
36778 "ApiKeyAuth": []
36730 - },
36731 - {
36732 - "CookieAuth": []
36779 }
36780 ],
36781 "parameters": [
@@ -36872,6 +36918,11 @@
36918 "description": "When true, this toolkit can be used without authentication",
36919 "example": false
36920 },
36921 + "status": {
36922 + "type": "string",
36923 + "description": "Lifecycle status of the toolkit",
36924 + "example": "active"
36925 + },
36926 "deprecated": {
36927 "$ref": "#/components/schemas/DeprecatedToolkitInfo"
36928 },
@@ -36970,6 +37021,7 @@
37021 "slug",
37022 "name",
37023 "is_local_toolkit",
37024 + "status",
37025 "deprecated",
37026 "meta"
37027 ],
@@ -37054,9 +37106,6 @@
37106 "security": [
37107 {
37108 "ApiKeyAuth": []
37057 - },
37058 - {
37059 - "CookieAuth": []
37109 }
37110 ],
37111 "responses": {
@@ -37168,9 +37217,6 @@
37217 "security": [
37218 {
37219 "ApiKeyAuth": []
37171 - },
37172 - {
37173 - "CookieAuth": []
37220 }
37221 ],
37222 "parameters": [
@@ -37221,6 +37267,11 @@
37267 "description": "Indicates if this toolkit is currently enabled and available for use",
37268 "example": true
37269 },
37270 + "status": {
37271 + "type": "string",
37272 + "description": "Lifecycle status of the toolkit",
37273 + "example": "active"
37274 + },
37275 "composio_managed_auth_schemes": {
37276 "type": "array",
37277 "items": {
@@ -37578,6 +37629,11 @@
37629 "type": "string",
37630 "description": "Endpoint to get the current user"
37631 },
37632 + "get_current_user_endpoint_method": {
37633 + "type": "string",
37634 + "description": "HTTP method to use when calling the get current user endpoint (e.g., GET, POST)",
37635 + "example": "GET"
37636 + },
37637 "deprecated": {
37638 "type": "object",
37639 "properties": {
@@ -37607,6 +37663,7 @@
37663 "slug",
37664 "name",
37665 "enabled",
37666 + "status",
37667 "is_local_toolkit",
37668 "meta",
37669 "deprecated"
@@ -37670,9 +37727,6 @@
37727 "security": [
37728 {
37729 "ApiKeyAuth": []
37673 - },
37674 - {
37675 - "CookieAuth": []
37730 }
37731 ],
37732 "parameters": [
@@ -37913,9 +37967,6 @@
37967 "security": [
37968 {
37969 "ApiKeyAuth": []
37916 - },
37917 - {
37918 - "CookieAuth": []
37970 }
37971 ],
37972 "responses": {
@@ -37997,9 +38048,6 @@
38048 "security": [
38049 {
38050 "ApiKeyAuth": []
38000 - },
38001 - {
38002 - "CookieAuth": []
38051 }
38052 ],
38053 "parameters": [
@@ -38125,9 +38173,6 @@
38173 "security": [
38174 {
38175 "ApiKeyAuth": []
38128 - },
38129 - {
38130 - "CookieAuth": []
38176 }
38177 ],
38178 "requestBody": {
@@ -38238,6 +38283,11 @@
38283 "description": "When true, this toolkit can be used without authentication",
38284 "example": false
38285 },
38286 + "status": {
38287 + "type": "string",
38288 + "description": "Lifecycle status of the toolkit",
38289 + "example": "active"
38290 + },
38291 "deprecated": {
38292 "$ref": "#/components/schemas/DeprecatedToolkitInfo"
38293 },
@@ -38336,6 +38386,7 @@
38386 "slug",
38387 "name",
38388 "is_local_toolkit",
38389 + "status",
38390 "deprecated",
38391 "meta"
38392 ],
@@ -38420,9 +38471,6 @@
38471 "security": [
38472 {
38473 "ApiKeyAuth": []
38423 - },
38424 - {
38425 - "CookieAuth": []
38474 }
38475 ],
38476 "parameters": [
@@ -39820,6 +39868,16 @@
39868 }
39869 }
39870 },
39871 + "413": {
39872 + "description": "Payload too large - Request or response payload exceeds size limits",
39873 + "content": {
39874 + "application/json": {
39875 + "schema": {
39876 + "$ref": "#/components/schemas/Error"
39877 + }
39878 + }
39879 + }
39880 + },
39881 "422": {
39882 "description": "Unprocessable entity - Invalid state of the connected account",
39883 "content": {
@@ -39894,9 +39952,6 @@
39952 "security": [
39953 {
39954 "ApiKeyAuth": []
39897 - },
39898 - {
39899 - "CookieAuth": []
39955 }
39956 ],
39957 "parameters": [
@@ -40051,9 +40106,6 @@
40106 "security": [
40107 {
40108 "ApiKeyAuth": []
40054 - },
40055 - {
40056 - "CookieAuth": []
40109 }
40110 ],
40111 "requestBody": {
@@ -40131,7 +40183,7 @@
40183 ]
40184 }
40185 ],
40134 - "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", contentType?: \"...\"}. For binary upload via base64: use {base64: \"...\", contentType?: \"...\"}."
40186 + "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", content_type?: \"...\"}. For binary upload via base64: use {base64: \"...\", content_type?: \"...\"}."
40187 },
40188 "parameters": {
40189 "type": "array",
@@ -41520,19 +41572,16 @@
41572 "security": [
41573 {
41574 "ApiKeyAuth": []
41523 - },
41524 - {
41525 - "CookieAuth": []
41575 }
41576 ],
41577 "parameters": [
41578 {
41579 "schema": {
41580 "type": "string",
41532 - "description": "The slug of the trigger instance"
41581 + "description": "The slug of the trigger instance. Case-insensitive (internally normalized to uppercase)."
41582 },
41583 "required": true,
41535 - "description": "The slug of the trigger instance",
41584 + "description": "The slug of the trigger instance. Case-insensitive (internally normalized to uppercase).",
41585 "name": "slug",
41586 "in": "path"
41587 }
@@ -41600,7 +41649,39 @@
41649 },
41650 "responses": {
41651 "200": {
41603 - "description": "Successfully updated trigger instance",
41652 + "description": "Successfully upserted trigger instance",
41653 + "content": {
41654 + "application/json": {
41655 + "schema": {
41656 + "type": "object",
41657 + "properties": {
41658 + "trigger_id": {
41659 + "type": "string",
41660 + "description": "ID of the updated trigger"
41661 + },
41662 + "deprecated": {
41663 + "type": "object",
41664 + "properties": {
41665 + "uuid": {
41666 + "type": "string",
41667 + "description": "ID of the updated trigger"
41668 + }
41669 + },
41670 + "required": [
41671 + "uuid"
41672 + ]
41673 + }
41674 + },
41675 + "required": [
41676 + "trigger_id",
41677 + "deprecated"
41678 + ]
41679 + }
41680 + }
41681 + }
41682 + },
41683 + "201": {
41684 + "description": "Successfully created trigger instance",
41685 "content": {
41686 "application/json": {
41687 "schema": {
@@ -41724,12 +41805,23 @@
41805 "security": [
41806 {
41807 "ApiKeyAuth": []
41727 - },
41728 - {
41729 - "CookieAuth": []
41808 }
41809 ],
41810 "parameters": [
41811 + {
41812 + "schema": {
41813 + "type": "array",
41814 + "nullable": true,
41815 + "items": {
41816 + "type": "string"
41817 + },
41818 + "description": "Array of user IDs to filter triggers by"
41819 + },
41820 + "required": false,
41821 + "description": "Array of user IDs to filter triggers by",
41822 + "name": "user_ids",
41823 + "in": "query"
41824 + },
41825 {
41826 "schema": {
41827 "type": "array",
@@ -41782,10 +41874,10 @@
41874 "items": {
41875 "type": "string"
41876 },
41785 - "description": "Array of trigger names to filter triggers by"
41877 + "description": "Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase)."
41878 },
41879 "required": false,
41788 - "description": "Array of trigger names to filter triggers by",
41880 + "description": "Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase).",
41881 "name": "trigger_names",
41882 "in": "query"
41883 },
@@ -41860,18 +41952,6 @@
41952 "name": "triggerNames",
41953 "in": "query"
41954 },
41863 - {
41864 - "schema": {
41865 - "type": "number",
41866 - "minimum": 1,
41867 - "default": 1,
41868 - "description": "Page number for pagination. Starts from 1."
41869 - },
41870 - "required": false,
41871 - "description": "Page number for pagination. Starts from 1.",
41872 - "name": "page",
41873 - "in": "query"
41874 - },
41955 {
41956 "schema": {
41957 "type": "boolean",
@@ -42003,7 +42083,8 @@
42083 "disabledAt": {
42084 "type": "string",
42085 "nullable": true,
42006 - "description": "ID of the user who disabled the trigger instance, if applicable"
42086 + "description": "DEPRECATED: This parameter will be removed in a future version. Please use disabled_at instead.",
42087 + "deprecated": true
42088 },
42089 "connectedAccountId": {
42090 "type": "string",
@@ -42126,9 +42207,6 @@
42207 "security": [
42208 {
42209 "ApiKeyAuth": []
42129 - },
42130 - {
42131 - "CookieAuth": []
42210 }
42211 ],
42212 "parameters": [
@@ -42235,9 +42313,6 @@
42313 "security": [
42314 {
42315 "ApiKeyAuth": []
42238 - },
42239 - {
42240 - "CookieAuth": []
42316 }
42317 ],
42318 "parameters": [
@@ -42379,9 +42454,6 @@
42454 ],
42455 "operationId": "getTriggersTypesListEnum",
42456 "security": [
42382 - {
42383 - "CookieAuth": []
42384 - },
42457 {
42458 "ApiKeyAuth": []
42459 }
@@ -42455,20 +42527,17 @@
42527 "security": [
42528 {
42529 "ApiKeyAuth": []
42458 - },
42459 - {
42460 - "CookieAuth": []
42530 }
42531 ],
42532 "parameters": [
42533 {
42534 "schema": {
42535 "type": "string",
42467 - "description": "The unique slug identifier for the trigger type",
42536 + "description": "The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).",
42537 "example": "SLACK_NEW_MESSAGE"
42538 },
42539 "required": true,
42471 - "description": "The unique slug identifier for the trigger type",
42540 + "description": "The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).",
42541 "name": "slug",
42542 "in": "path"
42543 },
@@ -42619,6 +42688,11 @@
42688 "type": "string",
42689 "description": "Version of the trigger type",
42690 "example": "20250930_00"
42691 + },
42692 + "status": {
42693 + "type": "string",
42694 + "description": "Lifecycle status of the trigger",
42695 + "example": "active"
42696 }
42697 },
42698 "required": [
@@ -42630,7 +42704,8 @@
42704 "toolkit",
42705 "config",
42706 "payload",
42633 - "version"
42707 + "version",
42708 + "status"
42709 ]
42710 }
42711 }
@@ -42690,9 +42765,6 @@
42765 "security": [
42766 {
42767 "ApiKeyAuth": []
42693 - },
42694 - {
42695 - "CookieAuth": []
42768 }
42769 ],
42770 "parameters": [
@@ -42885,6 +42957,11 @@
42957 "type": "string",
42958 "description": "Version of the trigger type",
42959 "example": "20250930_00"
42960 + },
42961 + "status": {
42962 + "type": "string",
42963 + "description": "Lifecycle status of the trigger",
42964 + "example": "active"
42965 }
42966 },
42967 "required": [
@@ -42896,7 +42973,8 @@
42973 "toolkit",
42974 "config",
42975 "payload",
42899 - "version"
42976 + "version",
42977 + "status"
42978 ]
42979 }
42980 },
@@ -42978,9 +43056,6 @@
43056 "security": [
43057 {
43058 "ApiKeyAuth": []
42981 - },
42982 - {
42983 - "CookieAuth": []
43059 }
43060 ],
43061 "parameters": [
@@ -43324,9 +43399,6 @@
43399 "security": [
43400 {
43401 "ApiKeyAuth": []
43327 - },
43328 - {
43329 - "CookieAuth": []
43402 }
43403 ],
43404 "requestBody": {
@@ -43628,9 +43700,6 @@
43700 "security": [
43701 {
43702 "ApiKeyAuth": []
43631 - },
43632 - {
43633 - "CookieAuth": []
43703 }
43704 ],
43705 "requestBody": {
@@ -43870,9 +43939,6 @@
43939 "security": [
43940 {
43941 "ApiKeyAuth": []
43873 - },
43874 - {
43875 - "CookieAuth": []
43942 }
43943 ],
43944 "requestBody": {
@@ -44062,9 +44128,6 @@
44128 "security": [
44129 {
44130 "ApiKeyAuth": []
44065 - },
44066 - {
44067 - "CookieAuth": []
44131 }
44132 ],
44133 "parameters": [
@@ -44288,9 +44351,6 @@
44351 "security": [
44352 {
44353 "ApiKeyAuth": []
44291 - },
44292 - {
44293 - "CookieAuth": []
44354 }
44355 ],
44356 "parameters": [
@@ -44629,9 +44689,6 @@
44689 "security": [
44690 {
44691 "ApiKeyAuth": []
44632 - },
44633 - {
44634 - "CookieAuth": []
44692 }
44693 ],
44694 "parameters": [
@@ -44740,9 +44797,6 @@
44797 "security": [
44798 {
44799 "ApiKeyAuth": []
44743 - },
44744 - {
44745 - "CookieAuth": []
44800 }
44801 ],
44802 "parameters": [
@@ -45109,9 +45163,6 @@
45163 "security": [
45164 {
45165 "ApiKeyAuth": []
45112 - },
45113 - {
45114 - "CookieAuth": []
45166 }
45167 ],
45168 "parameters": [
@@ -45340,9 +45391,6 @@
45391 "security": [
45392 {
45393 "ApiKeyAuth": []
45343 - },
45344 - {
45345 - "CookieAuth": []
45394 }
45395 ],
45396 "parameters": [
@@ -45506,9 +45554,6 @@
45554 "security": [
45555 {
45556 "ApiKeyAuth": []
45509 - },
45510 - {
45511 - "CookieAuth": []
45557 }
45558 ],
45559 "parameters": [
@@ -45612,9 +45657,6 @@
45657 "security": [
45658 {
45659 "ApiKeyAuth": []
45615 - },
45616 - {
45617 - "CookieAuth": []
45660 }
45661 ],
45662 "parameters": [
@@ -45745,6 +45787,16 @@
45787 }
45788 }
45789 },
45790 + "404": {
45791 + "description": "Not found",
45792 + "content": {
45793 + "application/json": {
45794 + "schema": {
45795 + "$ref": "#/components/schemas/Error"
45796 + }
45797 + }
45798 + }
45799 + },
45800 "500": {
45801 "description": "Internal server error",
45802 "content": {
@@ -45769,9 +45821,6 @@
45821 "security": [
45822 {
45823 "ApiKeyAuth": []
45772 - },
45773 - {
45774 - "CookieAuth": []
45824 }
45825 ],
45826 "requestBody": {
@@ -45782,23 +45831,23 @@
45831 "properties": {
45832 "toolkit_slug": {
45833 "type": "string",
45785 - "description": "Slug of the app where this file belongs to. Example: \"image-processing\""
45834 + "description": "Slug of the app where this file belongs to. Example: \"gmail\", \"slack\", \"github\""
45835 },
45836 "tool_slug": {
45837 "type": "string",
45789 - "description": "Slug of the action where this file belongs to. Example: \"resize-image\""
45838 + "description": "Slug of the action where this file belongs to. Example: \"GMAIL_SEND_EMAIL\", \"SLACK_UPLOAD_FILE\""
45839 },
45840 "filename": {
45841 "type": "string",
45793 - "description": "Name of the original file. Example: \"photo.jpg\""
45842 + "description": "Name of the original file. Example: \"quarterly_report.pdf\""
45843 },
45844 "mimetype": {
45845 "type": "string",
45797 - "description": "Mime type of the original file. Example: \"image/jpeg\""
45846 + "description": "Mime type of the original file. Example: \"application/pdf\", \"image/png\""
45847 },
45848 "md5": {
45849 "type": "string",
45801 - "description": "MD5 hash of the file for deduplication and integrity verification. Example: \"d41d8cd98f00b204e9800998ecf8427e\""
45850 + "description": "MD5 hash of the file for deduplication and integrity verification. Example: \"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6\""
45851 }
45852 },
45853 "required": [
@@ -45810,13 +45859,49 @@
45859 ]
45860 },
45861 "examples": {
45813 - "New Image File": {
45862 + "Gmail Email Attachment": {
45863 + "value": {
45864 + "toolkit_slug": "gmail",
45865 + "tool_slug": "GMAIL_SEND_EMAIL",
45866 + "filename": "quarterly_report.pdf",
45867 + "mimetype": "application/pdf",
45868 + "md5": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
45869 + }
45870 + },
45871 + "Slack File Upload": {
45872 "value": {
45815 - "toolkit_slug": "image-processing",
45816 - "tool_slug": "resize-image",
45817 - "filename": "photo.jpg",
45818 - "mimetype": "image/jpeg",
45819 - "md5": "d41d8cd98f00b204e9800998ecf8427e"
45873 + "toolkit_slug": "slack",
45874 + "tool_slug": "SLACK_UPLOAD_FILE",
45875 + "filename": "meeting_notes.docx",
45876 + "mimetype": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
45877 + "md5": "b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7"
45878 + }
45879 + },
45880 + "GitHub Issue Screenshot": {
45881 + "value": {
45882 + "toolkit_slug": "github",
45883 + "tool_slug": "GITHUB_CREATE_ISSUE",
45884 + "filename": "bug_screenshot.png",
45885 + "mimetype": "image/png",
45886 + "md5": "c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8"
45887 + }
45888 + },
45889 + "Notion Page Image": {
45890 + "value": {
45891 + "toolkit_slug": "notion",
45892 + "tool_slug": "NOTION_ADD_PAGE_CONTENT",
45893 + "filename": "diagram.svg",
45894 + "mimetype": "image/svg+xml",
45895 + "md5": "d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9"
45896 + }
45897 + },
45898 + "Jira Attachment": {
45899 + "value": {
45900 + "toolkit_slug": "jira",
45901 + "tool_slug": "JIRA_ADD_ATTACHMENT",
45902 + "filename": "error_logs.txt",
45903 + "mimetype": "text/plain",
45904 + "md5": "e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
45905 }
45906 }
45907 }
@@ -45829,163 +45914,57 @@
45914 "content": {
45915 "application/json": {
45916 "schema": {
45832 - "oneOf": [
45833 - {
45834 - "type": "object",
45835 - "properties": {
45836 - "id": {
45837 - "type": "string",
45838 - "description": "ID of the request file. Example: \"f1e2d3c4b5a6\""
45839 - },
45840 - "key": {
45841 - "type": "string",
45842 - "description": "S3 upload location. Example: \"projects/123/files/photo-1234.jpg\""
45843 - },
45844 - "existing_url": {
45845 - "type": "string",
45846 - "description": "URL of the existing request file. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg\""
45847 - },
45848 - "existingUrl": {
45849 - "type": "string",
45850 - "description": "[DEPRECATED] Use existing_url instead. URL of the existing request file. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg\""
45851 - },
45852 - "type": {
45853 - "type": "string",
45854 - "enum": [
45855 - "existing"
45856 - ],
45857 - "description": "Indicates the file already exists and does not need to be uploaded again"
45858 - },
45859 - "metadata": {
45860 - "type": "object",
45861 - "properties": {
45862 - "storage_backend": {
45863 - "type": "string",
45864 - "enum": [
45865 - "s3",
45866 - "azure_blob_storage"
45867 - ],
45868 - "description": "Storage backend used for the file. If this is azure, use `x-ms-blob-type` header to set the blob type to `BlockBlob` while uploading the file"
45869 - }
45870 - },
45871 - "required": [
45872 - "storage_backend"
45873 - ]
45874 - }
45875 - },
45876 - "required": [
45877 - "id",
45878 - "key",
45879 - "existing_url",
45880 - "existingUrl",
45881 - "type",
45882 - "metadata"
45883 - ]
45917 + "type": "object",
45918 + "properties": {
45919 + "id": {
45920 + "type": "string",
45921 + "description": "ID of the request file. Example: \"req_file_9mZn4qR8sXwT\""
45922 },
45885 - {
45886 - "type": "object",
45887 - "properties": {
45888 - "id": {
45889 - "type": "string",
45890 - "description": "ID of the request file. Example: \"f1e2d3c4b5a6\""
45891 - },
45892 - "key": {
45893 - "type": "string",
45894 - "description": "S3 upload location. Example: \"projects/123/files/photo-1234.jpg\""
45895 - },
45896 - "new_presigned_url": {
45897 - "type": "string",
45898 - "description": "Presigned URL for upload. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=...\""
45899 - },
45900 - "newPresignedUrl": {
45901 - "type": "string",
45902 - "description": "[DEPRECATED] Use new_presigned_url instead. Presigned URL for upload. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=...\""
45903 - },
45904 - "type": {
45905 - "type": "string",
45906 - "enum": [
45907 - "new"
45908 - ],
45909 - "description": "Indicates this is a new file that needs to be uploaded"
45910 - },
45911 - "metadata": {
45912 - "type": "object",
45913 - "properties": {
45914 - "storage_backend": {
45915 - "type": "string",
45916 - "enum": [
45917 - "s3",
45918 - "azure_blob_storage"
45919 - ],
45920 - "description": "Storage backend used for the file. If this is azure, use `x-ms-blob-type` header to set the blob type to `BlockBlob` while uploading the file"
45921 - }
45922 - },
45923 - "required": [
45924 - "storage_backend"
45925 - ]
45926 - }
45927 - },
45928 - "required": [
45929 - "id",
45930 - "key",
45931 - "new_presigned_url",
45932 - "newPresignedUrl",
45933 - "type",
45934 - "metadata"
45935 - ]
45923 + "key": {
45924 + "type": "string",
45925 + "description": "Object storage upload location. Example: \"projects/prj_xyz789/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx\""
45926 + },
45927 + "new_presigned_url": {
45928 + "type": "string",
45929 + "description": "Presigned URL for upload. Example: \"https://storage.composio.dev/projects/prj_xyz789/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600...\""
45930 + },
45931 + "newPresignedUrl": {
45932 + "type": "string",
45933 + "description": "[DEPRECATED] Use new_presigned_url instead. Presigned URL for upload. Example: \"https://storage.composio.dev/projects/prj_xyz789/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600...\"",
45934 + "deprecated": true
45935 + },
45936 + "type": {
45937 + "type": "string",
45938 + "enum": [
45939 + "new"
45940 + ],
45941 + "description": "[DEPRECATED] Indicates this is a new file that needs to be uploaded",
45942 + "deprecated": true
45943 },
45937 - {
45944 + "metadata": {
45945 "type": "object",
45946 "properties": {
45940 - "id": {
45941 - "type": "string",
45942 - "description": "ID of the request file. Example: \"f1e2d3c4b5a6\""
45943 - },
45944 - "key": {
45945 - "type": "string",
45946 - "description": "S3 upload location. Example: \"projects/123/files/photo-1234.jpg\""
45947 - },
45948 - "update_presigned_url": {
45949 - "type": "string",
45950 - "description": "Presigned URL for upload. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=...\""
45951 - },
45952 - "updatePresignedUrl": {
45953 - "type": "string",
45954 - "description": "[DEPRECATED] Use update_presigned_url instead. Presigned URL for upload. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=...\""
45955 - },
45956 - "type": {
45947 + "storage_backend": {
45948 "type": "string",
45949 "enum": [
45959 - "update"
45950 + "s3",
45951 + "azure_blob_storage"
45952 ],
45961 - "description": "Indicates this file exists but needs to be updated with a new version"
45962 - },
45963 - "metadata": {
45964 - "type": "object",
45965 - "properties": {
45966 - "storage_backend": {
45967 - "type": "string",
45968 - "enum": [
45969 - "s3",
45970 - "azure_blob_storage"
45971 - ],
45972 - "description": "Storage backend used for the file. If this is azure, use `x-ms-blob-type` header to set the blob type to `BlockBlob` while uploading the file"
45973 - }
45974 - },
45975 - "required": [
45976 - "storage_backend"
45977 - ]
45953 + "description": "Storage backend used for the file. If this is azure, use `x-ms-blob-type` header to set the blob type to `BlockBlob` while uploading the file"
45954 }
45955 },
45956 "required": [
45981 - "id",
45982 - "key",
45983 - "update_presigned_url",
45984 - "updatePresignedUrl",
45985 - "type",
45986 - "metadata"
45957 + "storage_backend"
45958 ]
45959 }
45960 + },
45961 + "required": [
45962 + "id",
45963 + "key",
45964 + "new_presigned_url",
45965 + "newPresignedUrl",
45966 + "type",
45967 + "metadata"
45968 ]
45969 }
45970 }
@@ -46201,215 +46180,6 @@
46180 }
46181 }
46182 },
46204 - "/api/v3/labs/tool_router/session": {
46205 - "post": {
46206 - "summary": "Create a new tool router session (Legacy)",
46207 - "description": "Creates a new session for the tool router lab feature (Legacy). This endpoint initializes a new session with specified toolkits and their authentication configurations. The session provides an isolated environment for testing and managing tool routing logic with scoped MCP server access.",
46208 - "tags": [
46209 - "Tool Router"
46210 - ],
46211 - "operationId": "postLabsToolRouterSession",
46212 - "security": [
46213 - {
46214 - "ApiKeyAuth": []
46215 - }
46216 - ],
46217 - "requestBody": {
46218 - "content": {
46219 - "application/json": {
46220 - "schema": {
46221 - "type": "object",
46222 - "properties": {
46223 - "user_id": {
46224 - "type": "string",
46225 - "description": "Unique user identifier for the session owner",
46226 - "example": "user_123456789"
46227 - },
46228 - "config": {
46229 - "type": "object",
46230 - "properties": {
46231 - "manually_manage_connections": {
46232 - "type": "boolean",
46233 - "nullable": true,
46234 - "default": false,
46235 - "description": "Whether to manually manage connections",
46236 - "example": true
46237 - },
46238 - "toolkits": {
46239 - "type": "array",
46240 - "items": {
46241 - "type": "object",
46242 - "properties": {
46243 - "toolkit": {
46244 - "type": "string",
46245 - "minLength": 1,
46246 - "description": "Toolkit identifier (e.g., gmail, slack, github)",
46247 - "example": "gmail"
46248 - },
46249 - "auth_config_id": {
46250 - "type": "string",
46251 - "description": "Specific auth configuration ID for this toolkit",
46252 - "example": "auth_config_123"
46253 - }
46254 - },
46255 - "required": [
46256 - "toolkit"
46257 - ]
46258 - },
46259 - "default": [],
46260 - "description": "Array of toolkit configurations with optional auth configs",
46261 - "example": [
46262 - {
46263 - "toolkit": "gmail",
46264 - "auth_config_id": "auth_config_123"
46265 - },
46266 - {
46267 - "toolkit": "slack"
46268 - }
46269 - ]
46270 - }
46271 - },
46272 - "default": {},
46273 - "description": "Session configuration including enabled toolkits and their auth configs",
46274 - "example": {
46275 - "manually_manage_connections": false,
46276 - "toolkits": [
46277 - {
46278 - "toolkit": "gmail",
46279 - "auth_config_id": "auth_config_123"
46280 - },
46281 - {
46282 - "toolkit": "slack"
46283 - }
46284 - ]
46285 - }
46286 - }
46287 - },
46288 - "required": [
46289 - "user_id"
46290 - ]
46291 - },
46292 - "examples": {
46293 - "Session with multiple toolkits": {
46294 - "value": {
46295 - "user_id": "user_123456789",
46296 - "config": {
46297 - "toolkits": [
46298 - {
46299 - "toolkit": "gmail",
46300 - "auth_config_id": "auth_config_123"
46301 - },
46302 - {
46303 - "toolkit": "slack",
46304 - "auth_config_id": "auth_config_456"
46305 - },
46306 - {
46307 - "toolkit": "github"
46308 - }
46309 - ]
46310 - }
46311 - }
46312 - },
46313 - "Minimal session": {
46314 - "value": {
46315 - "user_id": "user_123456789",
46316 - "config": {}
46317 - }
46318 - },
46319 - "Session with single toolkit": {
46320 - "value": {
46321 - "user_id": "user_123456789",
46322 - "config": {
46323 - "toolkits": [
46324 - {
46325 - "toolkit": "gmail"
46326 - }
46327 - ]
46328 - }
46329 - }
46330 - }
46331 - }
46332 - }
46333 - }
46334 - },
46335 - "responses": {
46336 - "201": {
46337 - "description": "Session successfully created. Returns the session ID and MCP server URL for the created session.",
46338 - "content": {
46339 - "application/json": {
46340 - "schema": {
46341 - "type": "object",
46342 - "properties": {
46343 - "session_id": {
46344 - "type": "string",
46345 - "description": "Generated session identifier",
46346 - "example": "session_123456789"
46347 - },
46348 - "chat_session_mcp_url": {
46349 - "type": "string",
46350 - "format": "uri",
46351 - "description": "MCP server endpoint URL for this specific chat session",
46352 - "example": "https://api.composio.dev/v3/mcp/tool-router/session_123456789/mcp"
46353 - },
46354 - "tool_router_instance_mcp_url": {
46355 - "type": "string",
46356 - "format": "uri",
46357 - "description": "MCP server endpoint URL for this specific tool router instance",
46358 - "example": "https://api.composio.dev/v3/mcp/tool-router/session_123456789/mcp"
46359 - }
46360 - },
46361 - "required": [
46362 - "session_id",
46363 - "chat_session_mcp_url",
46364 - "tool_router_instance_mcp_url"
46365 - ]
46366 - }
46367 - }
46368 - }
46369 - },
46370 - "400": {
46371 - "description": "Bad request. This may occur if the user_id format is invalid, toolkit names are invalid, or auth_config_id IDs are malformed.",
46372 - "content": {
46373 - "application/json": {
46374 - "schema": {
46375 - "$ref": "#/components/schemas/Error"
46376 - }
46377 - }
46378 - }
46379 - },
46380 - "401": {
46381 - "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",
46382 - "content": {
46383 - "application/json": {
46384 - "schema": {
46385 - "$ref": "#/components/schemas/Error"
46386 - }
46387 - }
46388 - }
46389 - },
46390 - "409": {
46391 - "description": "Conflict. A session for this user with the same configuration already exists.",
46392 - "content": {
46393 - "application/json": {
46394 - "schema": {
46395 - "$ref": "#/components/schemas/Error"
46396 - }
46397 - }
46398 - }
46399 - },
46400 - "500": {
46401 - "description": "Internal server error. An unexpected error occurred while processing the request.",
46402 - "content": {
46403 - "application/json": {
46404 - "schema": {
46405 - "$ref": "#/components/schemas/Error"
46406 - }
46407 - }
46408 - }
46409 - }
46410 - }
46411 - }
46412 - },
46183 "/api/v3/tool_router/session": {
46184 "post": {
46185 "summary": "Create a new tool router session",
@@ -46421,9 +46191,6 @@
46191 "security": [
46192 {
46193 "ApiKeyAuth": []
46424 - },
46425 - {
46426 - "CookieAuth": []
46194 }
46195 ],
46196 "requestBody": {
@@ -46524,10 +46291,18 @@
46291 "format": "uri",
46292 "description": "The URL to redirect to after a user completes authentication for a connected account. This allows you to handle the auth callback in your own application.",
46293 "example": "https://your-app.com/auth/callback"
46294 + },
46295 + "enable_wait_for_connections": {
46296 + "type": "boolean",
46297 + "nullable": true,
46298 + "default": false,
46299 + "description": "When true, the COMPOSIO_WAIT_FOR_CONNECTIONS tool is available for agents to poll connection status after sharing auth URLs. Default is false (disabled). May not work reliably with GPT models.",
46300 + "example": false
46301 }
46302 },
46303 "default": {
46530 - "enable": true
46304 + "enable": true,
46305 + "enable_wait_for_connections": false
46306 },
46307 "additionalProperties": false,
46308 "description": "Configuration for connection management settings"
@@ -46745,6 +46520,26 @@
46520 },
46521 "additionalProperties": false,
46522 "description": "Configuration for workbench behavior"
46523 + },
46524 + "experimental": {
46525 + "type": "object",
46526 + "properties": {
46527 + "assistive_prompt_config": {
46528 + "type": "object",
46529 + "properties": {
46530 + "user_timezone": {
46531 + "type": "string",
46532 + "description": "IANA timezone identifier (e.g., 'America/New_York', 'Europe/London'). Used to customize the system prompt with timezone-aware instructions.",
46533 + "example": "America/New_York"
46534 + }
46535 + },
46536 + "additionalProperties": false,
46537 + "description": "Customize assistive prompt generation (e.g., timezone)."
46538 + }
46539 + },
46540 + "additionalProperties": false,
46541 + "description": "Experimental features - not stable, may be modified or removed in future versions.",
46542 + "x-experimental": true
46543 }
46544 },
46545 "required": [
@@ -46980,17 +46775,7 @@
46775 "tool_router_tools": {
46776 "type": "array",
46777 "items": {
46983 - "type": "string",
46984 - "enum": [
46985 - "COMPOSIO_SEARCH_TOOLS",
46986 - "COMPOSIO_MULTI_EXECUTE_TOOL",
46987 - "COMPOSIO_MANAGE_CONNECTIONS",
46988 - "COMPOSIO_REMOTE_WORKBENCH",
46989 - "COMPOSIO_REMOTE_BASH_TOOL",
46990 - "COMPOSIO_GET_TOOL_SCHEMAS",
46991 - "COMPOSIO_UPSERT_RECIPE",
46992 - "COMPOSIO_GET_RECIPE"
46993 - ]
46778 + "type": "string"
46779 },
46780 "description": "List of available tools in this session"
46781 },
@@ -47064,6 +46849,11 @@
46849 "type": "string",
46850 "format": "uri",
46851 "description": "Custom callback URL for connected account auth flows"
46852 + },
46853 + "enable_wait_for_connections": {
46854 + "type": "boolean",
46855 + "default": false,
46856 + "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."
46857 }
46858 },
46859 "description": "Manage connections configuration"
@@ -47202,6 +46992,21 @@
46992 "user_id"
46993 ],
46994 "description": "The session configuration including user, toolkits, and overrides"
46995 + },
46996 + "experimental": {
46997 + "type": "object",
46998 + "properties": {
46999 + "assistive_prompt": {
47000 + "type": "string",
47001 + "description": "The assistive system prompt to inject into your agent for optimal tool router usage",
47002 + "example": "You are an AI agent that completes user tasks by calling Composio ToolRouter meta-tools..."
47003 + }
47004 + },
47005 + "required": [
47006 + "assistive_prompt"
47007 + ],
47008 + "description": "Experimental features including the generated system prompt. Only returned on session creation, not on GET.",
47009 + "x-experimental": true
47010 }
47011 },
47012 "required": [
@@ -47269,9 +47074,6 @@
47074 {
47075 "ApiKeyAuth": []
47076 },
47272 - {
47273 - "CookieAuth": []
47274 - },
47077 {
47078 "workbench_access_key": []
47079 }
@@ -47429,9 +47231,6 @@
47231 "security": [
47232 {
47233 "ApiKeyAuth": []
47432 - },
47433 - {
47434 - "CookieAuth": []
47234 }
47235 ],
47236 "parameters": [
@@ -47460,6 +47259,7 @@
47259 "COMPOSIO_SEARCH_TOOLS",
47260 "COMPOSIO_MULTI_EXECUTE_TOOL",
47261 "COMPOSIO_MANAGE_CONNECTIONS",
47262 + "COMPOSIO_WAIT_FOR_CONNECTIONS",
47263 "COMPOSIO_REMOTE_WORKBENCH",
47264 "COMPOSIO_REMOTE_BASH_TOOL",
47265 "COMPOSIO_GET_TOOL_SCHEMAS",
@@ -47594,9 +47394,6 @@
47394 "security": [
47395 {
47396 "ApiKeyAuth": []
47597 - },
47598 - {
47599 - "CookieAuth": []
47397 }
47398 ],
47399 "parameters": [
@@ -47652,17 +47449,7 @@
47449 "tool_router_tools": {
47450 "type": "array",
47451 "items": {
47655 - "type": "string",
47656 - "enum": [
47657 - "COMPOSIO_SEARCH_TOOLS",
47658 - "COMPOSIO_MULTI_EXECUTE_TOOL",
47659 - "COMPOSIO_MANAGE_CONNECTIONS",
47660 - "COMPOSIO_REMOTE_WORKBENCH",
47661 - "COMPOSIO_REMOTE_BASH_TOOL",
47662 - "COMPOSIO_GET_TOOL_SCHEMAS",
47663 - "COMPOSIO_UPSERT_RECIPE",
47664 - "COMPOSIO_GET_RECIPE"
47665 - ]
47452 + "type": "string"
47453 },
47454 "description": "List of available tools in this session"
47455 },
@@ -47736,6 +47523,11 @@
47523 "type": "string",
47524 "format": "uri",
47525 "description": "Custom callback URL for connected account auth flows"
47526 + },
47527 + "enable_wait_for_connections": {
47528 + "type": "boolean",
47529 + "default": false,
47530 + "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."
47531 }
47532 },
47533 "description": "Manage connections configuration"
@@ -47940,9 +47732,6 @@
47732 "security": [
47733 {
47734 "ApiKeyAuth": []
47943 - },
47944 - {
47945 - "CookieAuth": []
47735 }
47736 ],
47737 "parameters": [
@@ -48084,9 +47873,6 @@
47873 "security": [
47874 {
47875 "ApiKeyAuth": []
48087 - },
48088 - {
48089 - "CookieAuth": []
47876 }
47877 ],
47878 "parameters": [
@@ -48224,6 +48010,118 @@
48010 }
48011 }
48012 },
48013 + "/api/v3/tool_router/session/{session_id}/tools": {
48014 + "get": {
48015 + "summary": "List meta tools with schemas for a tool router session",
48016 + "description": "Returns the meta tools available in a tool router session with their complete schemas. This includes request and response schemas specific to the session context.",
48017 + "tags": [
48018 + "Tool Router"
48019 + ],
48020 + "operationId": "getToolRouterSessionBySessionIdTools",
48021 + "security": [
48022 + {
48023 + "ApiKeyAuth": []
48024 + }
48025 + ],
48026 + "parameters": [
48027 + {
48028 + "schema": {
48029 + "type": "string",
48030 + "format": "toolRouterSessionId",
48031 + "description": "Tool router session ID"
48032 + },
48033 + "required": false,
48034 + "description": "Tool router session ID",
48035 + "name": "session_id",
48036 + "in": "path"
48037 + }
48038 + ],
48039 + "requestBody": {
48040 + "content": {
48041 + "application/json": {
48042 + "schema": {
48043 + "type": "object",
48044 + "properties": {}
48045 + }
48046 + }
48047 + }
48048 + },
48049 + "responses": {
48050 + "200": {
48051 + "description": "Successfully retrieved meta tools with their complete schemas.",
48052 + "content": {
48053 + "application/json": {
48054 + "schema": {
48055 + "type": "object",
48056 + "properties": {
48057 + "items": {
48058 + "type": "array",
48059 + "items": {
48060 + "$ref": "#/components/schemas/Tool"
48061 + },
48062 + "description": "List of tools with their complete schemas"
48063 + }
48064 + },
48065 + "required": [
48066 + "items"
48067 + ]
48068 + }
48069 + }
48070 + }
48071 + },
48072 + "400": {
48073 + "description": "Bad request",
48074 + "content": {
48075 + "application/json": {
48076 + "schema": {
48077 + "$ref": "#/components/schemas/Error"
48078 + }
48079 + }
48080 + }
48081 + },
48082 + "401": {
48083 + "description": "Unauthorized",
48084 + "content": {
48085 + "application/json": {
48086 + "schema": {
48087 + "$ref": "#/components/schemas/Error"
48088 + }
48089 + }
48090 + }
48091 + },
48092 + "403": {
48093 + "description": "Forbidden",
48094 + "content": {
48095 + "application/json": {
48096 + "schema": {
48097 + "$ref": "#/components/schemas/Error"
48098 + }
48099 + }
48100 + }
48101 + },
48102 + "404": {
48103 + "description": "Not found",
48104 + "content": {
48105 + "application/json": {
48106 + "schema": {
48107 + "$ref": "#/components/schemas/Error"
48108 + }
48109 + }
48110 + }
48111 + },
48112 + "500": {
48113 + "description": "Internal server error",
48114 + "content": {
48115 + "application/json": {
48116 + "schema": {
48117 + "$ref": "#/components/schemas/Error"
48118 + }
48119 + }
48120 + }
48121 + }
48122 + }
48123 + }
48124 + },
48125 "/api/v3/toolkits/changelog": {
48126 "get": {
48127 "summary": "Get toolkits changelog",
@@ -48235,9 +48133,6 @@
48133 "security": [
48134 {
48135 "ApiKeyAuth": []
48238 - },
48239 - {
48240 - "CookieAuth": []
48136 }
48137 ],
48138 "responses": {
docs/scripts/fetch-openapi.mjs
+26
@@ -14,6 +14,7 @@ const OPENAPI_URL = process.env.OPENAPI_SPEC_URL || 'https://backend.composio.de
14 // Endpoints to ignore (same as fern openapi-overrides.yml)
15 const IGNORED_PATHS = [
16 '/api/v3/mcp/validate/{uuid}',
17 + '/api/v3/labs/tool_router/session',
18 '/api/v3/cli/get-session',
19 '/api/v3/cli/create-session',
20 '/api/v3/auth/session/logout',
@@ -79,6 +80,31 @@ async function fetchAndFilterSpec() {
80 spec.tags = spec.tags.filter(tag => !IGNORED_TAGS.includes(tag.name));
81 }
82
83 + // Remove CookieAuth from security schemes
84 + if (spec.components?.securitySchemes?.CookieAuth) {
85 + delete spec.components.securitySchemes.CookieAuth;
86 + console.log('Removed CookieAuth from securitySchemes');
87 + }
88 +
89 + // Remove CookieAuth from all endpoint security arrays
90 + let cookieAuthRemovedCount = 0;
91 + for (const methods of Object.values(spec.paths)) {
92 + for (const operation of Object.values(methods)) {
93 + if (operation.security) {
94 + const originalLength = operation.security.length;
95 + operation.security = operation.security.filter(sec => !('CookieAuth' in sec));
96 + if (operation.security.length < originalLength) {
97 + cookieAuthRemovedCount++;
98 + }
99 + // Remove empty security array
100 + if (operation.security.length === 0) {
101 + delete operation.security;
102 + }
103 + }
104 + }
105 + }
106 + console.log(`Removed CookieAuth from ${cookieAuthRemovedCount} endpoint security definitions`);
107 +
108 console.log(`Removed ${removedCount} endpoints/operations`);
109 console.log(`Final spec has ${Object.keys(filteredPaths).length} paths`);
110