# Extract annotated frame from preview

**GET /actions/preview-files/{preview_file_id}/extract-annotated-frame**

Extract a frame from a movie preview, or the picture itself from a picture preview, and overlay the matching annotation on it. `frame_number` is required for movies and ignored for pictures. Returns 400 if no annotation is recorded.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Jwt authorization


## Parameters

### Path parameters
- **preview_file_id** (string(uuid))
  Preview file unique identifier

### Query parameters
- **frame_number** (integer)
  Frame number to extract (movies only, 1-based)


## Responses
### 200
Composited frame as PNG image

#### Body: image/png (string(binary))
string(binary)
### 400
No annotation, missing frame_number on movie, or unsupported extension

### 404
Preview file binary is not available


[Powered by Bump.sh](https://bump.sh)