Skip to main content
ZStack
Identity & Access/Credentials

ListAuditLogs

List credential audit log entries with optional filters for credential, action, operator, and time range.

GET/api/v1/credential-audit

Operation ID

ListAuditLogs

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

  • credentialUuid
    String

    UUID of the credential whose audit logs should be listed.

  • action
    String

    Filter logs by action type (e.g. CREATE, REVEAL).

  • operator
    String

    Filter logs by the operator account that performed the action.

  • since
    String

    Return only audit logs created after this timestamp.

  • until
    String

    Return only audit logs created before this timestamp.

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • items
    List

    List of audit log entries matching the query.

    Example: (nested array)

    • uuid
      String

      Unique identifier of this audit log entry.

      Example: log-00112233-4455-6677-8899-aabbccddeeff

    • credentialUuid
      String

      UUID of the credential that this log entry relates to.

      Example: cred-a1b2c3d4-e5f6-7890-abcd-ef1234567890

    • credentialName
      String

      Name of the credential at the time the operation was performed.

      Example: prod-db-password

    • action
      String

      Type of action performed (e.g. CREATE, UPDATE, DELETE, REVEAL).

      Example: REVEAL

    • operator
      String

      Account or principal that performed the action.

      Example: ops@example.com

    • details
      String

      Additional contextual details about the operation.

      Example: Revealed by automation pipeline for deployment job #42

    • createDate
      String

      Timestamp when this audit log entry was created.

      Example: 2026-01-15T08:00:00Z

  • total
    Integer

    Total number of audit log entries matching the filter (before pagination).

    Example: 100

  • limit
    Integer

    Maximum number of items returned per page.

    Example: 50

  • offset
    Integer

    Number of items skipped before this page.

    Example: 20