> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossdesk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# audit

> View audit log entries for your workspace.

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.

```bash theme={null}
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

```bash theme={null}
moss audit list --json
```

```json theme={null}
{
  "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 }
}
```

<Tip>
  Use `--actor-type api_key` to see changes made by automation and AI agents.
</Tip>