VOOZH about

URL: https://cli.nylas.com/docs/commands/audit-logs-clear

⇱ nylas audit logs clear command | Nylas CLI


What does nylas audit logs clear do?

The nylas audit logs clear command permanently deletes all stored audit log entries. This is destructive and cannot be undone. Export logs first with nylas audit export if you need a backup. Use --force to skip the interactive confirmation prompt in automation scripts.

Usage

nylas audit logs clear [--force]

Flags

FlagDescription
--jsonOutput as JSON
--no-colorDisable color output
--verbose(-v)Enable verbose output
--configCustom config file path
--help(-h)Show help for the command
--limitLimit results (most list commands)
--yes(-y)Skip confirmations
--forceSkip confirmation prompt

Examples

Interactive clear (with confirmation)

nylas audit logs clear

Export before clearing

nylas audit export -o audit-backup.json
nylas audit logs clear --force

Example output

This will remove all audit log files. Configuration is preserved.
? Continue? Yes

✓ Cleared 4 audit log file(s)

Troubleshooting

Logs not clearing

Check file permissions on the audit log directory. Use `nylas audit config show` to find the log path.

Related commands

nylas audit config set

Set an audit configuration value. Valid keys: retention_days, max_size_mb, rotate_daily, compress_old, log_request_id, log_api_details.

nylas audit config show

Show the current audit configuration, including log path, retention, rotation, and compression settings.

nylas audit export

Export audit logs to JSON or CSV for compliance, analysis, or backup.

nylas audit init

Initialize audit logging for the Nylas CLI. Creates the log directory, default configuration, and optionally enables logging immediately.

nylas audit logs disable

Disable audit logging. Stops recording CLI activity to the audit log file.

nylas audit logs enable

Enable audit logging. Records all CLI activity to a local log file for compliance and debugging.

Recommended guides

Thunderbird vs Nylas: GUI vs CLI email

Thunderbird is a desktop GUI email client with OAuth and calendar built in. Compare it to a scriptable, headless CLI for servers, cron jobs, and AI agents.

Pipedream vs Nylas for Email Automation

Pipedream wires 3,000+ apps with event workflows and code steps. Nylas is a native email API with a CLI for agents and cron. Compare as a Pipedream alternative.

Detect Calendar Conflicts from the CLI

Spot double-booked meetings and overlapping events from the terminal. AI conflict detection and jq scripts catch calendar conflicts before they derail your day.

Block Focus Time on Your Calendar (CLI)

Context-switching costs 23 minutes of focus per interruption. Block focus time on Google Calendar from your terminal so meetings can't eat your deep-work slots.

Build a Strands Email Agent

Give a Strands Agents SDK agent email access using the Nylas CLI as a @tool. One function reaches Gmail, Outlook, and 4 more providers — no OAuth code needed.

Cloudflare Agents Email Tools

Use the Cloudflare Agents SDK to build a stateful email agent on Workers — connect to the Nylas MCP server over HTTP and call email tools in TypeScript.

Run nylas audit logs clear --help for full help output.