Command

nylas audit logs clear

Clear all audit log entries. This is a destructive action — consider exporting logs first with `nylas audit export`.

Written by Qasim Muhammad Staff SRE

Published February 13, 2026Updated June 21, 2026

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

Flag	Description
--json	Output as JSON
--no-color	Disable color output
--verbose(-v)	Enable verbose output
--config	Custom config file path
--help(-h)	Show help for the command
--limit	Limit results (most list commands)
--yes(-y)	Skip confirmations
--force	Skip confirmation prompt

Examples

The nylas audit logs clear command permanently deletes all stored audit log entries.

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.

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.