Admin API

All admin endpoints require the admin role.

Users

GET    /api/admin/users          # list users
POST   /api/admin/users          # create user
GET    /api/admin/users/{id}     # get user
PUT    /api/admin/users/{id}     # update user
DELETE /api/admin/users/{id}     # delete user
POST   /api/admin/users/{id}/unlock   # unlock locked account

Audit log

GET /api/admin/audit?page=1&limit=50&user_id=...&action=...

Export:

GET /api/admin/audit/export?format=csv
GET /api/admin/audit/export?format=json

System health

GET /api/admin/health

Returns worker status, database connectivity, ingestion queue depth, and external API availability.

Security policies

GET  /api/admin/policies    # get current policies
PUT  /api/admin/policies    # update policies

Example — update password policy:

{
  "min_password_length": 14,
  "require_uppercase": true,
  "require_digit": true,
  "require_special": true,
  "password_history": 5,
  "max_password_age_days": 90,
  "lockout_threshold": 5,
  "lockout_duration_minutes": 15
}