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.

Related documentation