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 (#4614)
## 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
Sep 24, 2026 at 12:09 UTC
74f334ac6ead1934356ea27c30d2189c74bf5767
2 files changed
+13
-12
docs/content/reference/sdk-reference/python/auth-configs.mdx
+9
-9
@@ -71,7 +71,7 @@ def get(nanoid: str) -> auth_config_retrieve_response.AuthConfigRetrieveResponse
71
Updates an existing authentication configuration. This method allows you to modify properties of an auth config such as credentials, scopes, or tool restrictions. The update type (custom or default) determines which fields can be updated.
72
73
```python
74
-def update(nanoid: str, options: auth_config_update_params.AuthConfigUpdateParams) -> Dict
74
+def update(nanoid: str, options: auth_config_update_params.AuthConfigUpdateParams) -> auth_config_update_response.AuthConfigUpdateResponse
75
```
76
77
**Parameters**
@@ -83,7 +83,7 @@ def update(nanoid: str, options: auth_config_update_params.AuthConfigUpdateParam
83
84
**Returns**
85
86
-`Dict` — The updated auth config.
86
+`auth_config_update_response.AuthConfigUpdateResponse` — The update result with success and message fields.
87
88
---
89
@@ -92,7 +92,7 @@ def update(nanoid: str, options: auth_config_update_params.AuthConfigUpdateParam
92
Deletes an existing authentication configuration.
93
94
```python
95
-def delete(nanoid: str) -> Dict
95
+def delete(nanoid: str) -> auth_config_delete_response.AuthConfigDeleteResponse
96
```
97
98
**Parameters**
@@ -103,7 +103,7 @@ def delete(nanoid: str) -> Dict
103
104
**Returns**
105
106
-`Dict` — The deleted auth config.
106
+`auth_config_delete_response.AuthConfigDeleteResponse` — The deletion result with success and message fields.
107
108
---
109
@@ -112,7 +112,7 @@ def delete(nanoid: str) -> Dict
112
Enables an existing authentication configuration.
113
114
```python
115
-def enable(nanoid: str) -> Dict
115
+def enable(nanoid: str) -> auth_config_update_status_response.AuthConfigUpdateStatus...
116
```
117
118
**Parameters**
@@ -123,7 +123,7 @@ def enable(nanoid: str) -> Dict
123
124
**Returns**
125
126
-`Dict` — The enabled auth config.
126
+`auth_config_update_status_response.AuthConfigUpdateStatus...` — The status update result with success and message fields.
127
128
---
129
@@ -132,7 +132,7 @@ def enable(nanoid: str) -> Dict
132
Disables an existing authentication configuration.
133
134
```python
135
-def disable(nanoid: str) -> Dict
135
+def disable(nanoid: str) -> auth_config_update_status_response.AuthConfigUpdateStatus...
136
```
137
138
**Parameters**
@@ -143,8 +143,8 @@ def disable(nanoid: str) -> Dict
143
144
**Returns**
145
146
-`Dict` — The disabled auth config.
146
+`auth_config_update_status_response.AuthConfigUpdateStatus...` — The status update result with success and message fields.
147
148
---
149
150
-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/auth_configs.py#L18)
150
+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/auth_configs.py#L21)
docs/content/reference/sdk-reference/python/session.mdx
+4
-3
@@ -185,10 +185,10 @@ def proxy_execute(toolkit: str, endpoint: str, method: Literal['GET', 'POST', 'P
185
186
### update()
187
188
-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. 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.
188
+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 `premium_usage` 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_premium_charge`, re-enables premium usage on a Session set to `False`. 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.
189
190
```python
191
-def update(toolkits: Union[session_patch_params.Toolkits | None, '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'] = ..., 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
191
+def update(toolkits: Union[session_patch_params.Toolkits | None, 'Omit'] = ..., premium_usage: Union[Literal[False], ToolRouterPremiumUsageConfig, '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'] = ..., 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
192
```
193
194
**Parameters**
@@ -196,6 +196,7 @@ def update(toolkits: Union[session_patch_params.Toolkits | None, 'Omit'] = ...,
196
| Name | Type |
197
|------|------|
198
| `toolkits?` | `Union[session_patch_params.Toolkits \| None, 'Omit']` |
199
+| `premium_usage?` | `Union[Literal[False], ToolRouterPremiumUsageConfig, 'Omit']` |
200
| `tools?` | `Union[Dict[str, session_patch_params.Tools \| None], 'Omit']` |
201
| `tags?` | `Union[session_patch_params.Tags \| None, 'Omit']` |
202
| `auth_configs?` | `Union[Dict[str, str \| None], 'Omit']` |
@@ -258,4 +259,4 @@ def delete() -> ToolRouterSessionDeleteResponse
259
260
---
261
261
-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L154)
262
+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tool_router_session.py#L172)