Audit log API
Read your team's audit log over the Servor API with an audit:read token — a chronological record of who did what, for compliance and security review.
Read your team's audit log over the API. The audit log is a chronological record of significant actions in your team — who did what, and when — which makes it the backbone of any compliance export, security review or SIEM integration you want to build on top of Servor.
This endpoint requires the audit:read scope.
/v1/auditScope: audit:readList audit entries
Parameters
actionstringquery · optionalFilter by action-type prefix, e.g. "incident.".
limitintegerquery · optionalMax entries, 1–200 (default 100).
Example request
curl https://api.servor.app/v1/audit \
-H "Authorization: Bearer sv_live_..."Example response
[
{
"id": "uuid",
"actionType": "incident.created",
"resourceType": "incident",
"resourceId": "uuid",
"ipAddress": "203.0.113.10",
"createdAt": "2026-08-20T10:00:00.000Z"
}
]What you get back
GET /v1/audit returns audit entries for your team, most recent first. Each
entry captures an action and the actor who performed it, so you can answer
"who changed this, and when?" long after the fact.
curl https://api.servor.app/v1/audit \
-H "Authorization: Bearer sv_live_..."Regular exports
For compliance you'll usually want to pull the audit log on a schedule and store it in your own system. Keep polling within the rate limits — a periodic export, not a tight loop.
Audit log vs. command history
Both are records of activity, but they answer different questions:
| Audit log | Command history | |
|---|---|---|
| Scope | Team-wide actions | Commands run on one server |
| Answers | "Who changed this?" | "What was run here?" |
| Scope needed | audit:read | commands:read |
Use the audit log for team and account activity; use command history for the exact commands executed on a given server.
Notes
- The audit log never contains secrets, passphrases or encrypted payloads — only the fact that an action happened and who performed it.
- The same log is browsable in the dashboard — open the audit log in Servor.
- A
403means your token is missing theaudit:readscope. See errors for the full list of status codes.