We're looking for beta testers.

API reference

Audit log

List and export organization audit events.

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.

← API overview


List audit events

GET /v1/organizations/:org_id/audit-events
Authorization: Bearer <user_or_service_token>

Query parameters

ParamDescription
fromStart time (ISO 8601). Defaults to 30 days before to
toEnd time (ISO 8601). Defaults to now
actor_idFilter by actor id
actor_emailFilter by actor email
actionExact action name
action_prefixActions starting with prefix
target_typeTarget resource type
target_idTarget resource id
cursorPagination 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

StatuserrorWhen
401unauthorizedMissing or invalid token
403forbiddenNot an owner/admin, or token lacks read scope
400invalid_requestRange too wide or invalid filters

See also