@personaai/sdkv0.9.0

audit-logs — @personaai/sdk

Generated field tables for audit-logs — do not edit

Generated from sdk/typescript/dist/typedoc.json — do not edit. Regenerate with node platform/scripts/typedoc-resources.mjs.

audit-logs

Auth: Requires Authorization: Bearer <keyId>.<secret> (server-side). For per-user calls add x-persona-external-user-id. See .

Audit logs are read-only, control-plane only — lifecycle events (credentials minted/revoked, membership, suspend/restore).

Example

TypeScript

ts
const { items } = await persona.auditLogs.list({ page: 1, limit: 20 });

cURL

bash
curl https://api.persona.hasanraiyan.me/api/v1/developer/audit-logs -H "Authorization: Bearer $PERSONA_CREDENTIAL"

Response

json
{  "success": true,  "data": { "items": [{ "eventType": "credential.minted" }], "pagination": { "total": 1 } }}

AuditLogEntry

Mirrors agent-backend/src/modules/audit/auditLog.model.js. Covers Project-lifecycle events only (credential minted/revoked, membership changes, suspend/restore) — NOT resource CRUD (Agent/Skill/Knowledge/ Provider/MCP create/update/delete aren't logged here yet).

Source: types/auditLog.ts:7

Interface

FieldTypeDescription
eventTypestring— _ types/auditLog.ts:8_
timestampstring— _ types/auditLog.ts:9_
actorContextTypestring— _ types/auditLog.ts:10_
actorIdentitystring | null— _ types/auditLog.ts:11_
targetDomainstring— _ types/auditLog.ts:12_
targetResourceIdstring | null— _ types/auditLog.ts:13_
metadataRecord<string, unknown>— _ types/auditLog.ts:14_

ListAuditLogsParams

Source: types/auditLog.ts:17

Interface

FieldTypeDescription
page?number— _ types/auditLog.ts:18_
limit?number— _ types/auditLog.ts:19_
eventType?stringOptional exact-match filter, e.g. "credential.created". — _ types/auditLog.ts:21_