Skip to main content
persona.audit_logs (sync) / await persona.audit_logs (async) wraps /api/v1/developer/audit-logs. Audit logs are read-only, control-plane only (mirrors Providers — no ExternalUser ownership concept). A client constructed with external_user_id gets an empty PaginatedResult back, not an error — the same existence-hiding-style precedent providers.list() established.

​
Methods

Async: await persona.audit_logs.list(...).
Today’s audit log covers Project-lifecycle events only — credential minted/revoked, membership added/removed, Project suspended/restored, deletion requested/cancelled/completed. It does not cover resource CRUD — creating, updating, or deleting an Agent/Skill/Knowledge Base/Provider/MCP leaves no entry here yet. Don’t expect to find a "agent.deleted" event; it doesn’t exist as of this release.

​
list(params=None)

Lists Project-lifecycle audit events for this credential’s Domain. ListAuditLogsParams (all optional): page (default 1), limit (default 20), eventType (optional exact-match filter — e.g. "credential.created").
Each AuditLogEntry:

​
Types

See Types — Audit log types for the full field reference: AuditLogEntry, ListAuditLogsParams.