Tearleads

GET/root/audit-events

Page recorded operator actions

Operation root.auditEvents.list

Description

Pages recorded root operator actions newest first, optionally only those involving one identity or organization. Only root operators may call it, and reading the trail is itself recorded.

Authentication

Requires a signed-in session: the client sends its session token as a bearer token in the Authorization header.

Parameters

NameInTypeDetails
cursorquerystringoptional
  • not empty
limitqueryintegeroptional
  • 1 to 200
subjectIdquerystringoptional
  • lowercase UUID v4

Responses

200 OK

application/jsonRootAuditEventsResponse

A page of recorded operator actions, newest first.

2 fields
  • eventslist of RootAuditEventResponserequired
  • nextCursorstringrequirednullable

    Opaque cursor for the next page, or null at the end.

Other fields are allowed.

Other responses

StatusMeaningBody
400Bad Request

application/jsonErrorResponse

401Unauthorized

application/jsonSessionFailureResponse

403Forbidden

application/jsonErrorResponse

500Internal Server Error

application/jsonErrorResponse

503Service Unavailable

application/jsonErrorResponse