Duplicate Warning Event Logger - API Contract

GET /api/v1/duplicate-warning-events/api/v1/duplicate-warning-events

List all duplicate warning audit events

Public

Response Example

{
  "data": [
    {
      "event_id": "dwe-5501",
      "event_type": "duplicate_detected",
      "match_id": "dam-0091",
      "contact_id": "contact-8821",
      "coordinator_id": null,
      "logged_at": "2026-03-26T11:20:00Z"
    },
    {
      "event_id": "dwe-5502",
      "event_type": "warning_dismissed",
      "match_id": "dam-0091",
      "contact_id": "contact-8821",
      "coordinator_id": "user-coord-55",
      "logged_at": "2026-03-26T13:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 28
  }
}

GET /api/v1/duplicate-warning-events/api/v1/duplicate-warning-events/:id

Get a specific warning event by ID

Public

Response Example

{
  "event_id": "dwe-5502",
  "event_type": "warning_dismissed",
  "match_id": "dam-0091",
  "contact_id": "contact-8821",
  "coordinator_id": "user-coord-55",
  "resolution_note": "Verified distinct events across chapters",
  "logged_at": "2026-03-26T13:00:00Z"
}

POST /api/v1/duplicate-warning-events/api/v1/duplicate-warning-events

Log a new duplicate warning event (detected, dismissed, or cancelled)

Public

Request Example

{
  "event_type": "duplicate_detected",
  "match_id": "dam-0091",
  "contact_id": "contact-8821",
  "coordinator_id": null
}

Response Example

{
  "event_id": "dwe-5503",
  "event_type": "duplicate_detected",
  "match_id": "dam-0091",
  "contact_id": "contact-8821",
  "coordinator_id": null,
  "logged_at": "2026-03-26T12:00:00Z",
  "created_at": "2026-03-26T12:00:00Z"
}

PUT /api/v1/duplicate-warning-events/api/v1/duplicate-warning-events/:id

Update an event record (e.g. add resolution note after the fact)

Public

Request Example

{
  "resolution_note": "Coordinator confirmed separate event, approved"
}

Response Example

{
  "event_id": "dwe-5503",
  "event_type": "duplicate_detected",
  "match_id": "dam-0091",
  "resolution_note": "Coordinator confirmed separate event, approved",
  "updated_at": "2026-03-26T14:30:00Z"
}

DELETE /api/v1/duplicate-warning-events/api/v1/duplicate-warning-events/:id

Remove a warning event log record

Public

Response Example

{
  "deleted": true,
  "event_id": "dwe-5503"
}

POST /api/v1/duplicate-warning-events/api/v1/duplicate-warning-events/flush

Flush buffered events to persistent storage

Public

Response Example

{
  "flushed": true,
  "events_written": 4,
  "flushed_at": "2026-03-26T14:00:00Z"
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}