API reference · 2 endpoints

Audit logs

Query the audit trail of recall and MCP activity in a namespace.

GET/v1/default/namespaces/{namespace_id}/audit-logs

List audit logs

List audit log entries for a namespace, ordered by most recent first.

Parameters

namespace_idstringpathrequired
actionstring | nullquery

Filter by action type

transportstring | nullquery

Filter by transport (http, mcp, system)

start_datestring | nullquery

Filter from this ISO datetime (inclusive)

end_datestring | nullquery

Filter until this ISO datetime (exclusive)

limitintegerquery

Max items to return

offsetintegerquery

Offset for pagination

curl -X GET "https://api.illumina.sh/v1/default/namespaces/demo/audit-logs" \
  -H "Authorization: Bearer $ILLUMINA_API_KEY"
Response · 200
{
  "namespace_id": "demo",
  "total": 1,
  "limit": 1,
  "offset": 1,
  "items": [
    {
      "id": "ite_123",
      "action": "action",
      "transport": "transport",
      "namespace_id": "demo",
      "started_at": "started at",
      "ended_at": "ended at",
      "request": {},
      "response": {},
      "metadata": {}
    }
  ]
}

400 · 401 · 402 · 403 · 404 · 405 · 409 · 410 · 422see error reference

GET/v1/default/namespaces/{namespace_id}/audit-logs/stats

Audit log statistics

Get audit log counts grouped by time bucket for charting.

Parameters

namespace_idstringpathrequired
actionstring | nullquery

Filter by action type

periodstringquery

Time period: 1d, 7d, or 30d

curl -X GET "https://api.illumina.sh/v1/default/namespaces/demo/audit-logs/stats" \
  -H "Authorization: Bearer $ILLUMINA_API_KEY"
Response · 200
{
  "namespace_id": "demo",
  "period": "period",
  "trunc": "trunc",
  "start": "start",
  "buckets": [
    {
      "time": "time",
      "actions": {
        "key": 1
      },
      "total": 1
    }
  ]
}

400 · 401 · 402 · 403 · 404 · 405 · 409 · 410 · 422see error reference

Search docs

Search the documentation