Sign in
Journal

Export project audit log as a JSON file

Streams the full audit log (matching the given filters, within the retention window) to object storage and returns a short-lived pre-signed download URL.

post/v1/audit/log/download

Request body

action'other' | 'create' | 'start' | 'start_complete' | 'shutdown_complete' | 'shutdown' | 'delete' | 'delete_complete' | 'attach' | 'attach_complete' | 'detach' | 'detach_complete' | 'clone' | 'resize' | 'rename' | 'transfer' | 'trash' | 'trash_complete' | 'restore' | 'cancel' | 'provisioning' | 'running' | 'configure_spot' | 'authenticate' | 'expire' | 'accept' | 'update_role' | 'revoke' | 'login' | 'logout' | 'login_failed' | 'auth_mfa_enable' | 'auth_mfa_disable' | 'auth_mfa_challenge' | 'auth_mfa_verify' | 'password_reset' | 'complete' | 'redeem' | 'suspend' | 'unsuspend' | 'approve' | 'decline'

Filter by action type

object_type'compute' | 'volume' | 'ssh_key' | 'invite' | 'user' | 'member' | 'cloud_api_credential' | 'object_storage_bucket' | 'object_storage_key_pair' | 'custom_image' | 'startup_script' | 'topup' | 'coupon' | 'bank_transfer' | 'bank_transfer_account' | 'balance' | 'other' | 'object_storage' | 'quota_request'

Filter by object type

start_datestring

Return events created at or after this timestamp. Cannot be earlier than 90 days ago. Default is 90 days ago.

end_datestring

Return events created at or before this timestamp. Cannot be before the start date.

Example request

{
  "start_date": "2026-01-01T00:00:00.000Z"
}

Response

urlstring required

Pre-signed URL to download the exported audit log JSON file. Short-lived; request a new export once it expires.

expires_atstring required

ISO timestamp after which the download URL expires.

Example response

{
  "url": "https://object.storage.com/project-id/audit-log-20260317-141552-uuid.json?X-Amz-Signature=...",
  "expires_at": "2026-03-17T14:30:52.872Z"
}

Changes

Changed in 2 of the 11 revisions of this API.6

  • 021b65a9a19c3See the full diff
    • ○

      added the new approve enum value to the request property action

      request-property-enum-value-added

    • ○

      added the new decline enum value to the request property action

      request-property-enum-value-added

    • ○

      added the new quota_request enum value to the request property object_type

      request-property-enum-value-added

  • 7949ae658ff13See the full diff
    • ○

      added the new object_storage enum value to the request property object_type

      request-property-enum-value-added

    • ○

      added the new suspend enum value to the request property action

      request-property-enum-value-added

    • ○

      added the new unsuspend enum value to the request property action

      request-property-enum-value-added