List organisation audit logs
list_organisation_audit_logsRead the organisation's audit trail, newest first (the twin of GET /org/organisation/audit-logs and ankra org audit-logs): who did what, to what, and whether it worked. Each entry carries timestamp, actor (type is agent for an Ankra AI run, service_account for a token, system for the platform, human for a person; agent_name and run_id name the run), action_type, resource_type and resource_id, target (kind, name, namespace), outcome (status succeeded, failed or unknown; unknown means the writer recorded no success marker, not a failure), the cluster it belongs to, and the recorded details. Filter by search text, user_id, action_type, resource_type, cluster_id, actor_type, outcome, agent_task_id and a start_date/end_date window; page with page and page_size (default 25, at most 100). total and total_pages say how many match. The trail is organisation-wide, so a caller confined to a project is refused. Read-only; needs audit.read (organisation owners and admins).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_organisation_audit_logs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. | |
| search | No | Free text matched against the actor's email, action_type, resource_type, resource_id and the recorded details. | |
| outcome | No | Only entries with this outcome. | |
| user_id | No | Only entries written by this member (user id from list_organisation_members). | |
| end_date | No | Latest entry time, a date (2026-12-31, which includes that whole day UTC) or an RFC 3339 timestamp. Send the same date as start_date and end_date to read one day. | |
| page_size | No | Entries per page, 1 to 100 (default 25). | |
| actor_type | No | Only entries by this kind of actor. | |
| cluster_id | No | Only entries that belong to this cluster of the organisation, including clusters that have since been deleted (cluster_id and cluster_is_deleted on an entry name them). | |
| start_date | No | Earliest entry time, a date (2026-12-31, from its midnight UTC) or an RFC 3339 timestamp. | |
| action_type | No | Only entries with exactly this action_type. | |
| agent_task_id | No | Only entries written by the runs of this agent. | |
| resource_type | No | Only entries with exactly this resource_type. |