Downloads the audit log as a file, newest entry first.
HTTP
GET /org/audit/exportAccess: Session token only. API keys get 403 with insufficient_scope.
Role: Organisation owner or admin.
Query parameters #
All are optional. The filters are the same as for the audit log: action, user, from and to.
| Parameter | Type | Description |
|---|---|---|
format | string | csv (the default) or json. |
The export holds at most 50,000 entries. Narrow it with from and to if you have more.
Response 200 #
A file, sent as an attachment.
csv:Content-Type: text/csv, with the headerid,time,person,email,action,description,ip,user_agent. A cell that starts with=,+,-or@gets a leading', so a spreadsheet does not run it as a formula.json: the same list of entries as the audit log.
Errors #
| Status | error | When |
|---|---|---|
| 401 | unauthenticated | The token is missing or not valid. |
| 403 | forbidden | You are not an owner or admin. |
| 422 | invalid_request | A query parameter is not valid. fields names it. |
| 429 | rate_limited | Too many requests, see Rate limiting. |
See Errors for the error format.
Notes #
Every export is recorded in the audit log as audit.exported, after the entries were read, so the export does not contain its own entry.