List and export audit events for an organization. Only owners and admins may access these routes. API tokens need the read scope.
Successful changes are recorded. Failed attempts are not stored.
List audit events
GET /v1/organizations/:org_id/audit-events
Authorization: Bearer <user_or_service_token>
Query parameters
| Param | Description |
|---|---|
from | Start time (ISO 8601). Defaults to 30 days before to |
to | End time (ISO 8601). Defaults to now |
actor_id | Filter by actor id |
actor_email | Filter by actor email |
action | Exact action name |
action_prefix | Actions starting with prefix |
target_type | Target resource type |
target_id | Target resource id |
cursor | Pagination cursor from a previous response |
Response 200 (excerpt)
{
"data": [
{
"id": "aud_…",
"created_at": "2026-10-20T14:22:11.000Z",
"action": "member.role_changed",
"actor": { "type": "user", "id": "user_…", "email": "alex@example.com" },
"target": { "type": "member", "id": "user_…" },
"summary": "Role set to admin",
"route": "PATCH /api/v1/organizations/:org_id/members/:user_id",
"status": 200
}
],
"meta": { "has_more": false, "next_cursor": null }
}
Export CSV
GET /v1/organizations/:org_id/audit-events/export?format=csv
Authorization: Bearer <user_or_service_token>
Same filters as the list endpoint. The export range may span at most 366 days. The stream includes at most 100,000 rows.
Response is text/csv with a download filename derived from the organization slug.
Errors
| Status | error | When |
|---|---|---|
401 | unauthorized | Missing or invalid token |
403 | forbidden | Not an owner/admin, or token lacks read scope |
400 | invalid_request | Range too wide or invalid filters |