audit_list - Charter Docs

GET

granola_audit_list.py

import asyncio

from charter.packs import granola

result = asyncio.run(granola.audit_list.ainvoke({}))

Cannot run with granola.PERSONAL_KEY or granola.WORKSPACE_KEY: only an audit key reads the audit log. With granola.AUDIT_KEY, needs no permission. Pages by cursor: cursor is sent back as cursor.

Query parameters

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. matches `^[a-z][a-z0-9_.-]*$`
`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. ≥ 1; ≤ 30

​Query parameters

Query parameters