> For AI agents: the documentation index is at https://docs.gethandup.dev/llms.txt. Append .md to any page URL (without the trailing slash) for Markdown, for example https://docs.gethandup.dev/cli.md.

# blob_poster

`GET /v1/blobs/{hash}/poster`

A still frame of a video blob for use as its `poster`. Generated with ffmpeg on first request and cached; local, and view scope on paired devices.

## Parameters

### Path Parameters

- **hash** (required): `string`

## Responses

### 200

JPEG poster frame (`image/jpeg`), at most 640 px wide, cached per blob

### 404

No poster: not a video, `previews.video_posters` is off, ffmpeg is missing or cannot decode the file

### 410

File no longer stored (history.files_keep_days)
