# polymorfa presence

> View and manage Messaging presence state.

## Commands

- [polymorfa presence chat subscribe](https://docs.polymorfa.com/cli/presence/chat-subscribe): Subscribe to or renew retained presence observations for a chat.
- [polymorfa presence chat view](https://docs.polymorfa.com/cli/presence/chat-view): View retained, policy-governed presence observations for a chat.
- [polymorfa presence set](https://docs.polymorfa.com/cli/presence/set): Set the connected account presence state.
- [polymorfa presence view](https://docs.polymorfa.com/cli/presence/view): View remembered self presence state (not a live authoritative query).

## polymorfa presence chat subscribe

Subscribe to or renew retained presence observations for a chat.

### Usage

```bash
polymorfa presence chat subscribe CHAT [flags]
```

### Arguments

- `CHAT` (required). Polymorfa user 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 presence chat view

View retained, policy-governed presence observations for a chat.

### Usage

```bash
polymorfa presence chat view CHAT [flags]
```

### Arguments

- `CHAT` (required). Polymorfa conversation ID.

### Flags

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

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

## polymorfa presence set

Set the connected account presence state.

### Usage

```bash
polymorfa presence set [flags]
```

### Flags

- `--idempotency-key <value>` (value). Safely identify retries of this presence update.
- `--session <value>` (value, required). Messaging session ID.
- `--state <value>` (value, required). Connected account presence state. Values: `available`, `unavailable`.

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

## polymorfa presence view

View remembered self presence state (not a live authoritative query).

### Usage

```bash
polymorfa presence view [flags]
```

### Flags

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

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