Excalidraw CLI

excalidraw logs

Query workspace audit logs.

Inspect workspace activity for auditing, debugging, and compliance workflows.

excalidraw logs [options] [command]
CommandDescription
listList workspace audit log entries.

Examples

excalidraw logs list --limit 25
excalidraw logs list --user <userId> --operation update
excalidraw logs list --action scene --date-from 2024-01-01 --date-to 2024-01-31

Notes

  • Use logs to understand which workspace, collection, scene, user, and invite changes happened.

list

Return audit logs with optional filters for user, action, operation, date range, and pagination.

excalidraw logs list [options]
OptionDescription
--limit <number>Maximum number of logs to return, from 1 to 100; default 50.
--cursor <cursor>NextCursor value from a previous response.
--page <page>Page number, starting at 1; cannot be combined with --cursor.
--user <userId>Only include logs for this user ID.
--action <action>Only include a supported action from the response's availableActions list.
--operation <operation>Only include operation: create, read, update, or delete.
--date-from <date>Only include logs on or after this ISO 8601 date.
--date-to <date>Only include logs on or before this ISO 8601 date.
--allFollow nextCursor and print every matching log; --limit sets the page size.

Examples

excalidraw logs list --limit 25
excalidraw logs list --cursor <nextCursor>
excalidraw logs list --page 2 --limit 50
excalidraw logs list --operation delete --date-from 2024-01-01
excalidraw logs list --action workspace:invite --user <userId>
excalidraw logs list --all --date-from 2024-01-01 --output table

Notes

  • Use --cursor to read the log in order, or --page to jump to a page number.
  • --all follows the cursor to the end and prints { count, logs, availableActions }. It can't be combined with --page.
  • availableActions lists the --action values; the API ignores others.

Last updated on