Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

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

Sushmithamallesh5c337af92e6a
diff --git a/docs/public/openapi.json b/docs/public/openapi.json
index a9c134689..a71978c63 100644
--- a/docs/public/openapi.json
+++ b/docs/public/openapi.json
@@ -110,12 +110,6 @@
"name": "x-api-key",
"description": "API key authentication"
},
- "CookieAuth": {
- "type": "apiKey",
- "in": "cookie",
- "name": "authToken",
- "description": "Cookie-based session authentication"
- },
"OrgApiKeyAuth": {
"type": "apiKey",
"in": "header",
@@ -136,6 +130,9 @@
"code": {
"type": "number"
},
+ "slug": {
+ "type": "string"
+ },
"status": {
"type": "number"
},
@@ -155,6 +152,7 @@
"required": [
"message",
"code",
+ "slug",
"status"
]
}
@@ -312,6 +310,11 @@
"devops"
]
},
+ "status": {
+ "type": "string",
+ "description": "Lifecycle status of the tool",
+ "example": "active"
+ },
"is_deprecated": {
"type": "boolean",
"description": "Indicates if this tool is deprecated and may be removed in the future",
@@ -381,6 +384,7 @@
"output_parameters",
"scopes",
"tags",
+ "status",
"is_deprecated",
"deprecated"
]
@@ -568,9 +572,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"responses": {
@@ -907,9 +908,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -1004,7 +1002,12 @@
"additionalProperties": {
"nullable": true
},
- "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config"
+ "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config",
+ "x-experimental": true
+ },
+ "is_enabled_for_tool_router": {
+ "type": "boolean",
+ "description": "Whether this auth config is enabled for tool router"
}
},
"required": [
@@ -1076,6 +1079,7 @@
},
"proxy_config": {
"type": "object",
+ "nullable": true,
"properties": {
"proxy_url": {
"type": "string",
@@ -1118,7 +1122,12 @@
"additionalProperties": {
"nullable": true
},
- "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config"
+ "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config",
+ "x-experimental": true
+ },
+ "is_enabled_for_tool_router": {
+ "type": "boolean",
+ "description": "Whether this auth config is enabled for tool router"
}
},
"required": [
@@ -1252,9 +1261,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -1431,6 +1437,7 @@
},
"proxy_config": {
"type": "object",
+ "nullable": true,
"properties": {
"proxy_url": {
"type": "string",
@@ -1511,7 +1518,12 @@
"additionalProperties": {
"nullable": true
},
- "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config"
+ "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config",
+ "x-experimental": true
+ },
+ "is_enabled_for_tool_router": {
+ "type": "boolean",
+ "description": "Whether this auth config is enabled for tool router"
},
"deprecated_params": {
"type": "object",
@@ -1637,9 +1649,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -1734,6 +1743,7 @@
},
"proxy_config": {
"type": "object",
+ "nullable": true,
"properties": {
"proxy_url": {
"type": "string",
@@ -1814,7 +1824,12 @@
"additionalProperties": {
"nullable": true
},
- "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config"
+ "description": "[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config",
+ "x-experimental": true
+ },
+ "is_enabled_for_tool_router": {
+ "type": "boolean",
+ "description": "Whether this auth config is enabled for tool router"
},
"deprecated_params": {
"type": "object",
@@ -1916,9 +1931,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -1981,6 +1993,7 @@
},
"proxy_config": {
"type": "object",
+ "nullable": true,
"properties": {
"proxy_url": {
"type": "string",
@@ -2001,7 +2014,6 @@
"items": {
"type": "string"
},
- "default": [],
"description": "Use tool_access_config instead. This field will be deprecated in the future.",
"deprecated": true
},
@@ -2013,7 +2025,6 @@
"items": {
"type": "string"
},
- "default": [],
"description": "Tools used to generate the minimum required scopes for the auth config (only valid for OAuth). If passed, this will update the scopes."
},
"tools_available_for_execution": {
@@ -2021,7 +2032,6 @@
"items": {
"type": "string"
},
- "default": [],
"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."
}
}
@@ -2032,11 +2042,14 @@
"nullable": true
},
"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."
+ },
+ "is_enabled_for_tool_router": {
+ "type": "boolean",
+ "description": "Whether this auth config is enabled for tool router"
}
},
"required": [
- "type",
- "credentials"
+ "type"
]
},
{
@@ -2066,7 +2079,6 @@
"items": {
"type": "string"
},
- "default": [],
"description": "Use tool_access_config instead. This field will be deprecated in the future.",
"deprecated": true
},
@@ -2078,7 +2090,6 @@
"items": {
"type": "string"
},
- "default": [],
"description": "Tools used to generate the minimum required scopes for the auth config (only valid for OAuth). If passed, this will update the scopes."
},
"tools_available_for_execution": {
@@ -2086,7 +2097,6 @@
"items": {
"type": "string"
},
- "default": [],
"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."
}
}
@@ -2097,6 +2107,10 @@
"nullable": true
},
"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."
+ },
+ "is_enabled_for_tool_router": {
+ "type": "boolean",
+ "description": "Whether this auth config is enabled for tool router"
}
},
"required": [
@@ -2189,9 +2203,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -2274,9 +2285,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -2371,9 +2379,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -9315,9 +9320,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -15925,7 +15927,8 @@
"validate_credentials": {
"type": "boolean",
"default": false,
- "description": "[EXPERIMENTAL] Whether to validate the provided credentials, validates only for API Key Auth scheme"
+ "description": "[EXPERIMENTAL] Whether to validate the provided credentials, validates only for API Key Auth scheme",
+ "x-experimental": true
}
},
"required": [
@@ -22618,9 +22621,6 @@
],
"operationId": "getConnectedAccountsByNanoid",
"security": [
- {
- "CookieAuth": []
- },
{
"ApiKeyAuth": []
}
@@ -29434,9 +29434,6 @@
],
"operationId": "deleteConnectedAccountsByNanoid",
"security": [
- {
- "CookieAuth": []
- },
{
"ApiKeyAuth": []
}
@@ -29543,9 +29540,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -29671,9 +29665,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -29709,7 +29700,8 @@
"validate_credentials": {
"type": "boolean",
"default": false,
- "description": "[EXPERIMENTAL] Whether to validate the provided credentials, validates only for API Key Auth scheme"
+ "description": "[EXPERIMENTAL] Whether to validate the provided credentials, validates only for API Key Auth scheme",
+ "x-experimental": true
}
}
}
@@ -29835,9 +29827,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -35716,9 +35705,6 @@
],
"operationId": "getOrgProjectConfig",
"security": [
- {
- "CookieAuth": []
- },
{
"ApiKeyAuth": []
}
@@ -35752,6 +35738,15 @@
},
"require_mcp_api_key": {
"type": "boolean"
+ },
+ "is_composio_link_enabled_for_managed_auth": {
+ "type": "boolean",
+ "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."
+ },
+ "signed_url_file_expiry_in_seconds": {
+ "type": "number",
+ "minimum": 1,
+ "maximum": 86400
}
},
"required": [
@@ -35813,9 +35808,6 @@
],
"operationId": "patchOrgProjectConfig",
"security": [
- {
- "CookieAuth": []
- },
{
"ApiKeyAuth": []
}
@@ -35847,6 +35839,15 @@
},
"require_mcp_api_key": {
"type": "boolean"
+ },
+ "is_composio_link_enabled_for_managed_auth": {
+ "type": "boolean",
+ "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."
+ },
+ "signed_url_file_expiry_in_seconds": {
+ "type": "number",
+ "minimum": 1,
+ "maximum": 86400
}
}
},
@@ -35894,6 +35895,15 @@
},
"require_mcp_api_key": {
"type": "boolean"
+ },
+ "is_composio_link_enabled_for_managed_auth": {
+ "type": "boolean",
+ "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."
+ },
+ "signed_url_file_expiry_in_seconds": {
+ "type": "number",
+ "minimum": 1,
+ "maximum": 86400
}
},
"required": [
@@ -36005,6 +36015,15 @@
},
"require_mcp_api_key": {
"type": "boolean"
+ },
+ "is_composio_link_enabled_for_managed_auth": {
+ "type": "boolean",
+ "description": "Whether to enable composio link for managed authentication. This key will be deprecated in the future. Please don't use this key."
+ },
+ "signed_url_file_expiry_in_seconds": {
+ "type": "number",
+ "minimum": 1,
+ "maximum": 86400
}
},
"required": [
@@ -36496,6 +36515,16 @@
}
}
},
+ "404": {
+ "description": "Not found. The specified project does not exist or you do not have access to it.",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ },
"500": {
"description": "Internal server error. An unexpected error occurred while processing the request.",
"content": {
@@ -36589,6 +36618,16 @@
}
}
},
+ "404": {
+ "description": "Not found. The specified project does not exist or has already been deleted.",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ },
"500": {
"description": "Internal server error. An unexpected error occurred while processing the request.",
"content": {
@@ -36703,6 +36742,16 @@
}
}
},
+ "404": {
+ "description": "Not found. The specified project does not exist or you do not have access to it.",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ },
"500": {
"description": "Internal server error. An unexpected error occurred while processing the request.",
"content": {
@@ -36727,9 +36776,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -36872,6 +36918,11 @@
"description": "When true, this toolkit can be used without authentication",
"example": false
},
+ "status": {
+ "type": "string",
+ "description": "Lifecycle status of the toolkit",
+ "example": "active"
+ },
"deprecated": {
"$ref": "#/components/schemas/DeprecatedToolkitInfo"
},
@@ -36970,6 +37021,7 @@
"slug",
"name",
"is_local_toolkit",
+ "status",
"deprecated",
"meta"
],
@@ -37054,9 +37106,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"responses": {
@@ -37168,9 +37217,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -37221,6 +37267,11 @@
"description": "Indicates if this toolkit is currently enabled and available for use",
"example": true
},
+ "status": {
+ "type": "string",
+ "description": "Lifecycle status of the toolkit",
+ "example": "active"
+ },
"composio_managed_auth_schemes": {
"type": "array",
"items": {
@@ -37578,6 +37629,11 @@
"type": "string",
"description": "Endpoint to get the current user"
},
+ "get_current_user_endpoint_method": {
+ "type": "string",
+ "description": "HTTP method to use when calling the get current user endpoint (e.g., GET, POST)",
+ "example": "GET"
+ },
"deprecated": {
"type": "object",
"properties": {
@@ -37607,6 +37663,7 @@
"slug",
"name",
"enabled",
+ "status",
"is_local_toolkit",
"meta",
"deprecated"
@@ -37670,9 +37727,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -37913,9 +37967,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"responses": {
@@ -37997,9 +38048,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -38125,9 +38173,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -38238,6 +38283,11 @@
"description": "When true, this toolkit can be used without authentication",
"example": false
},
+ "status": {
+ "type": "string",
+ "description": "Lifecycle status of the toolkit",
+ "example": "active"
+ },
"deprecated": {
"$ref": "#/components/schemas/DeprecatedToolkitInfo"
},
@@ -38336,6 +38386,7 @@
"slug",
"name",
"is_local_toolkit",
+ "status",
"deprecated",
"meta"
],
@@ -38420,9 +38471,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -39820,6 +39868,16 @@
}
}
},
+ "413": {
+ "description": "Payload too large - Request or response payload exceeds size limits",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ },
"422": {
"description": "Unprocessable entity - Invalid state of the connected account",
"content": {
@@ -39894,9 +39952,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -40051,9 +40106,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -40131,7 +40183,7 @@
]
}
],
- "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", contentType?: \"...\"}. For binary upload via base64: use {base64: \"...\", contentType?: \"...\"}."
+ "description": "Binary body to send. For binary upload via URL: use {url: \"https://...\", content_type?: \"...\"}. For binary upload via base64: use {base64: \"...\", content_type?: \"...\"}."
},
"parameters": {
"type": "array",
@@ -41520,19 +41572,16 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
{
"schema": {
"type": "string",
- "description": "The slug of the trigger instance"
+ "description": "The slug of the trigger instance. Case-insensitive (internally normalized to uppercase)."
},
"required": true,
- "description": "The slug of the trigger instance",
+ "description": "The slug of the trigger instance. Case-insensitive (internally normalized to uppercase).",
"name": "slug",
"in": "path"
}
@@ -41600,7 +41649,39 @@
},
"responses": {
"200": {
- "description": "Successfully updated trigger instance",
+ "description": "Successfully upserted trigger instance",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "trigger_id": {
+ "type": "string",
+ "description": "ID of the updated trigger"
+ },
+ "deprecated": {
+ "type": "object",
+ "properties": {
+ "uuid": {
+ "type": "string",
+ "description": "ID of the updated trigger"
+ }
+ },
+ "required": [
+ "uuid"
+ ]
+ }
+ },
+ "required": [
+ "trigger_id",
+ "deprecated"
+ ]
+ }
+ }
+ }
+ },
+ "201": {
+ "description": "Successfully created trigger instance",
"content": {
"application/json": {
"schema": {
@@ -41724,12 +41805,23 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
+ {
+ "schema": {
+ "type": "array",
+ "nullable": true,
+ "items": {
+ "type": "string"
+ },
+ "description": "Array of user IDs to filter triggers by"
+ },
+ "required": false,
+ "description": "Array of user IDs to filter triggers by",
+ "name": "user_ids",
+ "in": "query"
+ },
{
"schema": {
"type": "array",
@@ -41782,10 +41874,10 @@
"items": {
"type": "string"
},
- "description": "Array of trigger names to filter triggers by"
+ "description": "Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase)."
},
"required": false,
- "description": "Array of trigger names to filter triggers by",
+ "description": "Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase).",
"name": "trigger_names",
"in": "query"
},
@@ -41860,18 +41952,6 @@
"name": "triggerNames",
"in": "query"
},
- {
- "schema": {
- "type": "number",
- "minimum": 1,
- "default": 1,
- "description": "Page number for pagination. Starts from 1."
- },
- "required": false,
- "description": "Page number for pagination. Starts from 1.",
- "name": "page",
- "in": "query"
- },
{
"schema": {
"type": "boolean",
@@ -42003,7 +42083,8 @@
"disabledAt": {
"type": "string",
"nullable": true,
- "description": "ID of the user who disabled the trigger instance, if applicable"
+ "description": "DEPRECATED: This parameter will be removed in a future version. Please use disabled_at instead.",
+ "deprecated": true
},
"connectedAccountId": {
"type": "string",
@@ -42126,9 +42207,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -42235,9 +42313,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -42379,9 +42454,6 @@
],
"operationId": "getTriggersTypesListEnum",
"security": [
- {
- "CookieAuth": []
- },
{
"ApiKeyAuth": []
}
@@ -42455,20 +42527,17 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
{
"schema": {
"type": "string",
- "description": "The unique slug identifier for the trigger type",
+ "description": "The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).",
"example": "SLACK_NEW_MESSAGE"
},
"required": true,
- "description": "The unique slug identifier for the trigger type",
+ "description": "The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).",
"name": "slug",
"in": "path"
},
@@ -42619,6 +42688,11 @@
"type": "string",
"description": "Version of the trigger type",
"example": "20250930_00"
+ },
+ "status": {
+ "type": "string",
+ "description": "Lifecycle status of the trigger",
+ "example": "active"
}
},
"required": [
@@ -42630,7 +42704,8 @@
"toolkit",
"config",
"payload",
- "version"
+ "version",
+ "status"
]
}
}
@@ -42690,9 +42765,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -42885,6 +42957,11 @@
"type": "string",
"description": "Version of the trigger type",
"example": "20250930_00"
+ },
+ "status": {
+ "type": "string",
+ "description": "Lifecycle status of the trigger",
+ "example": "active"
}
},
"required": [
@@ -42896,7 +42973,8 @@
"toolkit",
"config",
"payload",
- "version"
+ "version",
+ "status"
]
}
},
@@ -42978,9 +43056,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -43324,9 +43399,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -43628,9 +43700,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -43870,9 +43939,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -44062,9 +44128,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -44288,9 +44351,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -44629,9 +44689,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -44740,9 +44797,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -45109,9 +45163,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -45340,9 +45391,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -45506,9 +45554,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -45612,9 +45657,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -45745,6 +45787,16 @@
}
}
},
+ "404": {
+ "description": "Not found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ },
"500": {
"description": "Internal server error",
"content": {
@@ -45769,9 +45821,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -45782,23 +45831,23 @@
"properties": {
"toolkit_slug": {
"type": "string",
- "description": "Slug of the app where this file belongs to. Example: \"image-processing\""
+ "description": "Slug of the app where this file belongs to. Example: \"gmail\", \"slack\", \"github\""
},
"tool_slug": {
"type": "string",
- "description": "Slug of the action where this file belongs to. Example: \"resize-image\""
+ "description": "Slug of the action where this file belongs to. Example: \"GMAIL_SEND_EMAIL\", \"SLACK_UPLOAD_FILE\""
},
"filename": {
"type": "string",
- "description": "Name of the original file. Example: \"photo.jpg\""
+ "description": "Name of the original file. Example: \"quarterly_report.pdf\""
},
"mimetype": {
"type": "string",
- "description": "Mime type of the original file. Example: \"image/jpeg\""
+ "description": "Mime type of the original file. Example: \"application/pdf\", \"image/png\""
},
"md5": {
"type": "string",
- "description": "MD5 hash of the file for deduplication and integrity verification. Example: \"d41d8cd98f00b204e9800998ecf8427e\""
+ "description": "MD5 hash of the file for deduplication and integrity verification. Example: \"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6\""
}
},
"required": [
@@ -45810,13 +45859,49 @@
]
},
"examples": {
- "New Image File": {
+ "Gmail Email Attachment": {
+ "value": {
+ "toolkit_slug": "gmail",
+ "tool_slug": "GMAIL_SEND_EMAIL",
+ "filename": "quarterly_report.pdf",
+ "mimetype": "application/pdf",
+ "md5": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
+ }
+ },
+ "Slack File Upload": {
"value": {
- "toolkit_slug": "image-processing",
- "tool_slug": "resize-image",
- "filename": "photo.jpg",
- "mimetype": "image/jpeg",
- "md5": "d41d8cd98f00b204e9800998ecf8427e"
+ "toolkit_slug": "slack",
+ "tool_slug": "SLACK_UPLOAD_FILE",
+ "filename": "meeting_notes.docx",
+ "mimetype": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+ "md5": "b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7"
+ }
+ },
+ "GitHub Issue Screenshot": {
+ "value": {
+ "toolkit_slug": "github",
+ "tool_slug": "GITHUB_CREATE_ISSUE",
+ "filename": "bug_screenshot.png",
+ "mimetype": "image/png",
+ "md5": "c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8"
+ }
+ },
+ "Notion Page Image": {
+ "value": {
+ "toolkit_slug": "notion",
+ "tool_slug": "NOTION_ADD_PAGE_CONTENT",
+ "filename": "diagram.svg",
+ "mimetype": "image/svg+xml",
+ "md5": "d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9"
+ }
+ },
+ "Jira Attachment": {
+ "value": {
+ "toolkit_slug": "jira",
+ "tool_slug": "JIRA_ADD_ATTACHMENT",
+ "filename": "error_logs.txt",
+ "mimetype": "text/plain",
+ "md5": "e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
}
}
}
@@ -45829,163 +45914,57 @@
"content": {
"application/json": {
"schema": {
- "oneOf": [
- {
- "type": "object",
- "properties": {
- "id": {
- "type": "string",
- "description": "ID of the request file. Example: \"f1e2d3c4b5a6\""
- },
- "key": {
- "type": "string",
- "description": "S3 upload location. Example: \"projects/123/files/photo-1234.jpg\""
- },
- "existing_url": {
- "type": "string",
- "description": "URL of the existing request file. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg\""
- },
- "existingUrl": {
- "type": "string",
- "description": "[DEPRECATED] Use existing_url instead. URL of the existing request file. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg\""
- },
- "type": {
- "type": "string",
- "enum": [
- "existing"
- ],
- "description": "Indicates the file already exists and does not need to be uploaded again"
- },
- "metadata": {
- "type": "object",
- "properties": {
- "storage_backend": {
- "type": "string",
- "enum": [
- "s3",
- "azure_blob_storage"
- ],
- "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"
- }
- },
- "required": [
- "storage_backend"
- ]
- }
- },
- "required": [
- "id",
- "key",
- "existing_url",
- "existingUrl",
- "type",
- "metadata"
- ]
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "string",
+ "description": "ID of the request file. Example: \"req_file_9mZn4qR8sXwT\""
},
- {
- "type": "object",
- "properties": {
- "id": {
- "type": "string",
- "description": "ID of the request file. Example: \"f1e2d3c4b5a6\""
- },
- "key": {
- "type": "string",
- "description": "S3 upload location. Example: \"projects/123/files/photo-1234.jpg\""
- },
- "new_presigned_url": {
- "type": "string",
- "description": "Presigned URL for upload. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=...\""
- },
- "newPresignedUrl": {
- "type": "string",
- "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=...\""
- },
- "type": {
- "type": "string",
- "enum": [
- "new"
- ],
- "description": "Indicates this is a new file that needs to be uploaded"
- },
- "metadata": {
- "type": "object",
- "properties": {
- "storage_backend": {
- "type": "string",
- "enum": [
- "s3",
- "azure_blob_storage"
- ],
- "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"
- }
- },
- "required": [
- "storage_backend"
- ]
- }
- },
- "required": [
- "id",
- "key",
- "new_presigned_url",
- "newPresignedUrl",
- "type",
- "metadata"
- ]
+ "key": {
+ "type": "string",
+ "description": "Object storage upload location. Example: \"projects/prj_xyz789/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx\""
+ },
+ "new_presigned_url": {
+ "type": "string",
+ "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...\""
+ },
+ "newPresignedUrl": {
+ "type": "string",
+ "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...\"",
+ "deprecated": true
+ },
+ "type": {
+ "type": "string",
+ "enum": [
+ "new"
+ ],
+ "description": "[DEPRECATED] Indicates this is a new file that needs to be uploaded",
+ "deprecated": true
},
- {
+ "metadata": {
"type": "object",
"properties": {
- "id": {
- "type": "string",
- "description": "ID of the request file. Example: \"f1e2d3c4b5a6\""
- },
- "key": {
- "type": "string",
- "description": "S3 upload location. Example: \"projects/123/files/photo-1234.jpg\""
- },
- "update_presigned_url": {
- "type": "string",
- "description": "Presigned URL for upload. Example: \"https://storage.example.com/projects/123/files/photo-1234.jpg?X-Amz-Algorithm=...\""
- },
- "updatePresignedUrl": {
- "type": "string",
- "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=...\""
- },
- "type": {
+ "storage_backend": {
"type": "string",
"enum": [
- "update"
+ "s3",
+ "azure_blob_storage"
],
- "description": "Indicates this file exists but needs to be updated with a new version"
- },
- "metadata": {
- "type": "object",
- "properties": {
- "storage_backend": {
- "type": "string",
- "enum": [
- "s3",
- "azure_blob_storage"
- ],
- "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"
- }
- },
- "required": [
- "storage_backend"
- ]
+ "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"
}
},
"required": [
- "id",
- "key",
- "update_presigned_url",
- "updatePresignedUrl",
- "type",
- "metadata"
+ "storage_backend"
]
}
+ },
+ "required": [
+ "id",
+ "key",
+ "new_presigned_url",
+ "newPresignedUrl",
+ "type",
+ "metadata"
]
}
}
@@ -46201,215 +46180,6 @@
}
}
},
- "/api/v3/labs/tool_router/session": {
- "post": {
- "summary": "Create a new tool router session (Legacy)",
- "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.",
- "tags": [
- "Tool Router"
- ],
- "operationId": "postLabsToolRouterSession",
- "security": [
- {
- "ApiKeyAuth": []
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "type": "object",
- "properties": {
- "user_id": {
- "type": "string",
- "description": "Unique user identifier for the session owner",
- "example": "user_123456789"
- },
- "config": {
- "type": "object",
- "properties": {
- "manually_manage_connections": {
- "type": "boolean",
- "nullable": true,
- "default": false,
- "description": "Whether to manually manage connections",
- "example": true
- },
- "toolkits": {
- "type": "array",
- "items": {
- "type": "object",
- "properties": {
- "toolkit": {
- "type": "string",
- "minLength": 1,
- "description": "Toolkit identifier (e.g., gmail, slack, github)",
- "example": "gmail"
- },
- "auth_config_id": {
- "type": "string",
- "description": "Specific auth configuration ID for this toolkit",
- "example": "auth_config_123"
- }
- },
- "required": [
- "toolkit"
- ]
- },
- "default": [],
- "description": "Array of toolkit configurations with optional auth configs",
- "example": [
- {
- "toolkit": "gmail",
- "auth_config_id": "auth_config_123"
- },
- {
- "toolkit": "slack"
- }
- ]
- }
- },
- "default": {},
- "description": "Session configuration including enabled toolkits and their auth configs",
- "example": {
- "manually_manage_connections": false,
- "toolkits": [
- {
- "toolkit": "gmail",
- "auth_config_id": "auth_config_123"
- },
- {
- "toolkit": "slack"
- }
- ]
- }
- }
- },
- "required": [
- "user_id"
- ]
- },
- "examples": {
- "Session with multiple toolkits": {
- "value": {
- "user_id": "user_123456789",
- "config": {
- "toolkits": [
- {
- "toolkit": "gmail",
- "auth_config_id": "auth_config_123"
- },
- {
- "toolkit": "slack",
- "auth_config_id": "auth_config_456"
- },
- {
- "toolkit": "github"
- }
- ]
- }
- }
- },
- "Minimal session": {
- "value": {
- "user_id": "user_123456789",
- "config": {}
- }
- },
- "Session with single toolkit": {
- "value": {
- "user_id": "user_123456789",
- "config": {
- "toolkits": [
- {
- "toolkit": "gmail"
- }
- ]
- }
- }
- }
- }
- }
- }
- },
- "responses": {
- "201": {
- "description": "Session successfully created. Returns the session ID and MCP server URL for the created session.",
- "content": {
- "application/json": {
- "schema": {
- "type": "object",
- "properties": {
- "session_id": {
- "type": "string",
- "description": "Generated session identifier",
- "example": "session_123456789"
- },
- "chat_session_mcp_url": {
- "type": "string",
- "format": "uri",
- "description": "MCP server endpoint URL for this specific chat session",
- "example": "https://api.composio.dev/v3/mcp/tool-router/session_123456789/mcp"
- },
- "tool_router_instance_mcp_url": {
- "type": "string",
- "format": "uri",
- "description": "MCP server endpoint URL for this specific tool router instance",
- "example": "https://api.composio.dev/v3/mcp/tool-router/session_123456789/mcp"
- }
- },
- "required": [
- "session_id",
- "chat_session_mcp_url",
- "tool_router_instance_mcp_url"
- ]
- }
- }
- }
- },
- "400": {
- "description": "Bad request. This may occur if the user_id format is invalid, toolkit names are invalid, or auth_config_id IDs are malformed.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- },
- "401": {
- "description": "Unauthorized. Authentication is required or the provided credentials are invalid.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- },
- "409": {
- "description": "Conflict. A session for this user with the same configuration already exists.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- },
- "500": {
- "description": "Internal server error. An unexpected error occurred while processing the request.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- }
- }
- }
- },
"/api/v3/tool_router/session": {
"post": {
"summary": "Create a new tool router session",
@@ -46421,9 +46191,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"requestBody": {
@@ -46524,10 +46291,18 @@
"format": "uri",
"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.",
"example": "https://your-app.com/auth/callback"
+ },
+ "enable_wait_for_connections": {
+ "type": "boolean",
+ "nullable": true,
+ "default": false,
+ "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.",
+ "example": false
}
},
"default": {
- "enable": true
+ "enable": true,
+ "enable_wait_for_connections": false
},
"additionalProperties": false,
"description": "Configuration for connection management settings"
@@ -46745,6 +46520,26 @@
},
"additionalProperties": false,
"description": "Configuration for workbench behavior"
+ },
+ "experimental": {
+ "type": "object",
+ "properties": {
+ "assistive_prompt_config": {
+ "type": "object",
+ "properties": {
+ "user_timezone": {
+ "type": "string",
+ "description": "IANA timezone identifier (e.g., 'America/New_York', 'Europe/London'). Used to customize the system prompt with timezone-aware instructions.",
+ "example": "America/New_York"
+ }
+ },
+ "additionalProperties": false,
+ "description": "Customize assistive prompt generation (e.g., timezone)."
+ }
+ },
+ "additionalProperties": false,
+ "description": "Experimental features - not stable, may be modified or removed in future versions.",
+ "x-experimental": true
}
},
"required": [
@@ -46980,17 +46775,7 @@
"tool_router_tools": {
"type": "array",
"items": {
- "type": "string",
- "enum": [
- "COMPOSIO_SEARCH_TOOLS",
- "COMPOSIO_MULTI_EXECUTE_TOOL",
- "COMPOSIO_MANAGE_CONNECTIONS",
- "COMPOSIO_REMOTE_WORKBENCH",
- "COMPOSIO_REMOTE_BASH_TOOL",
- "COMPOSIO_GET_TOOL_SCHEMAS",
- "COMPOSIO_UPSERT_RECIPE",
- "COMPOSIO_GET_RECIPE"
- ]
+ "type": "string"
},
"description": "List of available tools in this session"
},
@@ -47064,6 +46849,11 @@
"type": "string",
"format": "uri",
"description": "Custom callback URL for connected account auth flows"
+ },
+ "enable_wait_for_connections": {
+ "type": "boolean",
+ "default": false,
+ "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."
}
},
"description": "Manage connections configuration"
@@ -47202,6 +46992,21 @@
"user_id"
],
"description": "The session configuration including user, toolkits, and overrides"
+ },
+ "experimental": {
+ "type": "object",
+ "properties": {
+ "assistive_prompt": {
+ "type": "string",
+ "description": "The assistive system prompt to inject into your agent for optimal tool router usage",
+ "example": "You are an AI agent that completes user tasks by calling Composio ToolRouter meta-tools..."
+ }
+ },
+ "required": [
+ "assistive_prompt"
+ ],
+ "description": "Experimental features including the generated system prompt. Only returned on session creation, not on GET.",
+ "x-experimental": true
}
},
"required": [
@@ -47269,9 +47074,6 @@
{
"ApiKeyAuth": []
},
- {
- "CookieAuth": []
- },
{
"workbench_access_key": []
}
@@ -47429,9 +47231,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -47460,6 +47259,7 @@
"COMPOSIO_SEARCH_TOOLS",
"COMPOSIO_MULTI_EXECUTE_TOOL",
"COMPOSIO_MANAGE_CONNECTIONS",
+ "COMPOSIO_WAIT_FOR_CONNECTIONS",
"COMPOSIO_REMOTE_WORKBENCH",
"COMPOSIO_REMOTE_BASH_TOOL",
"COMPOSIO_GET_TOOL_SCHEMAS",
@@ -47594,9 +47394,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -47652,17 +47449,7 @@
"tool_router_tools": {
"type": "array",
"items": {
- "type": "string",
- "enum": [
- "COMPOSIO_SEARCH_TOOLS",
- "COMPOSIO_MULTI_EXECUTE_TOOL",
- "COMPOSIO_MANAGE_CONNECTIONS",
- "COMPOSIO_REMOTE_WORKBENCH",
- "COMPOSIO_REMOTE_BASH_TOOL",
- "COMPOSIO_GET_TOOL_SCHEMAS",
- "COMPOSIO_UPSERT_RECIPE",
- "COMPOSIO_GET_RECIPE"
- ]
+ "type": "string"
},
"description": "List of available tools in this session"
},
@@ -47736,6 +47523,11 @@
"type": "string",
"format": "uri",
"description": "Custom callback URL for connected account auth flows"
+ },
+ "enable_wait_for_connections": {
+ "type": "boolean",
+ "default": false,
+ "description": "Enable the COMPOSIO_WAIT_FOR_CONNECTIONS tool for polling connection status. Default false. May not work reliably with GPT models."
}
},
"description": "Manage connections configuration"
@@ -47940,9 +47732,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -48084,9 +47873,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"parameters": [
@@ -48224,6 +48010,118 @@
}
}
},
+ "/api/v3/tool_router/session/{session_id}/tools": {
+ "get": {
+ "summary": "List meta tools with schemas for a tool router session",
+ "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.",
+ "tags": [
+ "Tool Router"
+ ],
+ "operationId": "getToolRouterSessionBySessionIdTools",
+ "security": [
+ {
+ "ApiKeyAuth": []
+ }
+ ],
+ "parameters": [
+ {
+ "schema": {
+ "type": "string",
+ "format": "toolRouterSessionId",
+ "description": "Tool router session ID"
+ },
+ "required": false,
+ "description": "Tool router session ID",
+ "name": "session_id",
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ },
+ "responses": {
+ "200": {
+ "description": "Successfully retrieved meta tools with their complete schemas.",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "items": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Tool"
+ },
+ "description": "List of tools with their complete schemas"
+ }
+ },
+ "required": [
+ "items"
+ ]
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "Bad request",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "Unauthorized",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ },
+ "403": {
+ "description": "Forbidden",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Not found",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ },
+ "500": {
+ "description": "Internal server error",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Error"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"/api/v3/toolkits/changelog": {
"get": {
"summary": "Get toolkits changelog",
@@ -48235,9 +48133,6 @@
"security": [
{
"ApiKeyAuth": []
- },
- {
- "CookieAuth": []
}
],
"responses": {
diff --git a/docs/scripts/fetch-openapi.mjs b/docs/scripts/fetch-openapi.mjs
index 61230303d..2f105ffdf 100644
--- a/docs/scripts/fetch-openapi.mjs
+++ b/docs/scripts/fetch-openapi.mjs
@@ -14,6 +14,7 @@ const OPENAPI_URL = process.env.OPENAPI_SPEC_URL || 'https://backend.composio.de
// Endpoints to ignore (same as fern openapi-overrides.yml)
const IGNORED_PATHS = [
'/api/v3/mcp/validate/{uuid}',
+ '/api/v3/labs/tool_router/session',
'/api/v3/cli/get-session',
'/api/v3/cli/create-session',
'/api/v3/auth/session/logout',
@@ -79,6 +80,31 @@ async function fetchAndFilterSpec() {
spec.tags = spec.tags.filter(tag => !IGNORED_TAGS.includes(tag.name));
}
+ // Remove CookieAuth from security schemes
+ if (spec.components?.securitySchemes?.CookieAuth) {
+ delete spec.components.securitySchemes.CookieAuth;
+ console.log('Removed CookieAuth from securitySchemes');
+ }
+
+ // Remove CookieAuth from all endpoint security arrays
+ let cookieAuthRemovedCount = 0;
+ for (const methods of Object.values(spec.paths)) {
+ for (const operation of Object.values(methods)) {
+ if (operation.security) {
+ const originalLength = operation.security.length;
+ operation.security = operation.security.filter(sec => !('CookieAuth' in sec));
+ if (operation.security.length < originalLength) {
+ cookieAuthRemovedCount++;
+ }
+ // Remove empty security array
+ if (operation.security.length === 0) {
+ delete operation.security;
+ }
+ }
+ }
+ }
+ console.log(`Removed CookieAuth from ${cookieAuthRemovedCount} endpoint security definitions`);
+
console.log(`Removed ${removedCount} endpoints/operations`);
console.log(`Final spec has ${Object.keys(filteredPaths).length} paths`);