Audit Log

Export audit entries as NDJSON

Streams a project's audit-log entries as newline-delimited JSON — one entry object per line, oldest first — for archival before the retention window expires, or for shipping into an external system. project_id is required: the export is per-project by design. Filters behave exactly as they do on the list endpoint.

get/v1/projects/{project_id}/audit-log/export

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/audit-log/export
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

actionstring

Exact permission-action string, e.g. secrets:DeleteSecret

principal_idstring

Public id of the principal (user_… or key_…)

resource_public_idstring

Exact target resource public id, e.g. sec_…

resource_srnstring

SRN prefix match, e.g. srn:{project}:secret:. The log is append-only, so a stored SRN is never rewritten; the filter matches it as stored.

fromstring date-time

Only entries created at or after this timestamp (ISO 8601)

tostring date-time

Only entries created at or before this timestamp (ISO 8601)

Response

A newline-delimited stream of audit entries. Each line is a JSON object with the same fields as AuditEntry.

Changes

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