Proxy Audit Logger

List audit log entries

{
  "data": [
    {
      "id": "log-001",
      "action": "proxy_created",
      "coordinator_id": "coord-119",
      "mentor_id": "mentor-482",
      "activity_id": "pa-001",
      "timestamp": "2026-03-20T09:00:00Z"
    },
    {
      "id": "log-002",
      "action": "bulk_submission",
      "coordinator_id": "coord-119",
      "batch_id": "batch-0042",
      "mentor_ids": [
        "mentor-482",
        "mentor-510"
      ],
      "timestamp": "2026-03-25T08:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 310
  }
}

Get a specific audit log entry

{
  "id": "log-001",
  "action": "proxy_created",
  "coordinator_id": "coord-119",
  "mentor_id": "mentor-482",
  "activity_id": "pa-001",
  "changes": null,
  "timestamp": "2026-03-20T09:00:00Z",
  "ip_address": "192.168.1.42",
  "user_agent": "EircodexApp/2.1 Android"
}

Create an audit log entry (internal/system use)

{
  "action": "proxy_created",
  "coordinator_id": "coord-119",
  "mentor_id": "mentor-482",
  "activity_id": "pa-005"
}

{
  "id": "log-099",
  "action": "proxy_created",
  "coordinator_id": "coord-119",
  "mentor_id": "mentor-482",
  "activity_id": "pa-005",
  "timestamp": "2026-03-26T10:30:00Z"
}

Annotate an audit log entry (admin correction only)

{
  "annotation": "Reviewed by compliance officer on 2026-03-26",
  "reviewed_by": "admin-007"
}

{
  "id": "log-001",
  "annotation": "Reviewed by compliance officer on 2026-03-26",
  "reviewed_by": "admin-007",
  "updated_at": "2026-03-26T11:00:00Z"
}

Delete an audit log entry (admin/compliance only)

{
  "success": true,
  "deleted_id": "log-001"
}

Get all audit logs for a coordinator

{
  "data": [
    {
      "id": "log-001",
      "action": "proxy_created",
      "mentor_id": "mentor-482",
      "activity_id": "pa-001",
      "timestamp": "2026-03-20T09:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 88
  }
}

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