# polymorfa chat

> Read stored chats on enrolled HMS Numbers (beta).

## Commands

- [polymorfa chat list](https://docs.polymorfa.com/cli/chat/list): List stored chats for an enrolled HMS Number (beta). Requires chats:read.
- [polymorfa chat message list](https://docs.polymorfa.com/cli/chat/message-list): List stored messages in a chat for an enrolled HMS Number (beta). Requires messages:read.
- [polymorfa chat message media](https://docs.polymorfa.com/cli/chat/message-media): Download a stored Official API message media copy for an enrolled HMS Number (beta). Requires messages:read and media:read.
- [polymorfa chat message view](https://docs.polymorfa.com/cli/chat/message-view): View one stored message for an enrolled HMS Number (beta). Requires messages:read.
- [polymorfa chat view](https://docs.polymorfa.com/cli/chat/view): View one stored chat for an enrolled HMS Number (beta). Requires chats:read.

## polymorfa chat list

List stored chats for an enrolled HMS Number (beta). Requires chats:read.

### Usage

```bash
polymorfa chat list [flags]
```

### Flags

- `--active-before <value>` (value). Last activity before this ISO 8601 time.
- `--active-since <value>` (value). Last activity at or after this ISO 8601 time.
- `--cursor <value>` (value). Opaque page cursor; reuse with the same filters.
- `--kind <value>` (value). Conversation kind. Values: `direct`, `group`, `channel`, `broadcast`.
- `--limit <value>` (value). Page size (1–100, default 50).
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa chat message list

List stored messages in a chat for an enrolled HMS Number (beta). Requires messages:read.

### Usage

```bash
polymorfa chat message list CONVERSATION [flags]
```

### Arguments

- `CONVERSATION` (required). Conversation ID or E.164 phone number.

### Flags

- `--cursor <value>` (value). Opaque page cursor; reuse with the same filters.
- `--direction <value>` (value). Message direction. Values: `inbound`, `outbound`.
- `--limit <value>` (value). Page size (1–100, default 50).
- `--order <value>` (value). Message order (default desc). Values: `desc`, `asc`.
- `--session <value>` (value, required). Messaging Number ID.
- `--since <value>` (value). Messages at or after this ISO 8601 time.
- `--types <value>` (value). Comma-separated message types, up to 16 (for example text,image).
- `--until <value>` (value). Messages before this ISO 8601 time.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa chat message media

Download a stored Official API message media copy for an enrolled HMS Number (beta). Requires messages:read and media:read.

### Usage

```bash
polymorfa chat message media CONVERSATION MESSAGE [flags]
```

### Arguments

- `CONVERSATION` (required). Conversation ID or E.164 phone number.
- `MESSAGE` (required). Opaque Polymorfa message ID.

### Flags

- `--force` (boolean). Overwrite an existing output file.
- `--max-bytes <value>` (value). Maximum bytes to download (default 32 MiB). Default: `33554432`.
- `-o, --output <value>` (value, required). Destination file path.
- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

### Examples

```bash
polymorfa chat message media +15550001111 739182640518204 --session NUMBER_ID --output ./attachment.bin
```

## polymorfa chat message view

View one stored message for an enrolled HMS Number (beta). Requires messages:read.

### Usage

```bash
polymorfa chat message view CONVERSATION MESSAGE [flags]
```

### Arguments

- `CONVERSATION` (required). Conversation ID or E.164 phone number.
- `MESSAGE` (required). Opaque Polymorfa message ID.

### Flags

- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

## polymorfa chat view

View one stored chat for an enrolled HMS Number (beta). Requires chats:read.

### Usage

```bash
polymorfa chat view CONVERSATION [flags]
```

### Arguments

- `CONVERSATION` (required). Conversation ID or E.164 phone number.

### Flags

- `--session <value>` (value, required). Messaging Number ID.

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).
