Docs

Logs

Read a project's audit and request logs from the terminal: filter past entries, stream new ones live, or inspect a single request.

logs — Project Audit & Request Logs

Inspect audit activity, access events, and HTTP request logs for your project directly from the command line. You can paginate, filter by status, method, or source, and live stream incoming logs in real time.

logs list

Fetch and display recent logs in a formatted table. Filter by HTTP status code, method, origin source (CLI, MCP, Web, API), or free-text search.

View & filter logsShell
# View recent logs for the active project
apivault logs

# Filter by status and source
apivault logs --status error --source mcp

# Search endpoints, methods, IPs, or actors
apivault logs --search "/api/keys" --limit 25

# Paginate through historical logs
apivault logs --page 2 --limit 50
FlagDescription
-n, --limit <number>Number of entries to fetch (default: 50, max: 1000)
--page <number>Page number for pagination (default: 1)
-f, --followLive stream incoming logs in real time
--status <status>Filter by status (success, error, or HTTP code like 200, 404)
--source <source>Filter by source (cli, mcp, web, api, service, integration)
--method <method>Filter by HTTP method (GET, POST, PUT, DELETE)
--search <query>Search matching endpoints, IPs, users, or details
--event-type <type>Filter by event type (e.g. KEY_REVEALED, KEY_ROTATED)
--date <YYYY-MM-DD>Filter logs on or after a date
--end-date <YYYY-MM-DD>Filter logs up to an end date

logs tail (live streaming)

Stream logs continuously to your terminal as requests and audit events happen:

Live log streamShell
# Stream all incoming logs in real time
apivault logs tail

# Stream with specific filters
apivault logs tail --source mcp --status error

logs get / inspect

Inspect the full details of a specific log entry, including duration, IP address, user agent, caller info, and raw payload details:

Inspect log entryShell
# Inspect by log ID
apivault logs get <log-id>

# Output raw JSON payload
apivault --json logs get <log-id>