Agents
The audit log
Every change made in Agents is recorded: who made it, how (signed in, with an API key, or through the assistant), what it was, and whether it worked. Workspace admins can read it on the Audit log page.
What's recorded
- Resources applied and deleted, with the kinds and names changed.
- Runs started and cancelled, approvals decided and signals sent.
- Runners paired, changed and removed, and registration tokens made and revoked.
- API keys made and revoked, and changes to the assistant's settings.
Reads aren't recorded. Each entry's outcome is one of:
| Outcome | Meaning |
|---|---|
success |
It went through |
denied |
The person or key wasn't allowed to |
error |
It was refused, for example invalid YAML |
Filtering and exporting
Filter by action (for example everything starting runs.), by person, by outcome and by how it was done. Export CSV downloads what's shown. The API returns the same entries, newest first, a page at a time:
curl "https://spudsuite.com/api/w/acme/agents/audit?action=resources.&limit=100" \
-H "Authorization: Bearer $SPUDSUITE_API_KEY"
Pass the next value it returns as before for the next page.