Files
geointel/docs/18-ultra-prep/ERROR_TAXONOMY.md
T
Jens faeb58ef6d
GeoIntel release gates / Compile, test, contracts and builds (push) Successful in 1m49s
GeoIntel release gates / Python and npm vulnerability policy (push) Successful in 21s
GeoIntel release gates / Production AI image, SBOM and container scan (push) Successful in 5m39s
GeoIntel release gates / Deploy exact gated revision to Unraid (push) Failing after 58m43s
Initial public release
2026-08-31 21:56:53 +02:00

761 B

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.