SDK API Reference / ErrorCode
Enumeration: ErrorCode
Error codes for consistent error handling Inspired by Airframe RPC status codes
Enumeration Members
ACTIVATION_SYNTAX_ERROR
ACTIVATION_SYNTAX_ERROR:
"ACTIVATION_SYNTAX_ERROR"
Invalid activation YAML syntax or validation error (HTTP 400)
ACTIVATION_UPDATE_ERROR
ACTIVATION_UPDATE_ERROR:
"ACTIVATION_UPDATE_ERROR"
Generic activation create/update failure (non-400 errors)
AGENT_EVALUATION_ERROR
AGENT_EVALUATION_ERROR:
"AGENT_EVALUATION_ERROR"
Agent evaluation failed (invalid response from evaluator)
AGENT_NOT_FOUND
AGENT_NOT_FOUND:
"AGENT_NOT_FOUND"
LLM agent not found
AGENT_SYNTAX_ERROR
AGENT_SYNTAX_ERROR:
"AGENT_SYNTAX_ERROR"
Invalid agent YAML syntax or validation error
AGENT_UPDATE_ERROR
AGENT_UPDATE_ERROR:
"AGENT_UPDATE_ERROR"
Generic agent create/update failure (non-400 errors)
ALREADY_EXISTS
ALREADY_EXISTS:
"ALREADY_EXISTS"
Resource already exists (conflict)
CANCELLED
CANCELLED:
"CANCELLED"
Operation cancelled by user
CHAT_NOT_FOUND
CHAT_NOT_FOUND:
"CHAT_NOT_FOUND"
Chat session not found
CLAUDE_CODE_NOT_FOUND
CLAUDE_CODE_NOT_FOUND:
"CLAUDE_CODE_NOT_FOUND"
Claude Code CLI not found (specific error for claude command)
CLAUDE_CODE_UNSUPPORTED_VERSION
CLAUDE_CODE_UNSUPPORTED_VERSION:
"CLAUDE_CODE_UNSUPPORTED_VERSION"
Claude Code version too old (doesn't support required features)
COMMAND_NOT_FOUND
COMMAND_NOT_FOUND:
"COMMAND_NOT_FOUND"
Command not found (CLI not installed)
CONNECTION_NOT_FOUND
CONNECTION_NOT_FOUND:
"CONNECTION_NOT_FOUND"
Connection not found
CONNECTOR_INVALID_CONFIG
CONNECTOR_INVALID_CONFIG:
"CONNECTOR_INVALID_CONFIG"
Invalid connector_config (client-side schema validation)
CONNECTOR_SCHEMA_NOT_FOUND
CONNECTOR_SCHEMA_NOT_FOUND:
"CONNECTOR_SCHEMA_NOT_FOUND"
Connector schema not found for the connection type
DATABASE_NOT_FOUND
DATABASE_NOT_FOUND:
"DATABASE_NOT_FOUND"
Database doesn't exist
HTTP_REQUEST_FAILURE
HTTP_REQUEST_FAILURE:
"HTTP_REQUEST_FAILURE"
HTTP request failed (network errors, DNS failure, connection refused, etc.)
INSTALLATION_FAILED
INSTALLATION_FAILED:
"INSTALLATION_FAILED"
MCP server or plugin installation failed
INTERNAL
INTERNAL:
"INTERNAL"
Generic internal server error
INVALID_ARGUMENT
INVALID_ARGUMENT:
"INVALID_ARGUMENT"
Invalid input parameters, validation failures
INVALID_REQUEST
INVALID_REQUEST:
"INVALID_REQUEST"
Generic invalid request
JOURNEY_NOT_FOUND
JOURNEY_NOT_FOUND:
"JOURNEY_NOT_FOUND"
Journey not found
JOURNEY_SYNTAX_ERROR
JOURNEY_SYNTAX_ERROR:
"JOURNEY_SYNTAX_ERROR"
Invalid journey YAML syntax or validation error
JOURNEY_UPDATE_ERROR
JOURNEY_UPDATE_ERROR:
"JOURNEY_UPDATE_ERROR"
Generic journey create/update failure (non-400 errors)
LLM_CHAT_CREATION_FAILURE
LLM_CHAT_CREATION_FAILURE:
"LLM_CHAT_CREATION_FAILURE"
LLM chat creation failed (empty chat ID returned)
LLM_EMPTY_MESSAGE
LLM_EMPTY_MESSAGE:
"LLM_EMPTY_MESSAGE"
Empty or whitespace-only message
LLM_MALFORMED_MESSAGE
LLM_MALFORMED_MESSAGE:
"LLM_MALFORMED_MESSAGE"
Malformed LLM event message structure
LLM_PROJECT_NOT_FOUND
LLM_PROJECT_NOT_FOUND:
"LLM_PROJECT_NOT_FOUND"
LLM project not found
LLM_STREAM_ERROR
LLM_STREAM_ERROR:
"LLM_STREAM_ERROR"
LLM SSE streaming error
MISSING_ARGUMENT
MISSING_ARGUMENT:
"MISSING_ARGUMENT"
Missing required parameter or argument
NOT_FOUND
NOT_FOUND:
"NOT_FOUND"
Generic resource not found (HTTP 404)
PERMISSION_DENIED
PERMISSION_DENIED:
"PERMISSION_DENIED"
Insufficient permissions (HTTP 403)
RATE_LIMITED
RATE_LIMITED:
"RATE_LIMITED"
Rate limit exceeded (HTTP 429)
SEGMENT_FOLDER_NOT_FOUND
SEGMENT_FOLDER_NOT_FOUND:
"SEGMENT_FOLDER_NOT_FOUND"
Segment folder not found
SEGMENT_NOT_FOUND
SEGMENT_NOT_FOUND:
"SEGMENT_NOT_FOUND"
Segment or parent segment not found
SEGMENT_SYNTAX_ERROR
SEGMENT_SYNTAX_ERROR:
"SEGMENT_SYNTAX_ERROR"
Invalid segment YAML syntax or validation error (HTTP 400)
SEGMENT_UPDATE_ERROR
SEGMENT_UPDATE_ERROR:
"SEGMENT_UPDATE_ERROR"
Generic segment create/update failure (non-400 errors)
TABLE_NOT_FOUND
TABLE_NOT_FOUND:
"TABLE_NOT_FOUND"
Table doesn't exist
TIMEOUT
TIMEOUT:
"TIMEOUT"
Request timeout
TRINO_INSUFFICIENT_RESOURCES
TRINO_INSUFFICIENT_RESOURCES:
"TRINO_INSUFFICIENT_RESOURCES"
Trino insufficient resources (memory, CPU, etc.)
TRINO_INTERNAL_ERROR
TRINO_INTERNAL_ERROR:
"TRINO_INTERNAL_ERROR"
Trino internal error (server-side issue)
TRINO_INVALID_ARGUMENT
TRINO_INVALID_ARGUMENT:
"TRINO_INVALID_ARGUMENT"
Trino invalid arguments or type mismatch
TRINO_NOT_FOUND
TRINO_NOT_FOUND:
"TRINO_NOT_FOUND"
Trino schema/table/column not found
TRINO_SYNTAX_ERROR
TRINO_SYNTAX_ERROR:
"TRINO_SYNTAX_ERROR"
Trino syntax error
TRINO_USER_CANCELLED
TRINO_USER_CANCELLED:
"TRINO_USER_CANCELLED"
Query cancelled by user
UNAUTHENTICATED
UNAUTHENTICATED:
"UNAUTHENTICATED"
Authentication required (HTTP 401)
UNAVAILABLE
UNAVAILABLE:
"UNAVAILABLE"
Service unavailable (HTTP 5xx)
WORKFLOW_ARCHIVE_CORRUPTED
WORKFLOW_ARCHIVE_CORRUPTED:
"WORKFLOW_ARCHIVE_CORRUPTED"
Workflow archive corrupted or invalid
WORKFLOW_PROJECT_NOT_FOUND
WORKFLOW_PROJECT_NOT_FOUND:
"WORKFLOW_PROJECT_NOT_FOUND"
Workflow project not found
WORKFLOW_SECRET_NOT_FOUND
WORKFLOW_SECRET_NOT_FOUND:
"WORKFLOW_SECRET_NOT_FOUND"
Workflow secret not found