n8n-io/n8n
Documented errors, page 8 of 11. Back to n8n-io/n8n
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| argument of keepFieldsContaining must be a non-empty string | exception | error | expression, object, string, validation, argument-shape |
| Invalid message type | exception | error | configuration, message-template, langchain, parameter-validation |
| Invalid prebuilt-workflows manifest at | exception | error | zod, validation, manifest, configuration |
| Port is already in use | exception | error | task-runner, python, network, port-conflict, health-check, startup |
SDK_FORBIDDEN_CONSTRUCT Arrow functions are not allowed. Use fromAi() directly instead of ($) =>… | validation | warning | lint, sdk, builder |
| Too many columns: (max ) | validation | error | limits, columns, json, attachment-parsing |
| Transactions aren't supported by | exception | error | typeorm, sqlite, transactions, database, config |
| Unsupported provider | exception | error | huggingface, embeddings, validation, configuration |
| VectorStore " " requires a description — set it via… | exception | error | vector-store, as-tool, validation, llm, configuration |
| Authorization is required! | exception | error | authentication, http, webhook, chat-trigger, client-error |
| chunk(): expected non-zero numeric arg, e.g. .chunk(5) | exception | error | expression-runtime, array-extensions, chunk, argument-validation |
| CodeWorkflowBuilder did not produce a workflow | exception | error | |
| --delete-prebuilt-workflows cannot be used with… | exception | error | cli, argument-validation, instance-ai, evaluations |
| Failed to enable MCP access | exception | error | mcp, config, n8n-api, env |
| No model selected. Please choose a model. | exception | error | anthropic, llm, configuration, user-input |
| Authentication failed - invalid API key or endpoint. | exception | error | azure-ai-search, vector-store, authentication, error-classification, http-401 |
| Delegated child checkpoint does not match the selected… | exception | error | checkpoint, resume, delegate-tool, sub-agent-id |
| Failed to retrieve download URL for file | exception | error | minimax, video-generation, download, response-shape, race |
| Invalid document at index | validation | error | |
| No workflows found with specified filters | exception | error | cli, export, workflow, filter, user-error |
| Unsupported syntax: 'Unary operator | exception | error | sdk-interpreter, unary-operator, bitwise, delete |
| Content too large: bytes (max bytes). | exception | warning | filesystem, validation, computer-use |
| Failed to parse agent steps | exception | error | langchain, agent, runtime, unexpected-shape |
| Invalid timezone | exception | error | |
| tar extraction failed | exception | error | tar, scanner, filesystem, cross-platform |
| Target user not found | exception | error | users, rbac, role-change, rest-api, not-found |
| cannot convert to float, expected . as decimal separator | exception | error | |
| Could not find the project with the ID | exception | error | cli, ldap, not-found, user-error |
| Failed to load existing workflow | exception | error | |
| Input is not a valid JSON | exception | error | ai-tool, llm-input, json, http-request-tool, model-validation |
| Model ID is required | exception | error | model-config, validation, configuration, provider |
| nodeJson() requires a non-empty JSON path. | exception | error | expression, validation, sdk, runtime |
| Object.getPrototypeOf is not allowed | exception | error | |
| Path escapes builder workspace root | validation | error | |
| must be a positive integer, got " ". | exception | error | configuration, env-vars, validation, timeout |
| Documents must be an array | validation | error | embeddings, validation, user-error, ai-utilities |
MAX_NODES_EXCEEDED Workflow has nodes. Maximum allowed is . | validation | error | |
| The optimistic lock can be used only with getOne() method. | exception | error | typeorm, query-builder, optimistic-locking, concurrency |
| Authentication failed during document upload - invalid API… | exception | error | azure-ai-search, vector-store, authentication, document-upload, http-401 |
| Failed to fetch template | exception | error | api, templates, http-status, network, ai-workflow-builder |
| replacements must be an array of | validation | error | |
| Restore was asked to seed | exception | error | eval, n8n-api, version-mismatch, agents |
| The response type must be a string. Received | exception | error | http-request-tool, response-optimization, type-mismatch, ai-tool |
| This invite has been accepted already | exception | warning | invitations, token, rest-api, duplicate |
| toolCallConcurrency must be a positive integer or Infinity | exception | error | concurrency, validation, configuration, agent |
| Attachment exceeds maximum size of | exception | error | |
| Column of Entity does not support length property. | exception | error | column-length, datatype, metadata, startup |
| Maximum number of redirects | exception | error | http, redirect, ssrf, redirect-loop, backend-network |
NODES_NOT_FOUND Node with ID " " not found in workflow | error_code | error | workflow-builder, connections, nodes, lookup |
| Tool name is required | exception | error | tool, builder, validation, configuration |
| Duplicate deferred tool name | exception | error | tools, deferred-tools, validation, duplicate, naming |
| Entity " " does not have a primary column. Primary column… | exception | critical | primary-key, entity, metadata, startup |
| Error setting up Entra ID authentication | exception | error | |
| Unsupported value type | validation | error | |
| Workflow " " not found. | exception | error | workflow, not-found, activation, repository |
| Authentication failed. Please check your API key or token… | exception | error | chromadb, vector-store, authentication, credentials, node-api-error, langchain |
| Could not determine personal project ID | exception | error | auth, n8n-api, projects |
| Invalid authentication method | exception | error | azure, openai, llm, authentication, configuration |
| No valid prompts found in the provided CSV file | exception | error | |
| Subnode connections are managed by parent node SubnodeConfig | exception | error | subnode, connections, workflow-builder, fluent-api, chaining |
| Thread : the live turn is the first/only user turn — no… | exception | error | eval-harness, seed, conversation-case, configuration |
| Wrong driver: " " given. Supported drivers are: "postgres"… | exception | critical | typeorm, database, config, driver, startup |
| Error during parsing of JSON Schema. | exception | error | workflow-tool, json-schema, zod, ai-tool, configuration |
| removeFieldsContaining(): expected non-empty string arg | exception | error | expression, object, string, validation, argument-shape |
| is not a supported type of binary data. Only images are… | exception | error | binary-data, mime-type, vision-model, parameter-validation |
| Could not find any entity of type | exception | error | typeorm, query-builder, not-found, validation |
| Episodic memory requires a resolved embedding model before… | exception | warning | security, credentials, set-node, assignments |
| Failed to load existing workflow | exception | error | |
| You must set up your own account before inviting others | exception | warning | invitations, setup, owner, rest-api, config |
| Cannot assign property on | exception | error | sdk, ast-interpreter, null-reference, assignment |
| Cannot decrease maxIterations when resuming a run. Expected… | exception | error | workflow-structure, node-limits, validation |
| concurrencyMode must be 'sequential' or 'concurrent', got | validation | error | scheduler, configuration, validation, enum |
| Failed to load existing workflow | exception | error | |
| Failed to read MCP servers from endpoint | exception | error | microsoft, mcp, tooling-gateway, http-error, network, authentication |
| Failed to write binary file | exception | error | binary-data, storage, configuration, database-mode |
| Pattern " " escapes the base directory | exception | warning | filesystem, security, validation, computer-use |
| ${uploadResponse.file.error?.message ?? 'Unknown error'} | exception | error | google-gemini, file-upload, api-error, polling, binary, node-operation-error |
WRONG_KIND_LIST_MODE_VALUE Parameter " ": " " is not a valid list-mode value — list mode holds the opaque… | error_code | error | |
| Cannot perform insert query because values are not defined… | exception | error | query-builder, insert, validation |
| OpenAI Responses API | exception | error | |
| SAML user may not change their email | exception | warning | me, email, saml, sso, rest-api |
| one_off.fireAt must be a valid Date | validation | error | scheduler, one-off, type-narrowing, date |
| Unsupported model | exception | error | |
| workflow() requires (id: string, name: string). workflow()… | exception | error | workflow-builder, validation, typeerror, factory |
| Cannot access this property in a jmespath query due to… | exception | error | |
CODE_NESTED_TEMPLATE_LITERAL Code node uses nested template literals, which often break after save. Build… | validation | warning | lint, code-node, sdk |
| Database name must be provided either in credentials or in… | exception | error | |
| Failed to authenticate with n8n — no session cookie received | exception | error | auth, network, n8n-api |
| `--filter do:` and `--filter dont:` are only supported for… | exception | error | |
| Tarball not found | exception | error | npm, scanner, filesystem, concurrency |
| Error during parsing of JSON Schema. Please check the… | exception | error | |
| ${errorMessage} | exception | error | |
| expected two arguments (Object, string) for this function | exception | error | |
| Invalid response from Python script. Expected… | exception | error | |
| No published version found for workflow | exception | error | cli, export, workflow, published, history, user-error |
SECURITY_VIOLATION SECURITY_VIOLATION | error_code | error | |
| The optimistic lock on entity | exception | error | typeorm, query-builder, optimistic-locking, concurrency, transactions |
| Could not replace placeholders in | exception | error | http-request-tool, json, configuration, ai-tool |
| OAuth access token expired and no refresh token is… | exception | error | oauth2, auth, refresh-token, credentials, client-oauth2 |
| Table not found | exception | error | supabase, vector-store, pgvector, config, table |