---
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`

## Request

- Base URL: `https://api.synthesia.io`
- URL: `https://api.synthesia.io/v2/auditLogs/export`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/synthesia/apis/synthesia-api/docs/v2/auditLogs/export/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/synthesia/apis/synthesia-api.md) - [All operations](https://skmtc.dev/synthesia/apis/synthesia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synthesia/apis/synthesia-api/revisions/f0f34ae0591d?raw)