Quarantine

Read-only inspection of quarantined payloads. Rejected documents are stored here when the quarantine policy permits it.

Quick Reference

MethodPathSummary
GET /api/v1/quarantine List quarantined entries
GET /api/v1/quarantine/{ref} Inspect a quarantined entry
GET

/api/v1/quarantine

List quarantined entries.

Query Parameters

FieldTypeRequiredDescription
rejectionTypestringNo"parse-error" | "validation-failure"
sourceIdentifierstringNoFilter by source identifier
limitintegerNoMaximum number of entries to return
offsetintegerNoNumber of entries to skip

Response

200 OK
{
  "entries": [...],
  "count": 3
}
GET

/api/v1/quarantine/{ref}

Retrieve by reference ID (returned in error responses as quarantineRef).

Response

200 OK 404 Not found or evicted
{
  "ref": "qr-m1abc-0001",
  "payload": {
    "sensorId": "BAD-01",
    "temperature": "not-a-number"
  },
  "context": {
    "receivedAt": "2026-07-17T10:07:00Z",
    "sourceIdentifier": "default",
    "schemaRef": "temperature-sensor-v1",
    "rejectionReason": "Field 'temperature' expected type number, got string",
    "rejectionType": "validation-failure"
  }
}