v3

OpenAPI 3.1.02026-07-3182354.4 KB

List audit events

get/v1/audit

Query parameters

actionstring

Return only events with this exact action, or events whose action starts with it followed by a dot (workspace returns workspace.member_added but not workspace_automation.created). Lowercase, as actions are.

Example:workspace

string date

string date-time

string date

string date-time

cursorstring

The cursor to continue from

Example:eyJjcmVkZW50aWFsfQ==

page_sizeinteger

Maximum number of audit events to return per page

Example:10

Response

List of audit events

hasMoreboolean required

Whether there are more audit events to fetch. A page can hold fewer than page_size events and still not be the last one, so page on this and cursor rather than on the number of events returned.

cursorstring nullable required

The cursor to continue from

Example response

{
  "events": [
    {
      "id": "aud_7Kq2mXbT9vRp3L",
      "action": "workspace.member_added",
      "occurred_at": "2026-01-27T15:30:00Z",
      "actor": {
        "object": "user",
        "id": "usr_3nQ8vLpZ2kR7dY",
        "email": "oat@granola.ai"
      },
      "data": {
        "role": "member"
      },
      "context": {
        "ip_address": "203.0.113.42",
        "user_agent": "Granola/7.400.0 (macOS 15.3)",
        "client_version": "7.400.0"
      }
    }
  ],
  "hasMore": true,
  "cursor": "eyJjcmVkZW50aWFsfQ=="
}