tdx

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)

COMPOSABLE_ACTIVATION_SYNTAX_ERROR ​

COMPOSABLE_ACTIVATION_SYNTAX_ERROR: "COMPOSABLE_ACTIVATION_SYNTAX_ERROR"

Invalid composable activation config (HTTP 400)

COMPOSABLE_ACTIVATION_UPDATE_ERROR ​

COMPOSABLE_ACTIVATION_UPDATE_ERROR: "COMPOSABLE_ACTIVATION_UPDATE_ERROR"

Generic composable activation create/update failure (non-400 errors)

COMPOSABLE_AUDIENCE_DRIFT ​

COMPOSABLE_AUDIENCE_DRIFT: "COMPOSABLE_AUDIENCE_DRIFT"

Push would silently remove attributes/behaviors present on the server but absent from the local YAML

COMPOSABLE_AUDIENCE_SYNTAX_ERROR ​

COMPOSABLE_AUDIENCE_SYNTAX_ERROR: "COMPOSABLE_AUDIENCE_SYNTAX_ERROR"

Invalid composable audience YAML/config or validation error (HTTP 400)

COMPOSABLE_AUDIENCE_UPDATE_ERROR ​

COMPOSABLE_AUDIENCE_UPDATE_ERROR: "COMPOSABLE_AUDIENCE_UPDATE_ERROR"

Generic composable audience create/update failure (non-400 errors)

COMPOSABLE_AUDIENCE_VERIFICATION_FAILED ​

COMPOSABLE_AUDIENCE_VERIFICATION_FAILED: "COMPOSABLE_AUDIENCE_VERIFICATION_FAILED"

Post-write re-read doesn't match what was pushed (self-verification failure)

COMPOSABLE_JOURNEY_LAUNCHED ​

COMPOSABLE_JOURNEY_LAUNCHED: "COMPOSABLE_JOURNEY_LAUNCHED"

A composable journey is launched, so its definition/segments cannot be modified in place

COMPOSABLE_JOURNEY_STAGE_ENTRY_CRITERIA ​

COMPOSABLE_JOURNEY_STAGE_ENTRY_CRITERIA: "COMPOSABLE_JOURNEY_STAGE_ENTRY_CRITERIA"

A composable journey states its own entry criteria on a stage after the first. The platform overwrites those with the previous stage's milestone, so sending them only creates segments the journey never references.

COMPOSABLE_JOURNEY_UNSUPPORTED_FEATURE ​

COMPOSABLE_JOURNEY_UNSUPPORTED_FEATURE: "COMPOSABLE_JOURNEY_UNSUPPORTED_FEATURE"

A journey feature the composable (M2) backend does not support yet

COMPOSABLE_SEGMENT_NOT_FOUND ​

COMPOSABLE_SEGMENT_NOT_FOUND: "COMPOSABLE_SEGMENT_NOT_FOUND"

--delete targeted a segment name that doesn't exist under the resolved audience

COMPOSABLE_SEGMENT_RULE_REQUIRED ​

COMPOSABLE_SEGMENT_RULE_REQUIRED: "COMPOSABLE_SEGMENT_RULE_REQUIRED"

Composable segment YAML states no rule:, which the API can neither store nor clear

COMPOSABLE_SEGMENT_SYNTAX_ERROR ​

COMPOSABLE_SEGMENT_SYNTAX_ERROR: "COMPOSABLE_SEGMENT_SYNTAX_ERROR"

Invalid composable segment YAML/config or validation error (HTTP 400)

COMPOSABLE_SEGMENT_UPDATE_ERROR ​

COMPOSABLE_SEGMENT_UPDATE_ERROR: "COMPOSABLE_SEGMENT_UPDATE_ERROR"

Generic composable segment create/update failure (non-400 errors)

COMPOSABLE_SEGMENT_VERIFICATION_FAILED ​

COMPOSABLE_SEGMENT_VERIFICATION_FAILED: "COMPOSABLE_SEGMENT_VERIFICATION_FAILED"

Post-write re-read doesn't match what was pushed (self-verification failure)

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, or a tdx programming/wiring bug (e.g. an SDK context missing a getter its own code path requires). Retryable in the former case, never in the latter.

INVALID_ARGUMENT ​

INVALID_ARGUMENT: "INVALID_ARGUMENT"

Invalid input parameters, validation failures

INVALID_PROFILE_CONFIG ​

INVALID_PROFILE_CONFIG: "INVALID_PROFILE_CONFIG"

Invalid profile configuration in tdx.json

INVALID_REQUEST ​

INVALID_REQUEST: "INVALID_REQUEST"

Generic invalid request

JOURNEY_FOLDER_REQUIRED ​

JOURNEY_FOLDER_REQUIRED: "JOURNEY_FOLDER_REQUIRED"

A journey write has no folder to go in. Refused rather than sent: the folder is what the server uses to classify a journey's audience kind, so a folder-less create on a composable audience is routed to the complete controller.

JOURNEY_MULTI_VERSION_UNSUPPORTED ​

JOURNEY_MULTI_VERSION_UNSUPPORTED: "JOURNEY_MULTI_VERSION_UNSUPPORTED"

A journey YAML declares more than one version, and a push writes one

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)

OPENCODE_NOT_FOUND ​

OPENCODE_NOT_FOUND: "OPENCODE_NOT_FOUND"

OpenCode CLI not found (specific error for opencode command)

PERMISSION_DENIED ​

PERMISSION_DENIED: "PERMISSION_DENIED"

Insufficient permissions (HTTP 403)

PROFILE_SITE_MISMATCH ​

PROFILE_SITE_MISMATCH: "PROFILE_SITE_MISMATCH"

Resolved site (from --site/session/TDX_SITE/etc.) conflicts with the active profile's recorded site

PROXY_CONNECTION_FAILURE ​

PROXY_CONNECTION_FAILURE: "PROXY_CONNECTION_FAILURE"

Proxy connection failed (unable to connect through configured proxy)

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

WORKFLOW_SECRET_SET_FAILED ​

WORKFLOW_SECRET_SET_FAILED: "WORKFLOW_SECRET_SET_FAILED"

Failed to set one or more workflow secrets

Copyright 2024-present Treasure AI