Delete Audit Records

Delete audit log records older than a specific date or duration to enforce log retention policies.

curl -X PUT https://<domain>/api/vault/namespace/delete/audit-records \
  -H "Authorization: Bearer <NAMESPACE_ADMIN_API_KEY>" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "data": {
      "duration": 180
    }
  }'

{
  "data": {
    "tracking_id": "e1a45f62-92b4-4dd8-8c12-3f98c9cbd912",
    "status": "PENDING",
    "job_type": "data-deletion"
  },
  "success": true,
  "error": { "message": "" }
}

Deletes audit log records from a namespace that are older than a given date or duration.

Audit records include requested API, user identity, input payload, response payload, and status/timestamps.

Endpoint

Method	Endpoint
`PUT`	`https://<domain>/api/vault/namespace/delete/audit-records`

Request body

body

datestring

Delete audit records created before this date. Format: YYYY-MM-DD.

body

durationinteger

Delete audit records older than this many days.

Before deleting audit records, consider exporting them for compliance archiving if your policy requires long-term retention evidence. Use the Audit Logs API to export before deletion.

Was this page helpful?

Last updated 3 weeks ago

Built with Documentation.AI