> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postlybee.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Media and analytics

> Upload media, run video helpers, and retrieve performance metrics.

## Upload a file

```bash theme={null}
postlybee media:upload ./launch.png
postlybee media:upload ./video.mp4
```

The CLI detects common image and MP4 MIME types from the extension. Override it when necessary:

```bash theme={null}
postlybee media:upload ./asset.bin --content-type image/png
```

The returned `id` and `path` can be placed in `posts[].value[].image` when creating a post.

## Import a URL

```bash theme={null}
postlybee media:upload-url https://example.com/image.png
```

PostlyBee applies the same HTTPS, SSRF, content-type, and size validation as the Public API.

## Video generators

Run an enabled Workspace video generator from JSON:

```bash theme={null}
postlybee media:generate-video --file video.json
```

Run a helper function, such as listing voices:

```bash theme={null}
postlybee media:video-function --data '{
  "identifier": "generator-id",
  "functionName": "voices",
  "params": {}
}'
```

The exact fields depend on the enabled generator. Use the API reference or dashboard to inspect available options.

## Account analytics

```bash theme={null}
postlybee analytics:account ACCOUNT_ID \
  --start 2026-08-01 \
  --end 2026-08-31
```

Add `--force` to bypass the cached provider response. Date ranges are UTC and cannot exceed the backend's analytics limits.

## Post analytics

```bash theme={null}
postlybee analytics:post POST_ID
postlybee analytics:post POST_ID --days 30
```

If the result is `{"missing":true}`, resolve the release ID with `posts:missing` and `posts:connect` first.

## Notifications and posting slots

```bash theme={null}
postlybee notifications:list
postlybee notifications:list --page 1
postlybee find-slot ACCOUNT_ID
```

Notifications use zero-based pages of 100 items. `find-slot` returns the next available UTC publication time from the connected account's schedule.