auditLogs

One method. The trail is read-only by construction: it only grows. API detail: Audit logs.

list

client.auditLogs.list(query?: AuditFilter): Promise<Page<AuditEntry>>

GET /v1/audit_logs. AuditFilter extends the page query with:

string

A principal id — a member usr_… or a key key_….

string

A resource id, e.g. one agt_….

string

An action name, e.g. member.role_changed.

string

Start of the time range (ISO 8601).

string

End of the time range.

const trail = await client.auditLogs.list({ resource: agent.id, limit: 50 });