Match on error.code, not on prose.
Error codes
Codes
The HTTP response body nests structured error codes under error.code:
- Core, upload, and search:
UNAUTHORIZED,FORBIDDEN,ENROLLMENT_CLOSED,NOT_FOUND,CONFLICT,BAD_REQUEST,VALIDATION_ERROR,RATE_LIMITED,NON_RETAINING_WORKSPACE,S3_NOT_CONFIGURED,S3_PRESIGN_UNAVAILABLE,DOCUMENT_PROCESSING_QUEUE_UNAVAILABLE,DOCUMENT_CONFIRMATION_UNAVAILABLE,SEARCH_EVIDENCE_STALE,SEARCH_EVIDENCE_SOURCE_CHANGED,PROCESSOR_UNAVAILABLE,FILE_TOO_LARGE,INVALID_SCHEMA,UNSUPPORTED_FORMAT. - AI providers, models, and workflows:
AI_PROVIDER_KEY_REJECTED,AI_PROVIDER_UNREACHABLE,AI_PROVIDER_NOT_CONNECTED,AI_PROVIDER_ERROR,AI_RESPONSE_BLOCKED,MODEL_NOT_IN_CATALOG,MODEL_NOT_APPROVED,MODEL_CHOICE_UNAVAILABLE,MODEL_CHOICE_BEDROCK,MODELS_MANAGED_BY_INSTALLATION,WORKFLOW_RELEASE_VALIDATION_FAILED,WORKFLOW_MODEL_UNAVAILABLE. - Context Engine, Lineage, and Graph Review:
BUILD_BLOCKED,BUILD_ALREADY_RUNNING,BUILD_NOT_RESUMABLE,WORKER_UNAVAILABLE,SWITCH_ABOVE_DEPLOYMENT_CEILING,EVALUATION_REQUIRED,RANKING_ASSIGNMENT_OPERATOR_ONLY,RANKING_SHADOW_CONSENT_OFF,LINEAGE_SOURCE_CHANGED,GRAPH_CLOCK_BUSY,GRAPH_REVIEW_GATE_FAILED,GRAPH_REVIEW_GATE_UNVERIFIED,ITEM_CHANGED,REASON_REQUIRED. - Context Studio, Ask history, and Evaluation:
CONTEXT_LIBRARY_UNAVAILABLE,CONTEXT_SETS_UNAVAILABLE,ENRICHMENT_UNAVAILABLE,LEARNING_OFF,GAP_RUN_IN_PROGRESS,GAP_RUN_SUPERSEDED,GAP_RUN_COOLDOWN,SUGGESTION_NOT_CITED,SUGGESTION_CITATION_UNREADABLE,SUGGESTION_LIMIT_REACHED,REGRESSION_OVERRIDE_REQUIRED,TEMPLATE_RUNS_BUSY,ASK_HISTORY_SAVING_OFF,CHUNK_SIZES_BUILD_CONFIRMATION_REQUIRED,PINNED_SOURCE_UNAVAILABLE,PINNED_RANKING_PROFILE_UNAVAILABLE,OVERLAP_THRESHOLD_CONFIRMATION_REQUIRED. - Agent Context API, MCP, and Agent Memory:
AGENT_CREDENTIAL_REQUIRED,AGENT_CREDENTIAL_INVALID,AGENT_CREDENTIAL_EXPIRED,AGENT_CREDENTIAL_REVOKED,AGENT_CREDENTIAL_ROTATED,AGENT_CREDENTIAL_AUTHORITY_LOST,AGENT_BROWSER_REQUEST_REFUSED,AGENT_SCOPE_REQUIRED,AGENT_SCOPE_EXCEEDS_ROLE,AGENT_CONTEXT_SET_INACTIVE,AGENT_CONTEXT_SET_REQUIRED,AGENT_CONTEXT_SET_SCOPE_REFUSED,AGENT_CONTEXT_SET_TOOL_REFUSED,AGENT_CONTEXT_SET_TEMPLATE_REFUSED,AGENT_CONTEXT_SET_CHANGED,AGENT_REPLAY_TASK_MISMATCH,AGENT_REPLAY_EXPIRED,AGENT_OUTPUT_TOO_LARGE,AGENT_FIELD_PLAN_INVALID_PLAN,AGENT_QUERY_TEMPLATE_NOT_IN_SET,AGENT_MEMORY_DISABLED,AGENT_MEMORY_EMPTY,AGENT_MEMORY_PERSONAL_DATA,AGENT_MEMORY_SOURCE_UNAVAILABLE,AGENT_MEMORY_RATE_LIMITED,AGENT_MEMORY_FULL.