audit - MossDesk

The audit log records every change made in your workspace — who did what, when, and to which record. Use it for compliance, debugging, or understanding how data has changed over time.

moss audit list

List audit log entries. Requires owner role.

moss audit list
moss audit list --event-type "contact.created" --target-type "contact"

Option	Required	Description
`--page <n>`	No	Page number
`--per-page <n>`	No	Items per page
`--event-type <type>`	No	Filter by event type (e.g., `contact.created`, `deal.stage_moved`)
`--target-type <type>`	No	Filter by target entity type (e.g., `contact`, `deal`, `company`)
`--actor-type <type>`	No	Filter by actor type (e.g., `user`, `api_key`)

JSON output

moss audit list --json

{
  "data": [
    {
      "id": "aud_abc123",
      "event_type": "deal.stage_moved",
      "target_type": "deal",
      "target_id": "deal_abc123",
      "actor_type": "user",
      "actor_id": "usr_abc123",
      "metadata": { "from_stage": "lead", "to_stage": "proposal" },
      "created_at": "2026-02-08T14:00:00Z"
    }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 156, "total_pages": 7 }
}

Use --actor-type api_key to see changes made by automation and AI agents.