Skip to content

Audit API

Audit log.

1 operation. Every call needs a session cookie or an Authorization: Bearer nct_… token unless marked Public. Conventions, errors and scopes

GET/audit-events

List audit events, newest first

Requires the admin scope (browser sessions hold every scope). Filter by projectId, resourceId and type (an action prefix).

ParameterInTypeDescription
cursorquerystringOpaque cursor from a previous page's nextCursor
limitqueryinteger (int64)Page size (default 50, max 200)
projectIdquerystring (uuid)Only events of this project
resourceIdquerystringOnly events about this resource (service, deployment, …)
typequerystringAction prefix, e.g. deployment. or variable.set
Response 200 · OK · application/json
PageAuditEvent
  • AuditEvent[] | nullrequired
  • nextCursorstring
    Present when more items exist
Errors
  • 401Unauthorized
  • 403Forbidden
  • 422Unprocessable Entity
  • 500Internal Server Error

Errors are RFC 9457 application/problem+json with a stable code field.