composiohq__composio/python/CHANGELOG.md

Changelog

All notable changes to the Composio Python SDK will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Versions between 0.8.11 and 0.13.0 were released without CHANGELOG entries. See the Git commit log for changes in that window.

[0.15.0] - 2026-06-16

Fixed

• Forwarded user_id from triggers.create(..., user_id=...) into the trigger upsert request via extra_body, so 2FA-enabled trigger projects can verify the pinned connected account belongs to the caller.

Changed

• Bumped the Python SDK and provider packages from 0.14.0 to 0.15.0.

[0.14.0] - 2026-06-05

Removed

• Removed the legacy composio.tools.custom_tool registry path, including core.models.custom_tools, ExecuteRequestFn, the old fallback execution wiring, the old security tests, and the legacy custom-tools example.

Changed

• Kept custom tools on the 2026 tool-router surface: composio.experimental.tool(), composio.experimental.Toolkit, inline execution, preload/attach/use flows, and session.custom_tools().
• Bumped the Python SDK and provider packages from 0.13.1 to 0.14.0.

[0.13.1] - 2026-05-13

Added

• SHARED connected accounts (experimental): Connections can now be marked SHARED at create time and reached from a tool-router session by other user_ids when explicitly pinned and authorised via a per-user ACL. Mirrors the TypeScript SDK's @composio/core@0.10.0 release.
  • composio.connected_accounts.link(..., experimental={"account_type": "SHARED", "acl_config_for_shared": {...}}) to create.
  • composio.experimental.update_acl(nanoid, allow_all_users=..., allowed_user_ids=[...], not_allowed_user_ids=[...]) to update the per-user ACL on an existing SHARED connection. PATCH semantics: omit a field to leave it unchanged; pass [] to clear an allow/deny list.
  • session.authorize(toolkit, experimental={...}) for the same flow inside a tool-router session.
  • composio.connected_accounts.list(account_type='PRIVATE' | 'SHARED' | 'ALL') filter.
  • New typed errors: ComposioAclOnlyForSharedError, ComposioSharedAccessDeniedError, ComposioSharedConnectionNotAccessibleError.
  • Experimental — shape may change in future releases. Pinning a SHARED connection in a session config and direct execute by connected_account_id are unchanged.
• composio.experimental namespace: new module housing experimental SDK methods that take a client (update_acl) alongside the existing decorators (tool, Toolkit).

Fixed

• initiate() deprecation warning false-positives: the legacy POST /api/v3/connected_accounts deprecation warning is now gated on the response Deprecation HTTP header (RFC 9745) rather than the auth_scheme of the request. Custom auth configs and non-OAuth schemes no longer trigger a spurious warning. The legacy endpoint's retired-path 400 is also surfaced as a typed ComposioLegacyConnectedAccountsEndpointRetiredError. See https://docs.composio.dev/docs/changelog/2026/04/24.
• Schema converter nullability: null-only anyOf blocks now preserve nullability instead of dropping to a bare str fallback.

Changed

• Bumped composio-client dependency from 1.36.0 → 1.39.0 so the generated typed client carries the Experimental TypedDicts for the SHARED-connection surface.

[0.8.11] - 2025-09-10

Added

• Composio Connect Link Support: New link() method for creating external authentication links
  • Added link() method to ConnectedAccounts class for generating user authentication links
  • Support for callback URL redirection after authentication
  • Enhanced user experience with external link-based authentication flow
  • Includes comprehensive documentation and usage examples

Fixed

• Documentation: Fixed typo in connected account creation function docstring
  • Corrected "coneected" to "connected" in function documentation

[0.8.10] - 2024-12-19

Added

• LlamaIndex Provider: New LlamaIndex provider for enhanced AI framework integration
  • Complete provider implementation with demo and documentation (python/providers/llamaindex/)
  • Support for LlamaIndex-specific tool execution patterns
  • Includes provider.py, demo script, and proper packaging setup

Changed

• Schema Parsing: Improved OpenAPI schema parsing with default fallback to 'any' type for invalid schemas
  • Enhanced python/composio/utils/openapi.py to handle malformed schemas gracefully
  • More robust type inference for edge cases where schema type is missing or invalid

Fixed

• Type Checking: Fixed type checking issues in core validation logic
  • Updated python/composio/core/models/toolkits.py for better type safety
  • Added proper type annotations and validation
• Sentinel Value Checks: Fixed sentinel value validation in core models
  • Enhanced validation in python/composio/core/models/toolkits.py
  • Improved handling in python/composio/core/models/tools.py and python/composio/core/models/triggers.py
  • Added proper sentinel value checks in python/composio/types.py
• Build System: Updated noxfile.py for improved development workflow

[0.8.9] - 2024-11-XX

Added

• Initial stable release with core functionality
• Support for multiple AI frameworks (OpenAI, Anthropic, Google, etc.)
• Comprehensive tool execution capabilities
• Authentication and connected account management
• File upload and download support
• Webhook and trigger system
• Multi-provider support architecture

Features

• Tool discovery and execution
• Connected account management
• Authentication configuration
• File handling and processing
• Webhook integration
• Trigger system for automated workflows
• Support for custom tools and integrations

---

Version History

For detailed commit history and technical changes, see the Git commit log.

Support

For questions, issues, or contributions, please visit:

• GitHub Repository
• Documentation
• Community Discord