- Access audit logs: see who changed what in your organisation
- Export logs: create an export job for your request logs
- 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
CallGET /audit-logs. start_time, end_time, and organisation_id are required. start_time and end_time are ISO 8601 timestamps.
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
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

