# polymorfa channel

> Inspect and manage Messaging channels.

## Commands

- [polymorfa channel create](https://docs.polymorfa.com/cli/channel/create): Create a channel.
- [polymorfa channel delete](https://docs.polymorfa.com/cli/channel/delete): Delete a channel.
- [polymorfa channel follow](https://docs.polymorfa.com/cli/channel/follow): Follow a channel.
- [polymorfa channel list](https://docs.polymorfa.com/cli/channel/list): List channels for a connected session.
- [polymorfa channel live-updates subscribe](https://docs.polymorfa.com/cli/channel/live-updates-subscribe): Start or renew a temporary upstream channel-update subscription.
- [polymorfa channel message list](https://docs.polymorfa.com/cli/channel/message-list): List a bounded page of channel messages.
- [polymorfa channel message mark-viewed](https://docs.polymorfa.com/cli/channel/message-mark-viewed): Mark a channel message as viewed.
- [polymorfa channel message react](https://docs.polymorfa.com/cli/channel/message-react): Set a channel message reaction; pass an empty value to remove it.
- [polymorfa channel message updates](https://docs.polymorfa.com/cli/channel/message-updates): List a bounded page of channel message updates.
- [polymorfa channel mute](https://docs.polymorfa.com/cli/channel/mute): Mute a channel.
- [polymorfa channel unfollow](https://docs.polymorfa.com/cli/channel/unfollow): Unfollow a channel.
- [polymorfa channel unmute](https://docs.polymorfa.com/cli/channel/unmute): Unmute a channel.
- [polymorfa channel view](https://docs.polymorfa.com/cli/channel/view): View one channel.

## polymorfa channel create

Create a channel.

### Usage

```bash
polymorfa channel create [flags]
```

### Flags

- `--description <value>` (value). Channel description.
- `--idempotency-key <value>` (value). Safely identify retries of this channel creation.
- `--name <value>` (value, required). Channel name.
- `--session <value>` (value, required). Messaging session ID.

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

## polymorfa channel delete

Delete a channel.

### Usage

```bash
polymorfa channel delete CHANNEL [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.

### Flags

- `--idempotency-key <value>` (value). Safely identify retries of this channel deletion.
- `--session <value>` (value, required). Messaging session ID.
- `--yes` (boolean, required). Confirm permanent channel deletion.

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

## polymorfa channel follow

Follow a channel.

### Usage

```bash
polymorfa channel follow CHANNEL [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.

### Flags

- `--idempotency-key <value>` (value). Safely identify retries.
- `--session <value>` (value, required). Messaging session ID.

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

## polymorfa channel list

List channels for a connected session.

### Usage

```bash
polymorfa channel list [flags]
```

### Flags

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

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

## polymorfa channel live-updates subscribe

Start or renew a temporary upstream channel-update subscription.

### Usage

```bash
polymorfa channel live-updates subscribe CHANNEL [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.

### Flags

- `--idempotency-key <value>` (value). Safely identify retries of this subscription request.
- `--session <value>` (value, required). Messaging session ID.

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

## polymorfa channel message list

List a bounded page of channel messages.

### Usage

```bash
polymorfa channel message list CHANNEL [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.

### Flags

- `--before <value>` (value). Return messages older than this positive server ID.
- `--limit <value>` (value). Number of messages to return (default 50).
- `--session <value>` (value, required). Messaging session ID.

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

## polymorfa channel message mark-viewed

Mark a channel message as viewed.

### Usage

```bash
polymorfa channel message mark-viewed CHANNEL MESSAGE-ID [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.
- `MESSAGE-ID` (required). Polymorfa message ID.

### Flags

- `--idempotency-key <value>` (value). Safely identify retries of this viewed action.
- `--session <value>` (value, required). Messaging session ID.

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

## polymorfa channel message react

Set a channel message reaction; pass an empty value to remove it.

### Usage

```bash
polymorfa channel message react CHANNEL MESSAGE-ID [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.
- `MESSAGE-ID` (required). Polymorfa message ID.

### Flags

- `--idempotency-key <value>` (value). Key that makes retries of this write safe for 24 hours. Generated when omitted.
- `--reaction <value>` (value, required). Reaction text, at most 32 UTF-8 bytes; empty removes it.
- `--session <value>` (value, required). Messaging session ID.

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

## polymorfa channel message updates

List a bounded page of channel message updates.

### Usage

```bash
polymorfa channel message updates CHANNEL [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.

### Flags

- `--after <value>` (value). Return updates after this positive message server ID.
- `--limit <value>` (value). Number of updates to return (default 50).
- `--session <value>` (value, required). Messaging session ID.
- `--since <value>` (value). Return updates since this Unix timestamp in seconds; 0 is treated as unset.

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

## polymorfa channel mute

Mute a channel.

### Usage

```bash
polymorfa channel mute CHANNEL [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.

### Flags

- `--idempotency-key <value>` (value). Safely identify retries.
- `--session <value>` (value, required). Messaging session ID.

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

## polymorfa channel unfollow

Unfollow a channel.

### Usage

```bash
polymorfa channel unfollow CHANNEL [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.

### Flags

- `--idempotency-key <value>` (value). Safely identify retries.
- `--session <value>` (value, required). Messaging session ID.

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

## polymorfa channel unmute

Unmute a channel.

### Usage

```bash
polymorfa channel unmute CHANNEL [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.

### Flags

- `--idempotency-key <value>` (value). Safely identify retries.
- `--session <value>` (value, required). Messaging session ID.

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

## polymorfa channel view

View one channel.

### Usage

```bash
polymorfa channel view CHANNEL [flags]
```

### Arguments

- `CHANNEL` (required). Channel ID.

### Flags

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

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