geointel/docs/18-ultra-prep/ERROR_TAXONOMY.md

Error Taxonomy

All API errors must use a consistent shape.

{
  "error": {
    "code": "DATASET_UNSUPPORTED_FORMAT",
    "message": "The uploaded file format is not supported for this operation.",
    "details": {},
    "trace_id": "optional"
  }
}

Core Error Codes

• VALIDATION_ERROR
• NOT_FOUND
• CONFLICT
• FEATURE_DISABLED
• DATASET_UPLOAD_FAILED
• DATASET_UNSUPPORTED_FORMAT
• CRS_MISSING
• CRS_UNSUPPORTED
• GEOMETRY_INVALID
• RASTER_METADATA_FAILED
• VECTOR_METADATA_FAILED
• PROCESSING_JOB_FAILED
• MODEL_UNAVAILABLE
• INFERENCE_FAILED
• REFERENCE_LAYER_MISSING
• QA_MATCHING_FAILED
• EXPORT_FAILED

Frontend Requirements

Every error code should render a useful message and suggested next action.