ComposioHQ/composio
Documented errors, page 2 of 3. Back to ComposioHQ/composio
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Invalid chunked trigger data format | exception | error | pusher, chunking, realtime, data-format, triggers |
| Refusing to auto-upload | exception | error | file-upload, security, allowlist, configuration |
| URL file uploads are not supported in edge runtimes because… | exception | error | ssrf, edge-runtime, cloudflare-workers, file-upload, platform-limitation |
| Custom tool slug collision: original slug | validation | error | custom-tools, slug-collision, validation, typescript |
| JSON Schema exceeds maximum nesting depth of | validation | error | json-schema, nesting-depth, strict-schema, recursion |
| experimental_subAgent() could not determine an agent CLI… | exception | error | subagent, cli-not-found, path, environment |
| Invalid afterExecute modifier. Not a function. | exception | error | modifiers, typescript, validation |
| JSON Schema $ref chain exceeded depth cap | exception | error | json-schema, ref-cycle, depth-limit, python |
| No Default auth config found for toolkit | exception | error | auth-config, authorize, default-config, toolkit, typescript |
| proxy_execute: parameters | validation | error | python, session, validation, parameters |
| Could not determine a home directory to store the Composio… | exception | error | python, custom-tools, validation, toolkit |
| Failed to upload to S3 | exception | error | python, custom-tools, slug, collision, validation |
| No upstream license file found in platform-imessage… | exception | error | licensing, build-script, submodule |
| Swift build completed but | exception | error | swift, build-artifact, release-build |
| Invalid tool proxy parameters | validation | error | composio, zod, validation, proxy, typescript |
| Refusing to fetch " " — it resolves to a private, loopback… | exception | error | ssrf, security, network, private-ip, url-validation |
| URL returned redirect. Please provide a direct URL to the… | validation | error | python, files, upload, redirect, url-fetch |
| proxy_execute: parameters | validation | error | python, session, validation, parameters |
| Tool arguments must resolve to an object, received | validation | error | tool-arguments, type-mismatch, invalid-params |
| Failed to initialize Pusher client | exception | error | pusher, initialization, realtime, typescript |
| Request was cancelled by the caller | exception | info | abort, cancellation, network, typescript |
| The webhook timestamp is outside the allowed tolerance. The… | exception | error | webhook, replay-protection, clock-skew, tolerance, typescript |
| Failed to parse file delete response | validation | error | validation, zod, api-contract, delete, file-mount |
| Missing required flag | exception | error | cli, flags, argv, subagent |
| Refusing to fetch: too many redirects | exception | error | network, http, redirect, python |
| experimental_subAgent() structured output failed schema… | validation | error | subagent, zod, schema, llm-output |
| proxy_execute: method must be one of | validation | error | python, session, validation, http-method |
| Bundled FFI library was not found for . | exception | error | ffi, native-library, local-tools, packaging |
| Failed to convert JSON Schema to Zod Schema | exception | error | json-schema, zod, conversion, typescript |
| Failed to parse connected account ACL update params | validation | error | acl, connected-accounts, zod, validation, experimental |
| Failed to parse create connected account link options | validation | error | validation, zod, connected-accounts, typescript |
| Invalid params passed for Get Instance Params | validation | error | mcp, zod, validation, typescript |
| Refusing to build a path from a reserved device name as | validation | critical | windows, reserved-names, security, python |
| Failed to fetch file from URL | validation | error | python, files, upload, url-fetch, network |
| Provide query or recipients to find an iMessage thread. | exception | warning | validation, imessage, local-tools |
| Refusing to write that is a reserved device name | exception | critical | windows, reserved-names, python, security |
| Use only one of before or after. | exception | warning | pagination, local-tools, imessage, validation |
| Failed to fetch file from URL | exception | error | python, custom-tools, preload, validation, legacy-api |
| Refusing to write containing characters reserved by Windows | exception | error | windows, filename-validation, python |
| JSON Schema node depth exceeded cap | exception | error | json-schema, depth-limit, python |
| Error downloading file | exception | error | python, s3, download, presigned-url, expired |
| Refusing to auto-upload | exception | error | file-upload, allowlist, configuration |
| Refusing to auto-upload | exception | error | file-upload, file-not-found, path-resolution |
| Auth schema not found for toolkit with auth scheme | exception | error | auth-scheme, toolkit, auth-config, typescript |
| Failed to parse auth config update data | validation | error | validation, zod, auth-config, sdk |
| Unable to retrieve tool with slug | exception | error | tool-not-found, slug, typescript |
| userId is required when custom tools are bound to a session. | exception | error | session, custom-tools, user-id, typescript |
| experimental_subAgent() expected valid JSON output for… | validation | error | subagent, json, parsing, llm-output |
| ComposioClient is required | exception | error | constructor, client, misuse, typescript |
| Invalid tool list parameters, atleast one of the following… | validation | error | validation, tool-filter, typescript |
| Multiple connected accounts found for user | exception | error | connected-accounts, auth, oauth, duplicate |
| response is required for after_execute_meta | validation | error | python, modifiers, tool-execution |
| UnsafeZipEntryError | exception | error | security, zip, extraction, typescript |
TOOLKIT_NOT_FOUND Toolkit not found | error_code | error | toolkit, not-found, api, sdk |
| Local FFI execution requires the Bun runtime used by the… | exception | error | ffi, bun, runtime, local-tools |
| proxy() requires a consumer project context so it can use… | exception | error | proxy, consumer-project, context, configuration |
| proxy() requires an authenticated Composio user session. | exception | error | proxy, authentication, session, cli |
| Tool arguments were provided as a string that is not valid… | validation | error | tool-arguments, json, llm-output, invalid-params |
| Union types array can not be empty | exception | warning | code-generation, type-builders, union, edge-case |
| Failed to update MCP server | validation | error | mcp, python, update, api-error |
| Invalid tool list parameters | validation | error | validation, zod, typescript, tool-filter |
| JSON Schema nesting too deep to dereference | exception | error | json-schema, recursion, python |
| Missing 'title' in param_schema | validation | error | pydantic, param-schema, missing-title, model-generation |
| Failed to fetch file from URL | validation | error | python, files, upload, http-status, url-fetch |
| A Composio project API key is required to create a local… | exception | error | workbench, api-key, authentication, experimental |
| experimental_subAgent() requires Zod 4 with… | validation | error | zod, schema, version-mismatch, subagent |
| Failed to parse MCP list response | validation | error | mcp, validation, zod, api-mismatch |
| Pass either `sandbox` or `workbench`, not both. `workbench`… | validation | error | python, tool-router, sandbox, invalid-params |
| Custom tool slugs are not supported in preload.tools | validation | error | custom-tools, preload, session, validation, typescript |
| No data provided | validation | error | python, modifiers, invalid-arguments |
| ${error.message (upstream BadRequestError: ACL only allowed… | exception | error | acl, connected-accounts, bad-request, permissions |
| Failed to delete MCP server | validation | error | mcp, python, delete, api-error |
| Failed to parse connected account list query | validation | error | validation, zod, connected-accounts, sdk |
| File operations (upload/download) are not supported in… | exception | error | cloudflare-workers, edge-runtime, files, runtime-unsupported |
| maxBytes must be a non-negative safe integer | validation | error | validation, range-error, file-upload, typescript |
| Pass either sandbox or workbench, not both. workbench is a… | validation | warning | validation, tool-router, api-migration, sdk |
| Refusing to build a path from a | validation | error | path-length, validation, python |
| Tool input parameters are not defined | exception | error | langchain, provider, tool-schema, typescript |
| proxy() does not support passing a Request instance yet… | validation | error | proxy, fetch, request, unsupported-operation |
| Response size exceeds maximum allowed size | exception | error | python, size-limit, streaming, download |
| Error reading file at | exception | error | filesystem, node, io, typescript |
| Invalid proxy execute parameters | validation | error | session, proxy, zod, validation, typescript |
| App name is not defined | exception | error | langchain, provider, toolkit-metadata, typescript |
| proxy_execute: endpoint is required | validation | error | python, session, validation, proxy |
| File upload was aborted because before_file_upload returned… | exception | warning | python, hook, upload, aborted, user-config |
| HTTP | exception | error | http, permissions, api, backend |
| Not a file: . Please provide a valid file path. | exception | error | python, filesystem, validation, upload |
BadEncoding BadEncoding | error_code | error | keyring, encoding, typescript |
| Failed to upload to S3. Status | exception | error | python, custom-tools, slug, duplicate, validation |
| File system operations are not supported in this runtime… | exception | error | runtime, filesystem, browser, typescript |
| Refusing to build a path from a | validation | critical | path-traversal, security, python |
| Request timed out fetching URL | exception | error | python, custom-tools, toolkit, slug, duplicate |
| Failed to download file | exception | error | s3, download, network, typescript |
| Unsupported upload source | validation | error | file-upload, validation, type-mismatch |
| proxy_execute: toolkit is required | validation | error | python, session, validation, proxy |
| URL returned redirect to | exception | error | python, custom-tools, preload, validation |
| Invalid parameters passed to create mcp config | validation | error | mcp, zod, validation, typescript |
| Refusing to build a path from an empty or non-string | validation | error | path-traversal, validation, python, security |
| Refusing to write ending in a space or dot | exception | warning | windows, filename-validation, python |
| Failed to parse remote file response | validation | error | files, zod, validation, response-parsing |