# Chalk CLI Reference: Audit
source: https://docs.chalk.ai/cli#audit

View audit logs tracking changes and access to your Chalk environment, and inspect which RPC endpoints are configured for auditing.

## `chalk audit list`
source: https://docs.chalk.ai/cli?command=audit_list

```bash
chalk audit list
```

List audit logs for your environment, with optional filtering and pagination.

By default, the most recent 100 audit logs are returned. When more results are available, a cursor is printed that can be passed via `--cursor` to fetch the next page.

**Flags**

- `--limit <limit>` (int, default `100`)
  Maximum number of audit logs to return.
- `--cursor <cursor>` (string)
  Cursor for pagination, from a previous page's output.
- `--start-time <start-time>` (string)
  Start time for filtering audit logs (e.g., `'1h ago'`, `'2026-07-01T00:00:00Z'`).
- `--end-time <end-time>` (string)
  End time for filtering audit logs (e.g., `'now'`, `'2026-07-24T00:00:00Z'`).
- `--endpoint <endpoint>` (string[], default `[]`)
  Filter by full endpoint name as shown in the Endpoint column (e.g., `chalk.server.v1.TeamService.AssignEnvironmentRole`). May be repeated.
- `--agent-id <agent-id>` (string)
  Filter by agent ID (user ID, service token ID, or engine ID).

**Example**

```
$ chalk audit list
$ chalk audit list --limit 50 --start-time '24h ago'
$ chalk audit list --endpoint chalk.server.v1.TeamService.AssignEnvironmentRole
$ chalk audit list --cursor <cursor-from-previous-page>
```

## `chalk audit endpoints`
source: https://docs.chalk.ai/cli?command=audit_endpoints

```bash
chalk audit endpoints
```

List endpoints configured for audit logging, including their request/response types and audited fields.

**Flags**

- `--csv <csv>` (bool, default `false`)
  Output audited endpoints in CSV format.

**Example**

```
$ chalk audit endpoints
$ chalk audit endpoints --csv
```
