---
title: "openemail security"
description: "Every command in this namespace, with its arguments, flags and examples."
url: "https://openemail.uk/docs/cli/reference/security"
area: "CLI"
category: "Reference"
---

# openemail security

Every command in this namespace, with its arguments, flags and examples.

## Commands

### `openemail security list-events`

Read the workspace security log

```bash
openemail security list-events [flags]
```

Resolves one page of the changes people made to who can reach the workspace, newest first: invitations sent and withdrawn, members added and removed, roles created, changed and deleted, the two-factor requirement, passwords set for an address and directory sync. Each one names who did it in `actor`. Nothing is ever removed from it.

Add `--all` to walk every page: a table on a terminal, one JSON object per line when piped or with `--ndjson`, and one `{ items, hasMore, nextCursor }` document with `--json`. `--max <n>` stops after that many items.

- Scopes: `members:read`.
- Needs a sign-in.

**Flags**

- `--limit <n>` (default `25`): Page size, from 1 to 100. The server defaults to 25.
- `--cursor <value>`: The `nextCursor` of the previous page. Leave it out for the first page.
- `--all`: Fetch every page and stream the items as they arrive.
- `--max <n>`: Stop after this many items. Implies `--all`.
- `--ndjson`: Print every item as one JSON object per line. Implies `--all`

**Examples**

```bash
openemail security list-events
```

With optional flags

```bash
openemail security list-events --limit 50
```

Walk every page and stop after 100 items

```bash
openemail security list-events --all --max 100
```

One JSON object per line when piped

```bash
openemail security list-events --all > security.ndjson
```

Also available in: API [`GET /security/events`](https://openemail.uk/docs/api/reference/security#get-security-events); TypeScript [`security.listEvents()`](https://openemail.uk/docs/sdk/reference/security#listEvents); Python [`security.list_events()`](https://openemail.uk/docs/python/reference/security#listEvents); Ruby [`security.list_events`](https://openemail.uk/docs/ruby/reference/security#listEvents); PHP [`security->listEvents`](https://openemail.uk/docs/php/reference/security#listEvents); Go [`Security.ListEvents`](https://openemail.uk/docs/go/reference/security#listEvents); Java [`security().listEvents`](https://openemail.uk/docs/java/reference/security#listEvents); C# [`Security.ListEventsAsync`](https://openemail.uk/docs/csharp/reference/security#listEvents).