Organizations

Set organization audit capture

Fresh organization administrator authorization, literal metadata.capabilities.auditLogs=true and visibility required. Only captureOn and expectedRevision are accepted. Enabling requires Enterprise or explicit installation entitlement and capture rollout availability. A missing policy is initialized with server-owned temporary defaults; expectedRevision=0 is accepted only by the initializing request. Explicit OFF initializes and disables atomically, never publishing intermediate ON. Disabling remains available after entitlement loss while flagged. Revision conflicts require refresh; matching no-ops do not record duplicate events. Changes and immutable lifecycle evidence commit atomically. Existing capacity configuration and retained history are unchanged.

patch/v1/audit/settings

Request body

captureOnboolean required
expectedRevisioninteger required

Response

Latest audit policy, entitlement and retained usage.

captureOnboolean required
captureAvailableboolean required
captureEnabledboolean required
retainedOperationsinteger required
eventCountinteger required
logicalBytesinteger required
oldestAvailableAtstring date-time nullable required
measuredAtstring date-time nullable required
billing'disabled' required
cleanup'dry_run' required
drains'not_configured' required

Changes

Changed in 1 of the 49 revisions of this API.1