Skip to content

Users

users_audit_list

Read this product's audit log, newest first.

Tool

users_audit_list

Read this product's audit log, newest first.

Read this product's audit log, newest first. Every management-plane mutation writes one entry (user.created, user.updated, user.deleted, user.banned, user.unbanned) with the actor, target and timestamp. Filter by action, target and time range; paginate with the opaque `nextCursor`.

Behavior

HTTP
GET /users/audit

Arguments

NameTypeRequiredDescription
limitstringPage size, 1-100. Default 25.
sincestringISO-8601 lower bound (inclusive) on the event timestamp.
untilstringISO-8601 upper bound (exclusive) on the event timestamp.
actionstringExact action to filter by, e.g. 'user.banned'. Omit for all actions.
cursorstringOpaque cursor from a previous response's `nextCursor`. Omit for the first page.
targetIdstringExact id of the audited target, e.g. a user id.
targetTypestringTarget kind to filter by, e.g. 'user'.

Response

FieldTypeAlwaysDescription
eventsarray
nextCursorstring

Try it

Read this product's audit log, newest first.

When to use

Read this product's audit log, newest first. Every management-plane mutation writes one entry (user.created, user.updated, user.deleted, user.banned, user.unbanned) with the actor, target and timestamp. Filter by action, target and time range; paginate with the opaque `nextCursor`.

Example

Ask your agent something like this:

Read this product's audit log, newest first.

The agent will invoke users_audit_list with these arguments:

{}

Esc

Start typing to search the docs.

navigateselect