# polymorfa media

> Inspect, download, and persist Messaging media.

## Commands

- [polymorfa media download](https://docs.polymorfa.com/cli/media/download): Download Messaging media to a local file, print its signed link, or decrypt it from a stored webhook event.
- [polymorfa media persist](https://docs.polymorfa.com/cli/media/persist): Persist Messaging media to server storage.
- [polymorfa media view](https://docs.polymorfa.com/cli/media/view): View Messaging media metadata.

## polymorfa media download

Download Messaging media to a local file, print its signed link, or decrypt it from a stored webhook event.

### Usage

```bash
polymorfa media download [MEDIA] [flags]
```

### Arguments

- `MEDIA` (optional). Messaging media ID. Omit it when using --from-event.

### Flags

- `--force` (boolean). Overwrite an existing output file.
- `--from-event <value>` (value). Decrypt media from the WhatsApp CDN using a stored message webhook JSON file. The file contains a decryption key.
- `--max-bytes <value>` (value). Maximum bytes to download. Default: `104857600`.
- `-o, --output <value>` (value). Destination file path.
- `--url` (boolean). Print the short-lived signed download link to stdout instead of downloading.

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

### Examples

```bash
polymorfa media download media_123 --output ./attachment.bin
```

```bash
polymorfa media download media_123 --url
```

```bash
polymorfa media download --from-event ./message.json -o ./photo.jpg
```

## polymorfa media persist

Persist Messaging media to server storage.

### Usage

```bash
polymorfa media persist MEDIA [flags]
```

### Arguments

- `MEDIA` (required). Messaging media ID.

### Flags

- `--idempotency-key <value>` (value). Safely identify retries of this persistence request.

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

## polymorfa media view

View Messaging media metadata.

### Usage

```bash
polymorfa media view MEDIA [flags]
```

### Arguments

- `MEDIA` (required). Messaging media ID.

### Flags

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