CLI Reference
Audit Commands
CLI commands for viewing audit logs
Audit Commands
The audit command group provides access to the audit log for the active workspace. Every significant action is recorded and can be queried for compliance and debugging.
audit list
List audit log entries with optional filtering.
nextpay --env dev audit list
nextpay --env dev audit list --limit 50
nextpay --env dev audit list --actor user_abc123
nextpay --env dev audit list --action iam.member.added
nextpay --env dev audit list --resource-type member| Flag | Required | Default | Description |
|---|---|---|---|
--limit | No | 25 | Maximum entries to return (1-100). |
--cursor | No | — | Pagination cursor from a previous response. |
--actor | No | — | Filter by actor user ID. |
--action | No | — | Filter by action (e.g., iam.member.added, iam.workspace.created). |
--resource-type | No | — | Filter by resource type (e.g., member, team, organization). |
Example output:
{
"entries": [
{
"id": "audit_abc123",
"action": "iam.member.added",
"actor": {"id": "user_xyz", "email": "admin@acme.ph"},
"resource": {"type": "member", "id": "user_def456"},
"metadata": {"role": "disbursement_manager"},
"timestamp": "2026-03-20T08:30:00Z"
}
],
"cursor": "next_page_token"
}Use the --cursor flag with the returned cursor value to fetch the next page of results.