---
title: "Export audit log events as CSV"
method: POST
path: "/v2/auditLogs/export"
tags: ["Audit Logs"]
---

# Export audit log events as CSV

`POST /v2/auditLogs/export`

Export audit log events for a workspace or organization as a CSV file.
Exactly one of workspaceId or organizationId must be provided.

Supports the same filtering options as the query endpoints:
- Date range (Unix timestamps)
- Multiple actions
- Multiple actor IDs
- Target ID

**Export limits:**
- Maximum 10,000 events per export
- If more events match the filters, the export will be truncated
- Truncated exports include "_TRUNCATED" in the filename

**Example requests:**
- Export all events for an organization:
  {"organizationId": "12345678-1234-1234-1234-123456789abc"}
- Export filtered events:
  {"organizationId": "12345678-1234-1234-1234-123456789abc",
   "startDate": 1704067200, "endDate": 1735689599,
   "actions": ["billing.credits.consumed", "video.created"]}
- Export by workspace with filters:
  {"workspaceId": "12345678-1234-1234-1234-123456789abc",
   "actorIds": ["user-123", "user-456"]}

This endpoint is rate-limited and usage is tracked against your API quota.

## Request body

- AuditLogsExportRequest
  - `workspaceId` string, uuid, nullable
  - `organizationId` string, uuid, nullable
  - `startDate` integer, nullable
  - `endDate` integer, nullable
  - `actions` string[], nullable
  - `actorIds` string[], nullable
  - `targetId` string, nullable

## Response `200`

CSV file containing audit log events

## Other responses

- `400` — Invalid request parameters
- `403` — Forbidden - Wrong API key or Public API access disabled
- `404` — Workspace or organization not found
- `429` — Rate limit exceeded
- `default` — Unexpected Server error

---

[API](https://skmtc.net/synthesia/apis/synthesia-api.md) · [All operations](https://skmtc.net/synthesia/apis/synthesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthesia/synthesia-api/versions/f0f34ae0591d/schema)