Skip to main content
ZStack
Identity & Access/ZIAM

ZiamGetAuditEvent

Returns one ZIAM audit event by id, including request metadata captured by the management API gateway layer.

GET/api/v1/ziam/audit-events/{id}

Operation ID

ZiamGetAuditEvent

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

Path Parameters

  • id
    StringRequired

    Audit event id.

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • status
    String

    Response status.

    Example: ok

  • data
    Object

    Audit event payload.

    • 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)