Update an audit log export destination
Apply a partial update to a destination. Requires an active Enterprise plan. Returns 409 when the destination was changed concurrently, because the merged configuration this request validated is no longer the one that would be stored; retry against fresh state. Pausing prevents new delivery attempts, but an S3 upload already in progress may complete after the response.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
128Body
3 - 63KMS key ID, alias, or ARN. Set to an empty string to remove the configured KMS key; omit or send null to leave unchanged.
20485121 - 1281 - 2048active, paused Response
Audit log export destination updated
An organization-scoped audit log export destination.
Delivery is at-least-once for rows visible when their window is committed: a delivery that is retried rewrites the same object, and the same event_id can appear in more than one object, so consumers must deduplicate on event_id. Each event-time window is held for ten minutes before it commits; a row that becomes visible after its window is committed may not be delivered.
Objects are written as <prefix>/destination_id=<destination>/org_id=<org>/date=<YYYY-MM-DD>/hour=<HH>/<window>-<chunk>.jsonl.gz, where date and hour are the UTC calendar hour that fully contains every row in the object, so the layout is safe to register as a Hive-partitioned table. The object name is derived from the rows it holds, so a retried delivery rewrites its own object.
3 - 63x >= 0128jsonl.gz 128The Kernel role that assumes role_arn in your account to deliver logs. Allow this role as the principal in your role's trust policy, and require external_id as the sts:ExternalId condition.
Recreating a destination issues a new external_id, which the trust policy has to be updated to match.
20485121 - 1281 - 2048Pausing prevents new delivery attempts. An S3 upload already in progress may complete after the pause response; its rows can appear again after the destination is resumed.
active, paused s3 2048Sanitized description of the most recent delivery failure.
Opaque, versioned checkpoint for forward-only continuous export. This value is not compatible with audit-log list page tokens.
Delivery starts at the moment the destination is activated, so events recorded before that are not delivered. Pausing stops delivery and resuming starts again from the time of the resume: events recorded while a destination was paused are never exported, and pausing is not a way to defer delivery.