Skip to content

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