> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# audit_list

> Read the workspace audit log: membership changes, note views, recordings and the rest, each with who did it and how the request reached Granola. Filter by action prefix and by date, within a one-year retention window. Events come back in collected_at order, not occurred_at order.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://public-api.granola.ai/v1/audit"}</code></div>

```python granola_audit_list.py theme={null}
from charter.packs import granola

result = await granola.audit_list.ainvoke({})
```

<Note>
  Pages by cursor: `cursor` is sent back as `cursor`.
</Note>

## Query parameters

<div className="reference-table">
  | Field            | Type      | Description                                                                                                                                                                                                                                                                                   |
  | ---------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `action`         | `string`  | 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. <span className="field-constraints">matches `^[a-z][a-z0-9_.-]*$`</span> |
  | `occurredBefore` | `string`  | Return events that occurred before this date. Must fall within the one-year retention window; an earlier date is rejected. A date (`2026-01-27`) or a date-time (`2026-01-27T15:30:00Z`).                                                                                                     |
  | `occurredAfter`  | `string`  | Return events that occurred after this date. Must fall within the one-year retention window; an earlier date is rejected. A date (`2026-01-27`) or a date-time (`2026-01-27T15:30:00Z`).                                                                                                      |
  | `cursor`         | `string`  | The cursor to continue from                                                                                                                                                                                                                                                                   |
  | `pageSize`       | `integer` | Maximum number of audit events to return per page. The server returns 10 when this is absent. <span className="field-constraints">≥ 1; ≤ 30</span>                                                                                                                                            |
</div>