@devries-cameron20 / composio-1 / commits / 927d36b53
Fork 0

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

docs: update Python SDK reference from source (#4892)

## Summary Auto-generated Python SDK reference docs from `python/composio/`. Regenerates pages at `docs/content/reference/sdk-reference/python/` to reflect changes in the Python package's public API (new methods, updated signatures, changed types). Co-authored-by: jkomyno <12381818+jkomyno@users.noreply.github.com>

sdkrelease[bot] committed Oct 22, 2026 at 18:08 UTC 927d36b53b81006a1d65a36a137cb6ecb6326819
4 files changed +14 -9
docs/content/reference/sdk-reference/python/composio.mdx
+1 -1
@@ -14,4 +14,4 @@ description: "Composio SDK for Python. Generic parameters: TTool: The individua
14 | [`connected_accounts`](/reference/sdk-reference/python/connected-accounts) | `ConnectedAccounts` |
15 | [`mcp`](/reference/sdk-reference/python/mcp) | `MCP` |
16
17 -[View source](https://github.com/composiohq/composio/blob/next/python/composio/sdk.py#L88)
17 +[View source](https://github.com/composiohq/composio/blob/next/python/composio/sdk.py#L112)
docs/content/reference/sdk-reference/python/session.mdx
+11 -6
@@ -108,7 +108,7 @@ def search(query: str, model: str | None = ...) -> ToolRouterSessionSearchRespon
108 Execute a tool within the session. For custom tools, accepts the full slug (e.g. "LOCAL_GREP") or the original slug (e.g. "GREP") when that original slug is unique across the session's custom tools and toolkits. Custom tools are executed in-process; remote tools are sent to the Composio backend.
109
110 ```python
111 -def execute(tool_slug: str, arguments: Dict[str, Any | None] = ..., account: str | None = ...) -> ToolRouterSessionExecuteResponse
111 +def execute(tool_slug: str, arguments: Dict[str, Any | None] = ..., account: str | None = ..., input_responses: Dict[str, ToolRouterInputResponse | None] = ..., request_state: str | None = ...) -> ToolRouterSessionExecuteResponse
112 ```
113
114 **Parameters**
@@ -118,6 +118,8 @@ def execute(tool_slug: str, arguments: Dict[str, Any | None] = ..., account: str
118 | `tool_slug` | `str` |
119 | `arguments?` | `Dict[str, Any \| None]` |
120 | `account?` | `str \| None` |
121 +| `input_responses?` | `Dict[str, ToolRouterInputResponse \| None]` |
122 +| `request_state?` | `str \| None` |
123
124 **Returns**
125
@@ -135,7 +137,7 @@ def execute(tool_slug: str, arguments: Dict[str, Any | None] = ..., account: str
137 Execute a Composio meta tool (`COMPOSIO_*`) within the session. `execute` also runs meta tools. This method only accepts meta tool slugs, so a typo is a type error instead of a failed request. The call is sent to the Composio backend as is: custom tools named in a `COMPOSIO_MULTI_EXECUTE_TOOL` call are not run in-process here.
138
139 ```python
138 -def execute_meta(slug: ToolRouterSessionMetaToolSlug, arguments: Dict[str, Any | None] = ...) -> ToolRouterSessionExecuteResponse
140 +def execute_meta(slug: ToolRouterSessionMetaToolSlug, arguments: Dict[str, Any | None] = ..., input_responses: Dict[str, ToolRouterInputResponse | None] = ..., request_state: str | None = ...) -> ToolRouterSessionExecuteResponse
141 ```
142
143 **Parameters**
@@ -144,6 +146,8 @@ def execute_meta(slug: ToolRouterSessionMetaToolSlug, arguments: Dict[str, Any |
146 |------|------|
147 | `slug` | `ToolRouterSessionMetaToolSlug` |
148 | `arguments?` | `Dict[str, Any \| None]` |
149 +| `input_responses?` | `Dict[str, ToolRouterInputResponse \| None]` |
150 +| `request_state?` | `str \| None` |
151
152 **Returns**
153
@@ -220,7 +224,7 @@ def proxy_execute(toolkit: str, endpoint: str, method: Literal['GET', 'POST', 'P
224
225 **Returns**
226
223 -`ToolRouterSessionProxyExecuteResponse` — Proxied API response
227 +`ToolRouterSessionProxyExecuteResponse` — The proxied API response with `result_type="completed"`, or `result_type="blocked"` with the hook's `message` when a session hook blocked the request (it then has no `status`)
228
229 **Raises**
230
@@ -230,10 +234,10 @@ def proxy_execute(toolkit: str, endpoint: str, method: Literal['GET', 'POST', 'P
234
235 ### update()
236
233 -Partially update the session configuration. Only the fields provided are changed; omitted fields are preserved. For each policy block `None` removes the stored override (which can increase access: `toolkits=None` restores the unrestricted default, while `toolkits={"enable": []}` denies every app toolkit and is sent as-is). Supplied `tools`, `auth_configs` and `connected_accounts` maps replace the stored map entirely. Inside `manage_connections`, `callback_url=None` removes only the stored callback URL. Experimental `instant` accepts `False` to disable billed access or an object to set its filters; it does not accept `None`. Any object, even one that only sets `return_instant_charge` or `return_prices_in_search`, re-enables Instant usage on a Session set to `False`. `proxy_execute` takes a bool or `{"enable": bool}`; `True` exposes the `COMPOSIO_PROXY_EXECUTE` meta tool, `False` also turns off the sandbox `proxy_execute()` helper, and `None` removes the stored block. By default the request carries no precondition: the last writer wins. Pass `expected_config_version` (for example this object's `config_version`) to make the update conditional: the API then applies it only when the stored version still matches, and a concurrent change raises `SessionConfigConflictError` (HTTP 409) instead of being overwritten. The API must support the `expected_config_version` field; otherwise it rejects the request with a 400. `expected_config_version=False` is the same as omitting it. The PATCH is never retried by the transport, so a 409 is reported exactly once. On conflict this object stays unchanged: re-fetch the session with `composio.sessions.use(session_id)` and retry against the fresh `config_version`. `config`, `config_version` and `preload` are refreshed in place only after a successful response, and the updated `config` is returned. `workbench` is a backwards-compatible alias for `sandbox`. Prefer `sandbox` in new code. All other parameters use the same types as the generated `client.tool_router.session.patch()` method.
237 +Partially update the session configuration. Only the fields provided are changed; omitted fields are preserved. For each policy block `None` removes the stored override (which can increase access: `toolkits=None` restores the unrestricted default, while `toolkits={"enable": []}` denies every app toolkit and is sent as-is). Supplied `tools`, `auth_configs` and `connected_accounts` maps replace the stored map entirely. Inside `manage_connections`, `callback_url=None` removes only the stored callback URL. Experimental `instant` accepts `False` to disable billed access or an object to set its filters; it does not accept `None`. Any object, even one that only sets `return_instant_charge` or `return_prices_in_search`, re-enables Instant usage on a Session set to `False`. `proxy_execute` takes a bool or `{"enable": bool}`; `True` exposes the `COMPOSIO_PROXY_EXECUTE` meta tool, `False` also turns off the sandbox `proxy_execute()` helper, and `None` removes the stored block. `hooks` replaces the whole list of hooks, and `None` removes every hook. `hooks` cannot be combined with `experimental={'session_config_id': ...}` (`hooks=None` counts). By default the request carries no precondition: the last writer wins. Pass `expected_config_version` (for example this object's `config_version`) to make the update conditional: the API then applies it only when the stored version still matches, and a concurrent change raises `SessionConfigConflictError` (HTTP 409) instead of being overwritten. The API must support the `expected_config_version` field; otherwise it rejects the request with a 400. `expected_config_version=False` is the same as omitting it. The PATCH is never retried by the transport, so a 409 is reported exactly once. On conflict this object stays unchanged: re-fetch the session with `composio.sessions.use(session_id)` and retry against the fresh `config_version`. `config`, `config_version` and `preload` are refreshed in place only after a successful response, and the updated `config` is returned. `workbench` is a backwards-compatible alias for `sandbox`. Prefer `sandbox` in new code. All other parameters use the same types as the generated `client.tool_router.session.patch()` method.
238
239 ```python
236 -def update(toolkits: Union[session_patch_params.Toolkits | None, 'Omit'] = ..., instant: Union[Literal[False], ToolRouterInstantConfig, 'Omit'] = ..., tools: Union[Dict[str, session_patch_params.Tools | None], 'Omit'] = ..., tags: Union[session_patch_params.Tags | None, 'Omit'] = ..., auth_configs: Union[Dict[str, str | None], 'Omit'] = ..., connected_accounts: Union[Dict[str, SequenceNotStr[str | None]], 'Omit'] = ..., manage_connections: Union[session_patch_params.ManageConnections | None, ToolRouterUpdateManageConnectionsConfig | None, 'Omit'] = ..., sandbox: Union[session_patch_params.Workbench | None, 'Omit'] = ..., workbench: Union[session_patch_params.Workbench | None, 'Omit'] = ..., multi_account: Union[session_patch_params.MultiAccount | None, ToolRouterUpdateMultiAccountConfig | None, 'Omit'] = ..., proxy_execute: Union[Union[bool, ToolRouterProxyExecuteConfig | None], 'Omit'] = ..., preload: Union[session_patch_params.Preload | None, 'Omit'] = ..., search: Union[session_patch_params.Search | None, 'Omit'] = ..., execute: Union[session_patch_params.Execute | None, 'Omit'] = ..., experimental: Union[session_patch_params.Experimental | None, ToolRouterUpdateExperimentalConfig | None, 'Omit'] = ..., expected_config_version: Union[int, None, Literal[False]] = ...) -> ToolRouterSessionConfig
240 +def update(toolkits: Union[session_patch_params.Toolkits | None, 'Omit'] = ..., instant: Union[Literal[False], ToolRouterInstantConfig, 'Omit'] = ..., tools: Union[Dict[str, session_patch_params.Tools | None], 'Omit'] = ..., tags: Union[session_patch_params.Tags | None, 'Omit'] = ..., auth_configs: Union[Dict[str, str | None], 'Omit'] = ..., connected_accounts: Union[Dict[str, SequenceNotStr[str | None]], 'Omit'] = ..., manage_connections: Union[session_patch_params.ManageConnections | None, ToolRouterUpdateManageConnectionsConfig | None, 'Omit'] = ..., sandbox: Union[session_patch_params.Workbench | None, 'Omit'] = ..., workbench: Union[session_patch_params.Workbench | None, 'Omit'] = ..., multi_account: Union[session_patch_params.MultiAccount | None, ToolRouterUpdateMultiAccountConfig | None, 'Omit'] = ..., proxy_execute: Union[Union[bool, ToolRouterProxyExecuteConfig | None], 'Omit'] = ..., hooks: Union[List[ToolRouterHook | None], 'Omit'] = ..., preload: Union[session_patch_params.Preload | None, 'Omit'] = ..., search: Union[session_patch_params.Search | None, 'Omit'] = ..., execute: Union[session_patch_params.Execute | None, 'Omit'] = ..., experimental: Union[session_patch_params.Experimental | None, ToolRouterUpdateExperimentalConfig | None, 'Omit'] = ..., expected_config_version: Union[int, None, Literal[False]] = ...) -> ToolRouterSessionConfig
241 ```
242
243 **Parameters**
@@ -251,6 +255,7 @@ def update(toolkits: Union[session_patch_params.Toolkits | None, 'Omit'] = ...,
255 | `workbench?` | `Union[session_patch_params.Workbench \| None, 'Omit']` |
256 | `multi_account?` | `Union[session_patch_params.MultiAccount \| None, ToolRouterUpdateMultiAccountConfig \| None, 'Omit']` |
257 | `proxy_execute?` | `Union[Union[bool, ToolRouterProxyExecuteConfig \| None], 'Omit']` |
258 +| `hooks?` | `Union[List[ToolRouterHook \| None], 'Omit']` |
259 | `preload?` | `Union[session_patch_params.Preload \| None, 'Omit']` |
260 | `search?` | `Union[session_patch_params.Search \| None, 'Omit']` |
261 | `execute?` | `Union[session_patch_params.Execute \| None, 'Omit']` |
@@ -305,4 +310,4 @@ def delete() -> ToolRouterSessionDeleteResponse
310
311 ---
312
308 -[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L242)
313 +[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L318)
docs/content/reference/sdk-reference/python/tools.mdx
+1 -1
@@ -183,4 +183,4 @@ def proxy(endpoint: str, method: Literal['GET', 'POST', 'PUT', 'DELETE', 'PATCH'
183
184 ---
185
186 -[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tools.py#L249)
186 +[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tools.py#L368)
docs/content/reference/sdk-reference/python/triggers.mdx
+1 -1
@@ -247,4 +247,4 @@ async def webhook(request: Request):
247
248 ---
249
250 -[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/triggers.py#L1147)
250 +[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/triggers.py#L1146)