Audit logs

Read organization audit actions and filter by actor, resource, workspace, or time.

Requires an organization Admin or owner, an OAuth login or personal API key, and enabled enterprise audit access for the deployment.

sim audit-logs is also spelled sim audit-log.

These commands accept the global options.

List audit logs

OAuth login or personal API key required.

sim audit-logs list [options]

Options

OptionRequiredDescription
--action <value>NoFilter by exact action name.
--resource-type <value>NoFilter by resource type. Accepts a comma-separated set; members are trimmed and deduplicated, and member order affects neither the result nor the cursor.
--resource-id <value>NoFilter by exact resource identifier.
--start-date <value>NoInclude audit entries created at or after this UTC ISO 8601 timestamp, such as 2026-08-06T00:00:00Z. Dates without a time, timestamps with an offset instead of Z, and year 0000 are rejected.
--end-date <value>NoInclude audit entries created at or before this UTC ISO 8601 timestamp, such as 2026-08-06T00:00:00Z. Dates without a time, timestamps with an offset instead of Z, and year 0000 are rejected.
--include-departedNoInclude actions by users who have left the organization.
--no-include-departedNoSend --include-departed as false.
--limit <n>NoMaximum items to return (0 for everything). Defaults to 100.
--cursor <value>NoContinue from nextCursor returned by a previous result.
--organization <value>NoOrganization whose audit trail to read; defaults to the caller’s organization. A caller that belongs to no organization, or names one it does not belong to, is refused with 403.
--actor-email <value>NoFilter by actor email address.
--all-workspacesNoDo not filter to the configured workspace (OAuth login or personal API key required for account-wide access).

API request and response schemas: listAuditLogs.

Get audit log

OAuth login or personal API key required.

sim audit-logs get <auditLogId> [options]

Arguments

ArgumentRequiredDescription
auditLogIdYesAudit-log entry identifier.

Options

OptionRequiredDescription
--organization <value>NoOrganization whose audit trail to read; defaults to the caller’s organization. A caller that belongs to no organization, or names one it does not belong to, is refused with 403.

API request and response schemas: getAuditLog.