---
title: "Notifications & Audit in the CLI"
canonical: https://trickest.com/docs/developer-tools/cli/notifications-audit
description: "Read platform notifications and query the audit log from the trickest CLI."
---

# Notifications & Audit in the CLI

## `trickest notifications`

Platform events (run finished, schedule triggered, etc.) surface as notifications.

| Subcommand | Description |
|---|---|
| `notifications ls` | List notifications |
| `notifications read [id]` | Mark one or all as read |
| `notifications rm [id]` | Delete one or all |
| `notifications config` | Manage notification preferences |

### `notifications ls`

```bash
trickest notifications ls
trickest notifications ls --unread
```
```json
[{"id":"4fb0bc27","message":"","read":"no","created":"2026-06-03T20:39:51Z"}]
```

| Flag | Description |
|---|---|
| `--unread` | Only unread notifications |

### `notifications read` / `rm`

```bash
trickest notifications read <id>
trickest notifications read --all
trickest notifications rm <id>
trickest notifications rm --all
```

## `trickest audit`

Every significant platform action — including **CLI reads** — is recorded in the
audit log.

| Subcommand | Description |
|---|---|
| `audit ls` | List audit entries |
| `audit get <id>` | Full entry details |

### `audit ls`

```bash
trickest audit ls
trickest audit ls --since 7d --limit 20
trickest audit ls --action space-list --user 8
```
```json
[{"id":"0733dfb3-…","timestamp":"2026-06-03T20:54:24+00:00","actor":"you@org.com","event":"space-list","resource":"-","resource_id":""}]
```

| Flag | Description |
|---|---|
| `--user <user-id>` | Filter by user |
| `--action <action>` | Filter by action type (e.g. `space-list`, `auth`) |
| `--resource <type>` | Filter by resource type |
| `--since <duration-or-date>` | From date (`7d`, `24h`, or ISO 8601) |
| `--until <duration-or-date>` | To date |
| `--limit <n>` | Max entries (default 50) |

<Note>
Exploratory CLI usage shows up in audit (`space-list`, `private-workflow-list`,
`auth`, …). Expect a trail under your actor email when scripting against a shared
org.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Users & Teams" icon="users" href="/docs/developer-tools/cli/users">
    Resolve user IDs for `--user` filters.
  </Card>
  <Card title="Runs & Outputs" icon="play" href="/docs/developer-tools/cli/runs">
    Run lifecycle events often generate notifications.
  </Card>
</CardGroup>

---
_Markdown source of https://trickest.com/docs/developer-tools/cli/notifications-audit._