# audit_trail

> Reference for the audit trail tool of Pilotie: the append-only record of changes in a workspace, with every action.

Source: https://pilotie.geenius.io/docs/reference/audit_trail/

The append-only record of changes in one workspace: seats and roles, agents and their keys, secret grants, billing, deletes and deploys. You can always look back.

Call it as `geenius_os(tool: "audit_trail", action: "<action>", args: {...})` through Geenius OS.

## Actions

| Action | What it does |
|---|---|
| `list` | Filter by actor, area, action, target, dates and a search text. |
| `history` | The history of one target. |
| `export` | The same filters as CSV text, up to 5000 rows. |
| `settings` | How long the trail is kept here. |
| `set_retention` | Set retention from 30 to 3650 days (owners and admins). |
| `estate` | Every workspace's trail (super admin only). |

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "list"`. The server answers from its own definitions, so that answer is always current.