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