# polymorfa event

> Inspect and replay durable developer events.

## Commands

- [polymorfa event list](https://docs.polymorfa.com/cli/event/list): List retained events for an explicit owner.
- [polymorfa event replay](https://docs.polymorfa.com/cli/event/replay): Replay one retained event to a webhook.
- [polymorfa event stream](https://docs.polymorfa.com/cli/event/stream): Stream a project's events as they happen, with automatic reconnect and resume. Requires events:listen and the Event streams beta.
- [polymorfa event view](https://docs.polymorfa.com/cli/event/view): View one retained event.

## polymorfa event list

List retained events for an explicit owner.

### Usage

```bash
polymorfa event list [flags]
```

### Flags

- `--cursor <value>` (value). Continue from this opaque cursor.
- `--limit <value>` (value). Request this many resources per page. Default: `25`.
- `--max-items <value>` (value). Stop automatic pagination after this many resources.
- `--paginate` (boolean). Request consecutive pages until --max-items resources are collected or no pages remain. Requires --max-items.
- `--since <value>` (value). Include events at or after this RFC 3339 time.
- `--type <value>` (value). Filter by one exact event type.
- `--until <value>` (value). Include events before this RFC 3339 time.

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

## polymorfa event replay

Replay one retained event to a webhook.

### Usage

```bash
polymorfa event replay EVENT [flags]
```

### Arguments

- `EVENT` (required). Event ID.

### Flags

- `--idempotency-key <value>` (value). Use this key to identify retries; one is generated when omitted.
- `--webhook <value>` (value, required). Destination webhook ID.
- `--yes` (boolean). Confirm the external effect without prompting.

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

## polymorfa event stream

Stream a project's events as they happen, with automatic reconnect and resume. Requires events:listen and the Event streams beta.

### Usage

```bash
polymorfa event stream [flags]
```

### Flags

- `--from <value>` (value). Resume after this cursor from a previous run; valid for 24 hours.
- `--max-events <value>` (value). Stop after this many events.
- `--on-gap <value>` (value). Continue or stop when events after --from expired before delivery. Values: `continue`, `stop`. Default: `continue`.
- `--type <value>` (value, repeatable). Stream an event type or trailing-wildcard pattern such as message.*.

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

### Examples

```bash
polymorfa event stream --owner project --project 11111111-1111-4111-8111-111111111111 --type "message.*"
```

```bash
polymorfa event stream --owner project --project 11111111-1111-4111-8111-111111111111 --from "$CURSOR" --json
```

## polymorfa event view

View one retained event.

### Usage

```bash
polymorfa event view EVENT [flags]
```

### Arguments

- `EVENT` (required). Event ID.

### Flags

- `--include-payload` (boolean). Include the retained payload when it is available.

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