Skip to main content
This page covers three tasks. Each has an app flow and an API flow.
  1. Access audit logs: see who changed what in your organisation
  2. Export logs: create an export job for your request logs
  3. Download exported logs: get the finished file

1. Access audit logs

Audit logs record administrative changes: who made a change, to which resource, and when.

Access in the app

Go to Admin Settings > Audit Logs. Audit logs are collected automatically across all workspaces. See Audit Logs for what each entry contains.

Filters

Narrow the results with any of these filters: In the app, use the filters on the Audit Logs page.

Access with the API

Call GET /audit-logs. start_time, end_time, and organisation_id are required. start_time and end_time are ISO 8601 timestamps.
Add any of these query parameters to filter the results: Results are paginated. Use current_page and page_size (maximum 100) to page through them.

2. Export logs

Exports run as jobs. Each job writes your request logs for a time range to a JSONL file, up to 50,000 logs per job.

Export in the app

1

Open Exports

Go to Exports on the main sidebar and click Request Data.
2

Configure the export

Set the Time Range, the Logs Limits (maximum number of logs or a custom offset), and the Requested Fields to include.
3

Request and start the export

Click Request Export. The job appears in the exports list with the status Draft. Click Start to run it.

Export with the API

Create the export job, then start it. The job runs asynchronously.
1

Create the export

POST /v1/logs/exports with a time range and the fields to export. The response contains the export id.
2

Start the export

POST /v1/logs/exports/{export_id}/start
For the full list of fields, restrictions on exportable fields, and a complete script, see Logs Export.

3. Download exported logs

Download in the app

1

Wait for the export to finish

Open Exports on the main sidebar. The status changes to Success when the job is done. If it shows Failure, click Start Again to retry.
2

Download the file

Click Download next to the completed export. The file is in JSONL format, one log entry per line.

Download with the API

1

Check the export status

GET /v1/logs/exports/{export_id}. Repeat until status is success. A status of failure means the job failed.
2

Get the download URL

GET /v1/logs/exports/{export_id}/download returns a signed URL.
3

Download the file

Audit Logs

Logs Export

Last modified on November 18, 2026