Audit Log

List audit-log entries

Returns mutating API operations and auth lifecycle events for the calling organization, clamped to the per-tier retention window (Free: 7d, Pro: 90d, Custom: per-contract). Only org-level API keys may call this endpoint — agent-scoped keys receive 403.

get/v1/audit-log

Request

Base URL: https://api.chronary.ai
URL: https://api.chronary.ai/v1/audit-log
Auth: HTTP bearer

Query parameters

fromstring date-time

Lower bound (inclusive). Clamped to retention window if older.

Example:2026-05-01T00:00:00.000Z

tostring date-time

Upper bound (inclusive). Defaults to now.

Example:2026-05-11T00:00:00.000Z

actionstring

Filter by exact action name, e.g. agent.create.

Example:agent.create

actor_key_prefixstring

Filter by the first 20 chars of the actor API key.

Example:chr_sk_abcdef12345

cursorstring

Opaque pagination cursor from a previous response.

limitinteger

Page size (1–200). Defaults to 50.

Example:50

Response

Audit-log page

retention_daysinteger nullable required

Audit-log retention window for the caller plan (days). Null = unlimited (Custom plan).

range_clampedboolean required

True when the requested from was outside the retention window and the server clamped it. UI uses this to render an upgrade hint.

Example response

{
  "data": [
    {
      "id": "aud_abc123def456",
      "action": "agent.create",
      "actor_key_prefix": "chr_sk_abcdef12345",
      "resource": "agt_1",
      "ip": "203.0.113.10",
      "status": 201,
      "method": "POST",
      "path": "/v1/agents",
      "duration_ms": 42,
      "request_id": "req_8e9f...",
      "created_at": "2026-05-10T10:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": "MjAyNi0wNS0xMFQxMDowMDowMC4wMDBafGF1ZF8x"
  },
  "retention_days": 90
}

Changes

No recorded changes to this operation across all 1 revision of this API.