Each node type throws specific error classes that help you understand what went wrong and how to fix it.
Node-specific errors#
CodeNodeError
Info
Your Python or JavaScript code threw an exception during execution
OutputValidationError
Info
The data type your code returned doesn’t match the output variable type you configured
DepthLimitError
Info
Your code created nested data structures deeper than 5 levels
CodeExecutionError
Info
The sandbox service couldn’t execute your code - usually means the service is down
VariableNotFoundError
Info
Your prompt template references a variable that doesn’t exist in the workflow context
InvalidContextStructureError
Info
You passed an array or object to the context field, which only accepts strings
NoPromptFoundError
Info
The prompt field is completely empty
ModelNotExistError
Info
No model is selected in the LLM node configuration
LLMModeRequiredError
Info
The selected model doesn’t have valid API credentials configured
InvalidVariableTypeError
Info
Your prompt template isn’t valid Jinja2 syntax or plain text format
AuthorizationConfigError
Info
Missing or invalid authentication configuration for the API endpoint
InvalidHttpMethodError
Info
HTTP method must be GET, HEAD, POST, PUT, PATCH, or DELETE
ResponseSizeError
Info
API response exceeded the 10MB size limit
FileFetchError
Info
Couldn’t retrieve a file variable referenced in the request
InvalidURLError
Info
The URL format is malformed or unreachable
ToolParameterError
Info
Parameters passed to the tool don’t match its expected schema
ToolFileError
Info
The tool couldn’t access required files
ToolInvokeError
Info
The external tool API returned an error during execution
ToolProviderNotFoundError
Info
The tool provider isn’t installed or configured properly
System-level errors#
InvokeConnectionError
Info
Network connection failed to the external service
InvokeServerUnavailableError
Info
External service returned a 503 status or is temporarily down
InvokeRateLimitError
Info
You’ve hit rate limits on the API or model provider
QuotaExceededError
Info
Your usage quota has been exceeded for this service