Skip to main content

Case Anomalies

List anomalies detected within a case with severity filtering and dismissed toggle. Dismiss individual anomalies after review.

Anomalies are structural issues detected across the documents in a case — field conflicts, duplicate key divergence, value reuse patterns, and more.

GET/v1/cases/:key/anomalies

Response

Response fields

dataarrayArray of anomaly objects.
data[].idstringAnomaly UUID.
data[].typestringAnomaly detector type (e.g. field_conflict, duplicate_key_divergence, value_reuse, missing_document_type, validation_cluster).
data[].severitystringSeverity level: low, medium, high, or critical.
data[].descriptionstringHuman-readable description of the anomaly.
data[].dismissedbooleanWhether this anomaly has been dismissed.
data[].created_atstringISO 8601 timestamp when the anomaly was detected.

Response

{
  "data": [
    {
      "id": "anom_uuid_1",
      "type": "field_conflict",
      "severity": "high",
      "description": "Conflicting vendor_name across 3 documents",
      "dismissed": false,
      "created_at": "2024-10-02T10:00:00.000Z"
    }
  ]
}
PATCH/v1/cases/:key/anomalies/:id/dismiss

Response

Response fields

dismissedbooleanAlways true on success.

Response

{ "dismissed": true }

Errors

Error responses

400bad_requestInvalid case key format.
401unauthorizedMissing or invalid API key.
404not_foundCase or anomaly not found.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.