Audit API

DRAFT — Internal Developer Use Only

This API reference is for internal development teams.

Overview

What it is: The audit API provides access to audit logs, metrics, and dashboard views for tracking platform activity and compliance.

Endpoints

Method	Path	Description	Auth required
GET	/internal/v1/audit/logs	List audit log entries	JWT + API token
GET	/internal/v1/audit/metrics	Get audit metrics summary	JWT + API token
GET	/internal/v1/audit/metrics/chart	Get audit metrics chart data	JWT + API token
GET	/internal/v1/audit/dashboard	Get audit dashboard overview	JWT + API token

---

GET /internal/v1/audit/logs

List audit log entries with optional filtering.

Request:

GET /internal/v1/audit/logs?from=2026-02-01&to=2026-02-12&action=login
Authorization: Bearer <token>

Response (200):

{
  "logs": [
    {
      "timestamp": "2026-02-12T09:15:00Z",
      "action": "login",
      "userId": "user-uuid",
      "ip": "10.0.1.50",
      "result": "success"
    }
  ],
  "totalCount": 245
}

---

GET /internal/v1/audit/metrics

Get a summary of audit metrics.

Request:

GET /internal/v1/audit/metrics
Authorization: Bearer <token>

Response (200):

{
  "totalEvents": 15420,
  "byAction": {
    "login": 5200,
    "collection": 8100,
    "configuration": 2120
  },
  "period": "last-30-days"
}