Skip to main content
ZStack
Identity & Access/ZIAM

ZiamListAuditEvents

Lists ZIAM management API audit events. Audit records are produced automatically by the management API gateway layer, so new management APIs are recorded without extra per-feature audit wiring.

GET/api/v1/ziam/audit-events

Operation ID

ZiamListAuditEvents

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Query Parameters

  • actor
    String

    Actor filter. It is usually the token subject, for example built-in/admin.

  • action
    String

    Action filter. Action is derived from request path and method, for example resources.users.create.

  • resource
    String

    Resource path filter, for example resources/users/11111111111111111111111111111111.

  • result
    String

    Request result filter.

    Example: success

  • requestId
    String

    Request id filter. The value comes from X-Request-Id or the generated request id.

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • status
    String

    Response status.

    Example: ok

  • data
    List

    Audit event list.

    Example: (nested array)

    • id
      String

      Audit event id.

      Example: audit-001

    • actor
      String

      Actor that sent the request. It is usually the token subject.

      Example: built-in/admin

    • action
      String

      Action derived from request path and method.

      Example: resources.users.create

    • resource
      String

      Resource path inside the ZIAM API namespace.

      Example: resources/users

    • result
      String

      Request result.

      Example: success

    • requestId
      String

      Request id from X-Request-Id or generated by ZIAM.

      Example: request-001

    • createdAt
      String

      Audit event creation time.

      Example: 2026-06-12T10:00:00Z

    • metadata
      LinkedHashMap

      Request metadata captured by ZIAM, such as method, path, and status.

      Example: (nested object)