Skip to content
Braiv Docs

Get the current thumbnail

This returns the thumbnail currently on the video — the same image GET /videos/{id} exposes as posterUrl. It is not AI generation history. For generation jobs see Generate a thumbnail. To replace the image, see Set a video poster. Requires videos:read.

GCS and Firebase Storage objects come back as a fresh 30-minute signed URL. Public CDN URLs are returned as stored. Do not strip query parameters, and do not fetch a storage path without the signature — that returns 403.

Terminal window
curl -sS "$BRAIV_API_BASE/videos/$VIDEO_ID/thumbnail" \
  -H "Authorization: Bearer $BRAIV_API_KEY"

200 includes videoId and thumbnailUrl. expiresAt is present when the URL is a freshly signed storage object.

To embed the file in the JSON body (JPEG, PNG, or WebP, 8MB max):

Terminal window
curl -sS "$BRAIV_API_BASE/videos/$VIDEO_ID/thumbnail?includeBytes=true" \
  -H "Authorization: Bearer $BRAIV_API_KEY"

contentBase64 is the image bytes. Hosted MCP braiv_get_current_thumbnail requests bytes by default and returns the URL unredacted. braiv_list_thumbnails / braiv_get_thumbnail are generation jobs, not this image.