Duplicate Reviewed Flag Middleware - API Contract

GET /api/v1/duplicate-flags/api/v1/duplicate-flags

List duplicate review flags

Public

Response Example

{
  "data": [
    {
      "id": "flag-901",
      "activity_id": "act-2847",
      "was_reviewed": true,
      "is_consistent": true,
      "flag_applied_at": "2026-03-25T11:00:00Z",
      "applied_by": "coord-12"
    },
    {
      "id": "flag-902",
      "activity_id": "act-2998",
      "was_reviewed": false,
      "is_consistent": null,
      "flag_applied_at": "2026-03-24T09:00:00Z",
      "applied_by": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2
  }
}

GET /api/v1/duplicate-flags/api/v1/duplicate-flags/:id

Get a specific flag record

Public

Response Example

{
  "id": "flag-901",
  "activity_id": "act-2847",
  "was_reviewed": true,
  "is_consistent": true,
  "flag_applied_at": "2026-03-25T11:00:00Z",
  "applied_by": "coord-12",
  "default_flags": {
    "was_reviewed": false,
    "is_flagged": true,
    "review_required": true
  }
}

POST /api/v1/duplicate-flags/api/v1/duplicate-flags

Apply a reviewed flag to an activity payload

Public

Request Example

{
  "activity_id": "act-3055",
  "was_reviewed": true,
  "payload": {
    "peer_id": "peer-0118",
    "activity_type_id": "act-type-03",
    "date": "2026-03-25",
    "duration_minutes": 60
  }
}

Response Example

{
  "id": "flag-903",
  "activity_id": "act-3055",
  "was_reviewed": true,
  "is_consistent": true,
  "flag_applied_at": "2026-03-26T16:00:00Z",
  "applied_payload": {
    "peer_id": "peer-0118",
    "activity_type_id": "act-type-03",
    "date": "2026-03-25",
    "duration_minutes": 60,
    "was_reviewed": true
  }
}

PUT /api/v1/duplicate-flags/api/v1/duplicate-flags/:id

Validate or update flag consistency

Public

Request Example

{
  "was_reviewed": true,
  "payload": {
    "peer_id": "peer-0091",
    "activity_type_id": "act-type-03",
    "date": "2026-03-20",
    "was_reviewed": true
  }
}

Response Example

{
  "id": "flag-901",
  "activity_id": "act-2847",
  "was_reviewed": true,
  "is_consistent": true,
  "validation_result": {
    "passed": true,
    "inconsistencies": []
  },
  "last_validated_at": "2026-03-26T16:30:00Z"
}

DELETE /api/v1/duplicate-flags/api/v1/duplicate-flags/:id

Remove a flag record

Public

Response Example

{
  "message": "Flag flag-901 removed."
}

Additional Metadata

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