SDKs remove legacy automatic file handling config
The Composio SDKs no longer accept the legacy flags that previously controlled automatic file upload and download during tool execution. Automatic handling offile_uploadable fields stays off by default; you opt in with the explicit dangerously* option only.
SDK versions (minor releases)
Other
@composio/* npm packages that depend on core are published as patch bumps in the same release train (via the changesets updateInternalDependencies: "patch" setting) so they pick up the updated ComposioConfig surface — they have no public-API changes of their own.
Migration
Earlier SDK versions treated automatic file upload/download forfile_uploadable tool fields as on by default (TypeScript: autoUploadDownloadFiles defaulted to true when unset; Python followed the same idea for auto_upload_download_files in prior releases). That default is now off. If you still want that behavior, you must explicitly set dangerouslyAllowAutoUploadDownloadFiles: true (TypeScript) or dangerously_allow_auto_upload_download_files=True (Python).
TypeScript — before (legacy):
true to match either legacy pattern above):
dangerouslyAllowAutoUploadDownloadFiles or set it to false.
Python — before (legacy):
True to match either legacy pattern above):
ToolRouterSession directly (unusual), the keyword argument is now dangerously_allow_auto_upload_download_files instead of auto_upload_download_files.
Local paths must live inside an allowlisted directory
Even withdangerouslyAllowAutoUploadDownloadFiles enabled, the SDK will only auto-upload local file paths that resolve inside an allowlisted directory. Paths outside the allowlist are rejected with ComposioFileUploadPathNotAllowed (TypeScript) / FileUploadPathNotAllowed (Python) before any file is read or sent.
This is a behavior change. Earlier SDK versions had no allowlist: any local path the legacy default-on flag saw was uploaded.
Default allowlist:
URLs (
http://… / https://…) and JavaScript File objects are not subject to the allowlist — only local string paths are.
TypeScript:
composio.files.upload(...). That call bypasses the allowlist by design (the caller is expected to control the path), and the returned { name, mimetype, s3key } descriptor can be passed straight into tools.execute:
dangerously_allow_auto_upload_download_files=True and configure file_upload_dirs to cover the directories your code reads from.
What else changed
- TypeScript:
resolveAutoUploadDownloadFilesEnabledonly considersdangerouslyAllowAutoUploadDownloadFiles; the old deprecation warning for the legacy property is removed. - Python: the small
composio.utils.auto_upload_downloadhelper that merged legacy + new flags is removed;ToolsandToolRoutertake only the explicit opt-in boolean.
Link Auth Migration for Composio-Managed OAuth Connections
POST /api/v3/connected_accounts is being retired for Composio-managed OAuth connections. New organizations begin migrating on Friday, May 8, 2026, and all remaining organizations follow on Friday, July 3, 2026. Once migrated, affected requests receive 400 BadRequest with a message pointing at the replacement endpoint.
This does not affect custom auth configs (your own OAuth app) or non-OAuth schemes (API key, bearer token, basic auth, etc.) — those continue to work on POST /api/v3/connected_accounts unchanged. Only the specific combination of Composio-managed auth config + redirectable OAuth scheme (OAuth1, OAuth2, DCR_OAUTH) is moving.
What’s Changing
Why
When a connection is initiated through a default (Composio-managed) auth config, a Composio-owned OAuth application is acting on behalf of your integration. We want the end user to explicitly understand and acknowledge, at the moment of connection, that they are granting a third-party application access to their account on the external service. That acknowledgement is enforced by the/link flow, which routes the user through a consent screen before the connection is created. The legacy POST /api/v3/connected_accounts path allowed that step to be bypassed when credentials were passed in directly, which this change closes.
Custom auth configs are unaffected because they are backed by your own OAuth application — the consent screen is served by your app, so you already own that experience. This change is scoped specifically to default auth configs on redirectable schemes, where the third-party relationship is with Composio rather than with the developer.
Migration
Before — legacy create (will be rejected for Composio-managed OAuth):redirect_url (valid for 10 minutes) that the end user opens to authorize the integration, plus a connected_account_id you can use to poll for status or associate with your own records.
Error Response (after rollout)
Requests that hit the retired combination receive:What to Do
- If you use Composio-managed OAuth auth configs (OAuth1, OAuth2, or DCR_OAUTH) via
POST /api/v3/connected_accounts: switch toPOST /api/v3/connected_accounts/linkbefore your org’s cutover — Friday, May 8, 2026 for organizations created on or after that date, Friday, July 3, 2026 for all others. - If you already use
/link: no action required. - If you use custom OAuth apps (your own
client_id/client_secret) or non-OAuth auth (API key, bearer, etc.): no action required — the legacy endpoint continues to serve those cases.
Proxy execute now enforces same-domain endpoints
To prevent a connection’sAuthorization header from being forwarded to an unintended host, the proxy execute endpoint (POST /api/v3/tools/execute/proxy) now requires that the outbound endpoint URL share the same scheme and registrable domain (eTLD+1) as the connection’s resolved base_url.
Cross-subdomain requests on the same registrable domain continue to work — for example, a Gmail connection with base https://gmail.googleapis.com can still call https://www.googleapis.com/.... Relative endpoints (/users/me/messages) are resolved against the connection’s base_url as before and are unaffected.
Migration
If you currently pass an absolute URL that points at a different domain than your connection’sbase_url, switch to a relative endpoint (resolved against base_url) or an absolute URL under the same registrable domain.
Before — absolute URL on a different domain (will be rejected):
base_url:
What changed
- Absolute
endpointURLs on a different registrable domain than the connection’sbase_urlare rejected with HTTP400 OriginMismatch. The upstream request is never made. - Proxy calls that provide neither
connected_account_idnorcustom_connection_datanow return HTTP400 MissingAuthContextinstead of being forwarded without auth.
Examples
Assume a connected account whose toolkitbase_url is https://api.linear.app.
Allowed — relative endpoint:
What to do
- If you call proxy execute with absolute URLs, make sure the host matches (or is a subdomain of) the connection’s
base_url. - Prefer relative endpoints (
/path) — they are resolved againstbase_urland are not affected by this change. - If your integration legitimately needs to span multiple registrable domains for the same connection, reach out to us so we can add the additional host to the toolkit allowlist.