# ry mail

> Transactional email: sending domains, log, inbox, suppressions.

```text
ry mail [options] [command]
```

## Subcommands

### `ry mail domains`

The domains you send from.

```text
ry mail domains [options] [command]
```

#### `ry mail domains list`

Show your sending domains with status.

```text
ry mail domains list [options]
```

Example:

```bash
ry mail domains list
```

#### `ry mail domains add`

Claim a sending domain and print the DNS records to set.

```text
ry mail domains add [options] <domain>
```

Example:

```bash
ry mail domains add mail.example.com
```

#### `ry mail domains show`

The records of a domain with what DNS shows, and the receiving side.

```text
ry mail domains show [options] <domain>
```

Example:

```bash
ry mail domains show mail.example.com
```

#### `ry mail domains check`

Look DNS up now and verify the domain if the required records are there.

```text
ry mail domains check [options] <domain>
```

Example:

```bash
ry mail domains check mail.example.com
```

#### `ry mail domains remove`

Give a sending domain back - waiting messages, its log and its inbox go with it (not within 14 days of its last send).

```text
ry mail domains remove [options] <domain>
```

Options:

- `-y, --yes`: Skip confirmation (required for automation).

Example:

```bash
ry mail domains remove mail.example.com
```

### `ry mail log`

Your sent messages, newest first, with their delivery status.

```text
ry mail log [options]
```

Options:

- `-n, --limit <n>`: How many entries (control plane caps at 500). Default: `50`.

Example:

```bash
ry mail log
```

### `ry mail show`

One message and every event the deliverer recorded for it.

```text
ry mail show [options] <id>
```

Example:

```bash
ry mail show msg-1a2b3c4d
```

### `ry mail inbox`

What arrived at your receiving addresses.

```text
ry mail inbox [options] [command]
```

#### `ry mail inbox list`

Received messages, newest first.

```text
ry mail inbox list [options]
```

Options:

- `-n, --limit <n>`: How many entries. Default: `50`.
- `-d, --domain <domain>`: Only this receiving domain.

Example:

```bash
ry mail inbox list
```

#### `ry mail inbox show`

One received message: headers and the text part.

```text
ry mail inbox show [options] <id>
```

Options:

- `--raw`: Print the raw message instead of the text part.

Example:

```bash
ry mail inbox show inb-1a2b3c4d
```

### `ry mail suppressions`

Addresses you will not send to again.

```text
ry mail suppressions [options] [command]
```

#### `ry mail suppressions list`

Your suppression list.

```text
ry mail suppressions list [options]
```

Example:

```bash
ry mail suppressions list
```

#### `ry mail suppressions clear`

Remove an address from the list after a genuine re-signup (complaints cannot be cleared).

```text
ry mail suppressions clear [options] <address>
```

Example:

```bash
ry mail suppressions clear someone@example.com
```

### `ry mail routes`

The addresses a domain receives at.

```text
ry mail routes [options] [command]
```

#### `ry mail routes list`

Receiving addresses of a domain.

```text
ry mail routes list [options] <domain>
```

Example:

```bash
ry mail routes list mail.example.com
```

#### `ry mail routes add`

Receive mail at an address (a local part, a full address under the domain, or * for all).

```text
ry mail routes add [options] <domain> <address>
```

Example:

```bash
ry mail routes add mail.example.com support
```

#### `ry mail routes remove`

Stop receiving at an address (id, address or local part).

```text
ry mail routes remove [options] <domain> <route>
```

Options:

- `-y, --yes`: Skip confirmation (required for automation).

Example:

```bash
ry mail routes remove mail.example.com rt-1a2b3c4d
```
