Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: update Python SDK reference from source (#3612)
sdkrelease[bot]0b1e47847607
diff --git a/docs/content/reference/sdk-reference/python/auth-configs.mdx b/docs/content/reference/sdk-reference/python/auth-configs.mdxindex 8e8194d26..edb77553c 100644--- a/docs/content/reference/sdk-reference/python/auth-configs.mdx+++ b/docs/content/reference/sdk-reference/python/auth-configs.mdx@@ -1,6 +1,6 @@----title: AuthConfigs-description: Manage authentication configurations.+title: "AuthConfigs"+description: "Manage authentication configurations."---## Methodsdiff --git a/docs/content/reference/sdk-reference/python/composio.mdx b/docs/content/reference/sdk-reference/python/composio.mdxindex 0c02f909e..1cad50bd6 100644--- a/docs/content/reference/sdk-reference/python/composio.mdx+++ b/docs/content/reference/sdk-reference/python/composio.mdx@@ -1,5 +1,5 @@----title: Composio+title: "Composio"description: "Composio SDK for Python. Generic parameters: TTool: The individual tool type returned by the provider (e.g., ChatCompletionToolParam for OpenAI). ..."---@@ -14,96 +14,4 @@ description: "Composio SDK for Python. Generic parameters: TTool: The individua| [`connected_accounts`](/reference/sdk-reference/python/connected-accounts) | `ConnectedAccounts` || [`mcp`](/reference/sdk-reference/python/mcp) | `MCP` |-[View source](https://github.com/composiohq/composio/blob/next/python/composio/sdk.py#L46)-------## Constructor--```python-Composio(- provider: BaseProvider | None = None,- *,- api_key: str | None = None,- base_url: str | None = None,- timeout: int | None = None,- max_retries: int | None = None,- toolkit_versions: dict[str, str] | str | None = None,- dangerously_allow_auto_upload_download_files: bool = False,- sensitive_file_upload_protection: bool = True,- file_upload_path_deny_segments: Sequence[str] | None = None,- file_upload_dirs: Sequence[str] | Literal[False] | None = None,- file_download_dir: str | None = None,- allow_tracking: bool = True,- environment: str = "production",-)-```--`api_key` falls back to `os.environ["COMPOSIO_API_KEY"]` when not passed.--### Common options--| Option | Type | Default | Description |-|--------|------|---------|-------------|-| `provider` | `BaseProvider` | `OpenAIProvider()` | Provider used to wrap tools (Anthropic, LangChain, Gemini, etc.). |-| `api_key` | `str` | `$COMPOSIO_API_KEY` | API key. Required. |-| `base_url` | `str` | Composio default | Override the API base URL. |-| `timeout` | `int` | client default | Per-request timeout in seconds. |-| `max_retries` | `int` | `3` | HTTP client retry count. |-| `toolkit_versions` | `dict \| str \| None` | `'latest'` | Pin toolkit versions globally (string) or per-toolkit (dict). |-------## File upload security--Automatic file handling for `file_uploadable` tool fields is **off by default**. Set `dangerously_allow_auto_upload_download_files=True` to opt in. Once on, the SDK can read local paths and stage them to S3 on your behalf, but only from an allowlisted set of directories.--| Option | Type | Default | Description |-|--------|------|---------|-------------|-| `dangerously_allow_auto_upload_download_files` | `bool` | `False` | Master opt-in. When `False`, paths and URLs in `file_uploadable` arguments are forwarded as-is — the backend will reject anything that isn't already a staged `{name, mimetype, s3key}` descriptor. Set to `True` to let the SDK stage local paths and URLs on your behalf at execute time. |-| `sensitive_file_upload_protection` | `bool` | `True` | Block local paths matching a built-in denylist of segments (`.ssh`, `.aws`, etc.) and credential-like file names. Disable only if you accept the tradeoff. |-| `file_upload_path_deny_segments` | `Sequence[str] \| None` | `None` | Extra single path components merged with the built-in denylist. |-| `file_upload_dirs` | `Sequence[str] \| Literal[False] \| None` | `[~/.composio/temp]` | Allowlist of directories the SDK may read during **automatic** upload. Pass `False` (or `[]`) to reject every local path — URLs still work. Providing a list **replaces** the default; include `~/.composio/temp` explicitly if you want the default staging dir to keep working. Comparison is on a path-component boundary after `os.path.realpath`. On Windows, entries are compared case-insensitively. |-| `file_download_dir` | `str \| None` | `~/.composio/files` | Directory where files from tool responses marked `file_downloadable` are streamed. |--Per-execution hooks live on the `modifiers=[...]` argument to `composio.tools.execute`, not on the constructor. Use the `@before_file_upload` decorator from `composio.core.models._modifiers` to inspect or rewrite each path before it is read. The hook context includes a `source` field (`'path' | 'url'`) so you can branch on local paths vs URLs.--**Related errors:** `FileUploadPathNotAllowed`, `SensitiveFilePathBlocked`, `FileUploadAbortedError`, `SDKFileNotFoundError` (all from `composio.exceptions`).--### Restricting automatic uploads to specific directories--When `dangerously_allow_auto_upload_download_files=True`, the SDK only reads local files from directories listed in `file_upload_dirs`. This stacks with (it does NOT replace) the sensitive-path denylist.--```python-from composio import Composio--composio = Composio(- api_key="your_composio_key",- dangerously_allow_auto_upload_download_files=True,- # Replaces the default `[~/.composio/temp]`. List every directory you want- # the SDK to read from during tool execution.- file_upload_dirs=["/srv/agent/uploads", "~/.composio/temp"],-)-```--Pass `file_upload_dirs=False` (or `[]`) to reject every filesystem path; URLs and in-memory bytes still upload normally:--```python-Composio(- api_key="your_composio_key",- dangerously_allow_auto_upload_download_files=True,- file_upload_dirs=False,-)-```--### Tool-Router session files--The Tool-Router session API exposes a separate files surface (`session.files.upload(...)` / `session.files.download(...)`) for streaming files into and out of a long-running router session. Those calls are unrelated to the `file_uploadable` schema flow on individual tool execution and are not gated by `dangerously_allow_auto_upload_download_files` or `file_upload_dirs`. See [`tool-router-session`](/reference/sdk-reference/python/tool-router-session) for usage.-------## See also--- [Executing tools](/docs/tools-direct/executing-tools) — automatic vs. manual file handling, before-execute modifiers.-- [Before-execution modifiers](/docs/tools-direct/modify-tool-behavior/before-execution-modifiers#before-file-upload-python) — `@before_file_upload` decorator and the context-form hook signature.-- [Legacy auto-upload config removal changelog](/docs/changelog/2026/04/24) — migration from the removed `auto_upload_download_files` flag and the allowlist semantics matrix.+[View source](https://github.com/composiohq/composio/blob/next/python/composio/sdk.py#L49)diff --git a/docs/content/reference/sdk-reference/python/connected-accounts.mdx b/docs/content/reference/sdk-reference/python/connected-accounts.mdxindex 0753a39e3..80c5e4e43 100644--- a/docs/content/reference/sdk-reference/python/connected-accounts.mdx+++ b/docs/content/reference/sdk-reference/python/connected-accounts.mdx@@ -1,6 +1,6 @@----title: ConnectedAccounts-description: Manage connected accounts. This class is used to manage connected accounts in the Composio SDK. These are used to authenticate with third-party se...+title: "ConnectedAccounts"+description: "Manage connected accounts. This class is used to manage connected accounts in the Composio SDK. These are used to authenticate with third-party se..."---## Methods@@ -39,7 +39,7 @@ def update(nanoid: str, alias: str | None = ..., connection: connected_account_p### initiate()-Compound function to create a new connected account. This function creates a new connected account and returns a connection request. Users can then wait for the connection to be established using the `wait_for_connection` method.+Compound function to create a new connected account. This function creates a new connected account and returns a connection request. Users can then wait for the connection to be established using the ``wait_for_connection`` method. .. deprecated:: For Composio-managed (default) auth configs on redirectable OAuth schemes (OAuth1, OAuth2, DCR_OAUTH), the legacy endpoint this method wraps is being retired: **2026-05-08** for new organizations and **2026-07-03** for all remaining organizations. After your org's cutover, this method will raise :class:`composio.exceptions.ComposioLegacyConnectedAccountsEndpointRetiredError` for that specific combination. Use :meth:`ConnectedAccounts.link` for Composio-managed OAuth — it works for every redirectable scheme regardless of whether the auth config is Composio-managed or custom, and the return shape is the same. Custom auth configs (your own OAuth app) and non-OAuth schemes (API key, bearer token, basic auth) are unaffected and continue to work on ``initiate()``. See https://docs.composio.dev/docs/changelog/2026/04/24```pythondef initiate(user_id: str, auth_config_id: str, callback_url: str | None = ..., allow_multiple: bool = ..., config: connected_account_create_params.ConnectionState | None = ..., alias: str | None = ...) -> ConnectionRequest@@ -67,7 +67,7 @@ def initiate(user_id: str, auth_config_id: str, callback_url: str | None = ...,Create a Composio Connect Link for a user to connect their account to a given auth config. This method will return an external link which you can use for the user to connect their account.```python-def link(user_id: str, auth_config_id: str, callback_url: str | None = ..., alias: str | None = ...) -> ConnectionRequest+def link(user_id: str, auth_config_id: str, callback_url: str | None = ..., alias: str | None = ..., allow_multiple: bool = ..., experimental: link_create_params.Experimental | None = ...) -> ConnectionRequest```**Parameters**@@ -78,6 +78,8 @@ def link(user_id: str, auth_config_id: str, callback_url: str | None = ..., alia| `auth_config_id` | `str` || `callback_url?` | `str \| None` || `alias?` | `str \| None` |+| `allow_multiple?` | `bool` |+| `experimental?` | `link_create_params.Experimental \| None` |**Returns**@@ -105,6 +107,18 @@ def link(user_id: str, auth_config_id: str, callback_url: str | None = ..., alia# Wait for the connection to be establishedconnected_account = composio.connected_accounts.wait_for_connection(connection_request.id)++ connection_request = composio.connected_accounts.link(+ 'user_creator',+ 'auth_config_123',+ experimental={+ 'account_type': 'SHARED',+ 'acl_config_for_shared': {+ 'allow_all_users': True,+ 'not_allowed_user_ids': ['user_bob'],+ },+ },+ )```---@@ -130,4 +144,4 @@ def wait_for_connection(id: str, timeout: float | None = ...) -> connected_accou----[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/connected_accounts.py#L321)+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/connected_accounts.py#L340)diff --git a/docs/content/reference/sdk-reference/python/index.mdx b/docs/content/reference/sdk-reference/python/index.mdxindex d0311f5de..b404f2670 100644--- a/docs/content/reference/sdk-reference/python/index.mdx+++ b/docs/content/reference/sdk-reference/python/index.mdx@@ -1,6 +1,6 @@----title: Python SDK Reference-description: API reference for the Composio Python SDK+title: "Python SDK Reference"+description: "API reference for the Composio Python SDK"---# Python SDK Reference@@ -55,7 +55,7 @@ result = composio.tools.execute(### before_execute-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L183)+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L280)```python@before_execute(modifier: BeforeExecute | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)@@ -65,7 +65,7 @@ def my_modifier(...):### after_execute-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L144)+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L241)```python@after_execute(modifier: AfterExecute | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)@@ -75,19 +75,19 @@ def my_modifier(...):### before_file_upload-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L236)+Build a ``Modifier`` for the file-upload hook (same scoping pattern as :func:`before_execute`). Your callable may take **either**: - a single ``context`` argument (:class:`BeforeFileUploadContext`) — the preferred form, exposes ``context["source"]`` (``"path"`` or ``"url"``), or - three positional arguments ``(path, tool, toolkit)`` — legacy form, kept for back-compat. Return a new path/URL string to substitute, or ``False`` to abort the upload (raises :class:`~composio.exceptions.FileUploadAbortedError`). Pass the returned ``Modifier`` in ``modifiers=[...]`` on :meth:`composio.core.models.tools.Tools.execute` or ``tools.get``. Multiple such modifiers are composed in list order.++[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L319)```python-@before_file_upload(modifier: BeforeFileUploadCallable | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)-def my_modifier(path: str, tool: str, toolkit: str) -> str | bool:+@before_file_upload(modifier: BeforeFileUploadLike | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)+def my_modifier(...):...```-Builds a [Modifier](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py) for the file-upload hook. See [Before file upload (Python)](/docs/tools-direct/modify-tool-behavior/before-execution-modifiers#before-file-upload-python) for usage and examples.-### schema_modifier-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L222)+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L377)```python@schema_modifier(modifier: SchemaModifier | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)diff --git a/docs/content/reference/sdk-reference/python/mcp.mdx b/docs/content/reference/sdk-reference/python/mcp.mdxindex 8da79747c..ee30f448c 100644--- a/docs/content/reference/sdk-reference/python/mcp.mdx+++ b/docs/content/reference/sdk-reference/python/mcp.mdx@@ -1,6 +1,6 @@----title: MCP-description: MCP (Model Control Protocol) class. Provides enhanced MCP server operations This matches the TypeScript ExperimentalMCP class functionality.+title: "MCP"+description: "MCP (Model Control Protocol) class. Provides enhanced MCP server operations This matches the TypeScript ExperimentalMCP class functionality."---## Methods@@ -247,4 +247,4 @@ def generate(user_id: str, mcp_config_id: str, manually_manage_connections: bool----[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/mcp.py#L88)+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/mcp.py#L104)diff --git a/docs/content/reference/sdk-reference/python/session-context-impl.mdx b/docs/content/reference/sdk-reference/python/session-context-impl.mdxindex 1962a4c28..04c705a27 100644--- a/docs/content/reference/sdk-reference/python/session-context-impl.mdx+++ b/docs/content/reference/sdk-reference/python/session-context-impl.mdx@@ -1,6 +1,6 @@----title: SessionContextImpl-description: Concrete implementation of SessionContext. One instance is created per session (singleton) and shared across all custom tool invocations. When ``c...+title: "SessionContextImpl"+description: "Concrete implementation of SessionContext. One instance is created per session (singleton) and shared across all custom tool invocations. When ``c..."---## Properties@@ -56,4 +56,4 @@ def proxy_execute(toolkit: str, endpoint: str, method: Literal['GET', 'POST', 'P----[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/session_context.py#L87)+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/session_context.py#L92)diff --git a/docs/content/reference/sdk-reference/python/tool-router-session.mdx b/docs/content/reference/sdk-reference/python/tool-router-session.mdxindex 41b62a91a..3323faa94 100644--- a/docs/content/reference/sdk-reference/python/tool-router-session.mdx+++ b/docs/content/reference/sdk-reference/python/tool-router-session.mdx@@ -1,5 +1,5 @@----title: ToolRouterSession+title: "ToolRouterSession"description: "Tool router session containing session information and methods. Generic Parameters: TTool: The individual tool type returned by the provider. TToo..."---@@ -10,6 +10,7 @@ description: "Tool router session containing session information and methods. G| `session_id` | `str` || `mcp` | `Any` || `experimental` | `'ToolRouterSessionExperimental'` |+| `preload` | `Any` |## Methods@@ -38,7 +39,7 @@ def tools(modifiers: 'Modifiers' | None = ...) -> TToolCollectionAuthorize a toolkit for the user and get a connection request. Initiates the OAuth flow and returns a ConnectionRequest with redirect URL.```python-def authorize(toolkit: str, callback_url: str | None = ..., alias: str | None = ...) -> ConnectionRequest+def authorize(toolkit: str, callback_url: str | None = ..., alias: str | None = ..., experimental: session_link_params.Experimental | None = ...) -> ConnectionRequest```**Parameters**@@ -48,6 +49,7 @@ def authorize(toolkit: str, callback_url: str | None = ..., alias: str | None =| `toolkit` | `str` || `callback_url?` | `str \| None` || `alias?` | `str \| None` |+| `experimental?` | `session_link_params.Experimental \| None` |**Returns**@@ -102,10 +104,10 @@ def search(query: str, model: str | None = ...) -> SessionSearchResponse### execute()-Execute a tool within the session. For custom tools, accepts the original slug (e.g. "GREP") or the full slug (e.g. "LOCAL_GREP"). Custom tools are executed in-process; remote tools are sent to the Composio backend. Both paths return a ``SessionExecuteResponse`` with ``data``, ``error``, and ``log_id`` attributes.+Execute a tool within the session. For custom tools, accepts the original slug (e.g. "GREP") or the full slug (e.g. "LOCAL_GREP"). Custom tools are executed in-process; remote tools are sent to the Composio backend.```python-def execute(tool_slug: str, arguments: Dict[str, Any | None] = ...) -> SessionExecuteResponse+def execute(tool_slug: str, arguments: Dict[str, Any | None] = ..., account: str | None = ...) -> SessionExecuteResponse```**Parameters**@@ -114,6 +116,7 @@ def execute(tool_slug: str, arguments: Dict[str, Any | None] = ...) -> SessionEx|------|------|| `tool_slug` | `str` || `arguments?` | `Dict[str, Any \| None]` |+| `account?` | `str \| None` |**Returns**@@ -179,4 +182,28 @@ def proxy_execute(toolkit: str, endpoint: str, method: Literal['GET', 'POST', 'P----[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L53)+### update()++Partially update the session configuration. Only the fields provided will be changed; omitted fields are preserved. Mutates this session's ``preload`` in-place. Pass ``None`` for ``manage_connections``, ``workbench``, or ``multi_account`` to clear the stored value. All parameters use the same types as the Stainless-generated ``client.tool_router.session.patch()`` method.++```python+def update(toolkits: Union[session_patch_params.Toolkits, 'Omit'] = ..., tools: Union[Dict[str, session_patch_params.Tools], 'Omit'] = ..., tags: Union[session_patch_params.Tags, 'Omit'] = ..., auth_configs: Union[Dict[str, str], 'Omit'] = ..., connected_accounts: Union[Dict[str, SequenceNotStr[str | None]], 'Omit'] = ..., manage_connections: Union[session_patch_params.ManageConnections | None, 'Omit'] = ..., workbench: Union[session_patch_params.Workbench | None, 'Omit'] = ..., multi_account: Union[session_patch_params.MultiAccount | None, 'Omit'] = ..., preload: Union[session_patch_params.Preload, 'Omit'] = ...) -> None+```++**Parameters**++| Name | Type |+|------|------|+| `toolkits?` | `Union[session_patch_params.Toolkits, 'Omit']` |+| `tools?` | `Union[Dict[str, session_patch_params.Tools], 'Omit']` |+| `tags?` | `Union[session_patch_params.Tags, 'Omit']` |+| `auth_configs?` | `Union[Dict[str, str], 'Omit']` |+| `connected_accounts?` | `Union[Dict[str, SequenceNotStr[str \| None]], 'Omit']` |+| `manage_connections?` | `Union[session_patch_params.ManageConnections \| None, 'Omit']` |+| `workbench?` | `Union[session_patch_params.Workbench \| None, 'Omit']` |+| `multi_account?` | `Union[session_patch_params.MultiAccount \| None, 'Omit']` |+| `preload?` | `Union[session_patch_params.Preload, 'Omit']` |++---++[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L80)diff --git a/docs/content/reference/sdk-reference/python/toolkits.mdx b/docs/content/reference/sdk-reference/python/toolkits.mdxindex ad79a68e9..399b430f9 100644--- a/docs/content/reference/sdk-reference/python/toolkits.mdx+++ b/docs/content/reference/sdk-reference/python/toolkits.mdx@@ -1,5 +1,5 @@----title: Toolkits+title: "Toolkits"description: "Toolkits are a collectiono of tools that can be used to perform various tasks. They're conceptualized as a set of tools. Ex: Github toolkit can per..."---diff --git a/docs/content/reference/sdk-reference/python/tools.mdx b/docs/content/reference/sdk-reference/python/tools.mdxindex 64f442764..5cd8a436b 100644--- a/docs/content/reference/sdk-reference/python/tools.mdx+++ b/docs/content/reference/sdk-reference/python/tools.mdx@@ -1,6 +1,6 @@----title: Tools-description: Tools class definition This class is used to manage tools in the Composio SDK. It provides methods to list, get, and execute tools. Generic Param...+title: "Tools"+description: "Tools class definition This class is used to manage tools in the Composio SDK. It provides methods to list, get, and execute tools. Generic Param..."---## Methods@@ -51,7 +51,7 @@ def get_raw_composio_tools(tools: list[str | None] = ..., search: str | None = .### get_raw_tool_router_meta_tools()-Fetches the meta tools for a tool router session. This method fetches the meta tools from the Composio API and transforms them to the expected format. It provides access to the underlying meta tool data without provider-specific wrapping.+Fetches the tools exposed by a tool router session. This method fetches helper/meta tools and any preloaded app tools from the Composio API and transforms them to the expected format. It provides access to the underlying tool data without provider-specific wrapping.```pythondef get_raw_tool_router_meta_tools(session_id: str, modifiers: 'Modifiers' | None = ...) -> list[Tool]@@ -128,7 +128,7 @@ def get(user_id: str, slug: str | None = ..., tools: list[str | None] = ..., sea### execute()-Execute a tool with the provided parameters. This method calls the Composio API or a custom tool handler to execute the tool and returns the response. It automatically determines whether to use a custom tool or a Composio API tool based on the slug.+Execute a tool with the provided parameters. This method calls the Composio API to execute the tool and returns the response.```pythondef execute(slug: str, arguments: Dict, connected_account_id: str | None = ..., custom_auth_params: tool_execute_params.CustomAuthParams | None = ..., custom_connection_data: tool_execute_params.CustomConnectionData | None = ..., user_id: str | None = ..., text: str | None = ..., version: str | None = ..., dangerously_skip_version_check: bool | None = ..., modifiers: Modifiers | None = ...) -> ToolExecutionResponse@@ -180,4 +180,4 @@ def proxy(endpoint: str, method: Literal['GET', 'POST', 'PUT', 'DELETE', 'PATCH'----[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tools.py#L80)+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tools.py#L89)diff --git a/docs/content/reference/sdk-reference/python/triggers.mdx b/docs/content/reference/sdk-reference/python/triggers.mdxindex b704b6511..118505cb1 100644--- a/docs/content/reference/sdk-reference/python/triggers.mdx+++ b/docs/content/reference/sdk-reference/python/triggers.mdx@@ -1,6 +1,6 @@----title: Triggers-description: Triggers (instance) class+title: "Triggers"+description: "Triggers (instance) class"---## Methods@@ -156,4 +156,4 @@ def verify_webhook(id: str, payload: str, secret: str, signature: str, timestamp----[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/triggers.py#L701)+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/triggers.py#L865)