Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | --- |
| 2 | title: 'Python SDK 0.29.0: toolkit warnings and provider argument fixes' |
| 3 | description: 'Get toolkit sunset warnings, preserve tool arguments across Python providers, and migrate direct HTTP clients.' |
| 4 | date: '2026-10-22' |
| 5 | --- |
| 6 | |
| 7 | The Python SDK now warns when the API reports that a toolkit version you use is deprecated. This release also fixes tool argument serialization and preserves more of your schemas across providers. |
| 8 | |
| 9 | ### Release versions |
| 10 | |
| 11 | | SDK | Version | |
| 12 | | ----------------- | -------- | |
| 13 | | Python `composio` | `0.29.0` | |
| 14 | |
| 15 | All 13 Python provider packages are released at `0.29.0`. |
| 16 | |
| 17 | ### What's new |
| 18 | |
| 19 | - **Toolkit deprecation warnings.** The SDK warns once per process for each deprecated toolkit version reported through the `Composio-Deprecated-Toolkits` response header. The warning names the version, its sunset date, and how to pin a newer version. See [toolkit versioning](/docs/tools-direct/toolkit-versioning#deprecation-and-sunset). |
| 20 | |
| 21 | ### Migration notes |
| 22 | |
| 23 | <Callout type="warn"> |
| 24 | Direct construction of `composio.client.HttpClient` now takes `auth` and `scope` instead of |
| 25 | credential keywords and scope headers. It no longer accepts `default_query`. The main |
| 26 | `Composio(api_key=...)` constructor keeps its credential options, and Python still reads |
| 27 | `COMPOSIO_CUSTOM_HEADERS`. |
| 28 | </Callout> |
| 29 | |
| 30 | If you construct `HttpClient` directly, replace the credential keywords with an `auth` value: |
| 31 | |
| 32 | Before: `HttpClient(provider="openai", api_key=key)`. |
| 33 | |
| 34 | After: `HttpClient(provider="openai", auth=ProjectAuth(key))`, importing `ProjectAuth` from `composio_client`. |
| 35 | |
| 36 | For organization and project routing, replace scope headers with `scope=Scope(organization_id=org_id, project_id=project_id)`, importing `Scope` from `composio_client`. Remove `default_query` from direct client construction. |
| 37 | |
| 38 | ### Bug fixes |
| 39 | |
| 40 | - **Pydantic aliases.** Tool execution serializes Pydantic arguments with their declared aliases, including nested models and explicit serialization aliases. |
| 41 | - **Provider arguments.** AutoGen and Google ADK preserve and validate free-form arguments instead of dropping them. OpenAI Agents preserves the source schema's `additionalProperties`. See the [provider behavior changes and limitations](/docs/changelog/2026/10/20). |
| 42 | - **Google ADK nested arrays.** The provider preserves nested array item schemas instead of replacing them with a flat string schema. |