Skip to main content

Audit

1 operation in the Tolvi API, version 1. Paths are relative to https://api.tolvi.co.uk. Every amount is integer pence.

List the firm’s audit trail, newest first

GET/api/v1/audit-log

Scopes
settings:admin
Role
Firm admin

Parameters

Parameters for GET /api/v1/audit-log
NameInTypeDescription
limitqueryinteger
cursorquerystring
viaquerystring (AuditVia)

One of: web, api, mcp

Responses

200 OK, application/json

Body: object (AuditPage).

200 OK response for GET /api/v1/audit-log
FieldTypeDescription
rowsrequiredarray of AuditEntry
rows[].​idrequiredstring (uuid)
rows[].​occurredAtrequiredstring (date-time)
rows[].​actorUserIdrequiredstring (uuid)nullable
rows[].​principalKindrequiredstring (PrincipalKind)

One of: session, oauth, personal_token, client

rows[].​credentialIdrequiredstring (uuid)nullable
rows[].​clientIdrequiredstringnullable
rows[].​viarequiredstring (AuditVia)

One of: web, api, mcp

rows[].​viaLabelrequiredstring

example "via MCP (Claude)"

rows[].​methodrequiredstring

example "GET"

rows[].​pathrequiredstring

example "/api/v1/work"

rows[].​statusrequiredinteger
rows[].​toolrequiredstringnullable

example "list_my_work"

rows[].​actionstringnullable

A sensitive action recorded in the same transaction as the action itself.

example "evidence.download"

rows[].​targetstringnullable

Whose work it was: the client’s name, where the entry can say.

rows[].​summarystring

What happened, in words.

example "Started accounts, Harrow & Finch Ltd"

nextCursorrequiredstringnullable

Opaque cursor for the next page (pass as cursor); null on the last page.

pageSizerequiredinteger

The page size that was used.

1 to 100

Errors: 400 Bad request, 401 Unauthorised, 403 Forbidden, 429 Too many requests, as problem details (application/problem+json).