# Thumbnail image of the running stream

The latest decoded frame, or a given one. 404 when the stream is not running or has produced no frame yet.

Endpoint: GET /runtime/apps/{app}/streams/{stream}/thumbnail
Version: 2.0.0
Security: engineBasic

## Path parameters:

  - `app` (string, required)
    Engine application holding the stream (e.g. live). The vhost and application instance are the ones VIC serves and are not addressed here.

  - `stream` (string, required)
    One stream's exact name, never a pattern — patterns belong to a stream group config's match.stream_pattern.

## Query parameters:

  - `width` (integer)
    Target width in pixels; 0, the default, keeps the source width.

  - `height` (integer)
    Target height in pixels; 0, the default, keeps the source height.

  - `fit` (string)
    How the frame is fitted when the requested size has another aspect ratio: letterbox pads, crop trims, fitwidth/fitheight scale to that side and let the other follow, matchsource keeps the source size.
    Enum: "letterbox", "fitwidth", "fitheight", "matchsource", "crop"

  - `format` (string)
    Encoding of the returned image, which sets the response media type.
    Enum: "jpg", "png"

  - `frame_id` (integer)
    0, the default, is the latest frame. A specific frame is served from the analysis buffer at its own size, so width, height and fit do not apply.

  - `overlay` (boolean)
    Render the detection overlay. Falls back to the -vi overlay rendition, then to the plain source frame, when the annotated frame is not available.

## Response 404 fields (application/problem+json):

  - `type` (string)
    URI identifying the problem type.

  - `title` (string, required)
    Short, human-readable summary of the problem type.

  - `status` (integer, required)
    The HTTP status code, repeated from the response line.

  - `detail` (string)
    Human-readable explanation specific to this occurrence.

  - `instance` (string)
    URI identifying this specific occurrence of the problem.

## Response default fields (application/problem+json):

  - `type` (string)
    URI identifying the problem type.

  - `title` (string, required)
    Short, human-readable summary of the problem type.

  - `status` (integer, required)
    The HTTP status code, repeated from the response line.

  - `detail` (string)
    Human-readable explanation specific to this occurrence.

  - `instance` (string)
    URI identifying this specific occurrence of the problem.