---
title: "Export project audit log as a JSON file"
method: POST
path: "/v1/audit/log/download"
tags: ["Journal"]
---

# Export project audit log as a JSON file

`POST /v1/audit/log/download`

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.

## Request body

- DownloadAuditLogParamsDto
  - `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_date` string — Return events created at or after this timestamp. Cannot be earlier than 90 days ago. Default is 90 days ago.
  - `end_date` string — Return events created at or before this timestamp. Cannot be before the start date.

## Response `200`

- DownloadAuditLogResponseDto
  - `url` string, required — Pre-signed URL to download the exported audit log JSON file. Short-lived; request a new export once it expires.
  - `expires_at` string, required — ISO timestamp after which the download URL expires.

## Other responses

- `403` — The API credentials belong to a `developer` member rather than the project owner or an `admin` member.

---

[API](https://skmtc.net/datacrunch/apis/verda-cloud-public-api.md) · [All operations](https://skmtc.net/datacrunch/apis/verda-cloud-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datacrunch/verda-cloud-public-api/revisions/0d66c7340876/schema)
