API reference

API reference · Account

The audit trail

GET/api/account/auditSigned in session

Append only. Keys minted, revoked, rotated and rescoped, policies changed, members invited and demoted, payments received, admin top ups, account deletion. Without orgId it is your own history; with one it is the organization's, which owners, admins and the billing role may read.

Parameters

Path and query parameters
FieldTypeWhat it is
orgId (query)integerAn organization's trail instead of your own.
limit (query)integerPage size.
before (query)integerReturn entries with an id below this one.

Answer 200

Entries, newest first.

Fields of the 200 answer
FieldTypeWhat it is
scopestring
orgIdinteger or null
entriesarray of AuditEntry
entries[].idinteger
entries[].tsinteger
entries[].actorUserIdinteger or nullNull when the provider or the operator acted.
entries[].orgIdinteger or null
entries[].actionstring
entries[].targetstring or null
entries[].detailobject or nullNever a secret.
entries[].ipstring or null

Errors

  • 401OpenAI shaped error.
  • 403OpenAI shaped error.
  • 404OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.

Antimatter