Error Messages
Understanding and resolving error messages
This reference explains error messages you may encounter and how to resolve them.
Validation Errors
These errors occur when saving or releasing workflows.
"Node is not connected"
Meaning: A node has no incoming or outgoing connections.
Resolution:
- Find the disconnected node
- Connect it to other nodes
- Or remove it if not needed
"Missing required field: [field]"
Meaning: A required configuration field is empty.
Resolution:
- Open the node configuration
- Fill in the required field
- Save the configuration
"Invalid CEL expression"
Meaning: The CEL expression has syntax errors.
Resolution:
- Check the expression syntax
- Verify property names match your data
- Check parentheses and operators
- See CEL Reference
"Invalid Liquid template"
Meaning: The Liquid template has syntax errors.
Resolution:
- Check for unclosed tags (
{% %}or{{ }}) - Verify filter syntax
- Check for typos in variable names
- See Liquid Reference
"Trigger not configured"
Meaning: The workflow has no trigger.
Resolution:
- Add an Event Trigger or Scheduled Trigger
- Configure the trigger type
- Connect to downstream nodes
"Circular reference detected"
Meaning: The workflow graph contains a loop.
Resolution:
- Review node connections
- Remove the edge creating the cycle
- Restructure workflow if needed
Execution Errors
These errors occur during workflow execution.
Timeout Errors
"Execution timed out after [X]ms"
Meaning: Node took too long to complete.
Default timeouts:
- Standard nodes: 30 seconds
- AI nodes: 120 seconds
Resolution:
- Reduce input size
- Simplify the operation
- Check external service response times
- Consider splitting into multiple nodes
"AI request timed out"
Meaning: AI model didn't respond in time.
Resolution:
- Use transcript summary instead of full transcript
- Reduce prompt complexity
- Try at a different time
- Use lower model tier
Data Errors
"Property '[name]' not found"
Meaning: Trying to access a property that doesn't exist.
Resolution:
- Check the property name spelling
- Verify upstream node produces this property
- Add null check before accessing
- Check execution log for actual data structure
"Cannot read property of null"
Meaning: Trying to access property on null value.
Resolution:
- Add null check in condition
- Use If node to handle null case
- Verify upstream data exists
"Index out of bounds"
Meaning: Array index doesn't exist.
Resolution:
- Check array size before accessing
- Use
size() > 0check - Handle empty array case
"Type mismatch: expected [type] got [type]"
Meaning: Value is wrong type for operation.
Resolution:
- Use type conversion functions
- Check data sources
- Verify return type configuration
Integration Errors
"Authentication failed" / "401 Unauthorized"
Meaning: Integration credentials are invalid.
Resolution:
- Go to Settings → Integrations
- Disconnect the integration
- Reconnect with fresh credentials
"Permission denied" / "403 Forbidden"
Meaning: Account doesn't have required permissions.
Resolution:
- Check integration permissions
- Verify account access level
- Reconnect with appropriate scopes
"Resource not found" / "404 Not Found"
Meaning: The requested object doesn't exist.
Resolution:
- Verify the ID is correct
- Check the object wasn't deleted
- Confirm object type matches
"Rate limited" / "429 Too Many Requests"
Meaning: Too many API calls in short time.
Resolution:
- Add Wait nodes between calls
- Reduce request frequency
- Implement backoff strategy
"Service unavailable" / "503"
Meaning: External service is down.
Resolution:
- Wait and retry later
- Check service status page
- Message will retry automatically
AI Errors
"Failed to parse AI output"
Meaning: AI response doesn't match expected format.
Resolution:
- Add clearer format instructions to prompt
- Include output examples
- Use simpler return type
- Add "Return only the [type], nothing else"
"Invalid JSON in AI response"
Meaning: Expected JSON but got malformed response.
Resolution:
- Add explicit JSON format instructions
- Include JSON example in prompt
- Use string return type and parse separately
"AI output exceeds maximum length"
Meaning: Response too long.
Resolution:
- Add length constraints to prompt
- Request shorter output
- Split into multiple requests
Retry and DLQ Errors
"Max retries exceeded"
Meaning: All retry attempts failed.
Resolution:
- Check the original error
- Fix root cause
- Consider retry from DLQ
"Message moved to DLQ"
Meaning: Message couldn't be processed.
Resolution:
- Review DLQ for details
- Fix the underlying issue
- Retry if appropriate
System Errors
"Internal server error"
Meaning: Unexpected platform error.
Resolution:
- Wait and retry
- Check if reproducible
- Contact support if persistent
"Workflow version not found"
Meaning: Referenced version doesn't exist.
Resolution:
- Check version exists
- Ensure it's not deleted
- Reference correct version
"Execution not found"
Meaning: Execution ID doesn't exist.
Resolution:
- Verify execution ID
- Check it wasn't purged
- Use correct organization
Error Code Reference
| Code | Category | Meaning |
|---|---|---|
| VAL_001 | Validation | Missing required field |
| VAL_002 | Validation | Invalid expression |
| VAL_003 | Validation | Invalid configuration |
| EXE_001 | Execution | Timeout |
| EXE_002 | Execution | Node failed |
| EXE_003 | Execution | Data error |
| INT_001 | Integration | Authentication failed |
| INT_002 | Integration | Permission denied |
| INT_003 | Integration | Rate limited |
| INT_004 | Integration | Service unavailable |
| AI_001 | AI | Parse failure |
| AI_002 | AI | Timeout |
| AI_003 | AI | Model error |
| SYS_001 | System | Internal error |
| SYS_002 | System | Resource not found |
Reading Error Messages
Error Structure
Errors typically include:
[Error Code] [Category]: [Message]
Details:
- Node: [node name]
- Input: [relevant input]
- Context: [additional info]
What to Look For
- Error code - Identifies error type
- Message - Human-readable description
- Node - Where the error occurred
- Details - Additional context
Example Error Analysis
EXE_002 Execution: Property 'callRecording' not found
Details:
- Node: AI Prompt - Summarize
- Input: { meeting: {...} }
- Context: Check if meeting has a recording
Analysis:
- Error occurred in "AI Prompt - Summarize" node
- The input has
meetingbut nocallRecording - The meeting likely doesn't have a recording
Solution:
Add an If node to check json.callRecording != null before the AI node.