Sign in
Audit Logs

Search tenant setting change events

Searches for tenant-level setting change events with page-number based pagination. Requires a tenantId filter in filter.must. Returns totalPages and totalElements for direct page navigation.

post/admin/audit/v2/tenant-settings

Headers

Content-Typestring required

The Content-Type of the request must be application/json.

Accept-Encodingstring

Include the Accept-Encoding: gzip header to compress responses as a gzipped file.

Zuora-Track-Idstring

A custom identifier for tracing the API call. If you specified a tracing identifier in the request headers, Zuora returns the same tracing identifier. Otherwise, Zuora does not set this header.

Zuora-Entity-Idsstring

An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in.

Zuora-Org-Idsstring

Comma separated IDs. If you have Zuora Multi-Org enabled, you can use this header to specify which orgs to perform the operation in.

Request body

Response

OK

countinteger

The number of events returned in the current page.

firstPageTokenstring
lastPageTokenstring
nextTokenstring nullable
previousTokenstring nullable
totalPagesinteger

The total number of pages available for the query.

totalElementsinteger

The total number of events that match the query.

Example response

{
  "count": 25,
  "firstPageToken": "0",
  "lastPageToken": "0",
  "totalPages": 1,
  "totalElements": 25,
  "events": [
    {
      "eventId": "a7b8c9d0-e1f2-3456-ghij-678901234567",
      "timestamp": "2025-05-25T11:30:00.000Z",
      "username": "tenant.admin@customer.com",
      "userId": "c47ac10b-58cc-4372-a567-0e02b2c3d484",
      "action": "UPDATE",
      "actionDetails": "Password policy updated - minimum length changed from 8 to 12",
      "objectType": "SECURITY_POLICY",
      "objectId": "sp-10138-001",
      "objectname": "Password Policy",
      "tenantId": "10138",
      "namespace": "tenant",
      "settingtype": "SECURITY_POLICY",
      "attributeid": "minPasswordLength",
      "attributename": "Minimum Password Length",
      "changetype": "MODIFY",
      "transactionid": "txn-sp-789"
    }
  ]
}

Changes

No recorded changes to this endpoint across all 4 revisions of this API.