Skip to content
Braiv Docs

Set a video poster

This replaces the library video’s posterUrl. It is not AI generation — for that see Generate a thumbnail. Requires thumbnails:write. JPEG, PNG, or WebP. 8MB max.

HTTPS image URL

Section titled “HTTPS image URL”
Terminal window
curl -sS -X POST "$BRAIV_API_BASE/videos/$VIDEO_ID/poster" \
  -H "Authorization: Bearer $BRAIV_API_KEY" -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://cdn.example.com/cover.jpg"}'

200 returns videoId and the new posterUrl. GET /videos/{id} then shows the same poster.

Multipart file

Section titled “Multipart file”
Terminal window
curl -sS -X POST "$BRAIV_API_BASE/videos/$VIDEO_ID/poster" \
  -H "Authorization: Bearer $BRAIV_API_KEY" -H "Idempotency-Key: $(uuidgen)" \
  -F "file=@./cover.jpg;type=image/jpeg"

From MCP: braiv_set_video_poster with videoId and imageUrl. Hosted MCP cannot read local disk; host the file at an https URL first.