Docs: Tool reference
audit toolset

list_audit_events

List audit events. Lists who changed what, newest first: actor, surface (web, rest, mcp), client name and version, capability, resource, and before/after values. Filter by actor, surface, client, capability (ID like members.invite or tool name like invite_member), resource and date range. Managers and owners see every event; contributors see only their own. Paginated: pass next_cursor back as cursor. No side effects.

Toolset
audit
Who can call it
OwnersManagersContributorsAPI keys
REST
GET /api/v1/w/{workspace}/audit-events
Behavior
read-onlyidempotent

Input

FieldTypeDescription
actor_typeone of: member, end_user, service, account, system
actor_idstringMember, end user, API key or account ID.
surfaceone of: web, rest, mcp, system
client_namestringExact client name, e.g. claude-ai.
capabilitystringCapability ID (members.invite) or MCP tool name (invite_member).
resource_typestringFor example member or invitation.
resource_idstring
sincestring (date-time)Only events at or after this time.
untilstring (date-time)Only events before this time.
cursorstringPass the previous response's next_cursor to get the next page.
limitintegerItems per page (default 25, max 100). Default: 25.

Output

FieldTypeDescription
itemsrequiredarray of object
next_cursorrequiredstring or nullCursor for the next page, or null when this is the last page.
admin_urlrequiredstring (uri)

Calling it

// MCP: tools/call
{ "name": "list_audit_events", "arguments": {} }

// Typed client
await carechannel.list_audit_events({});