Update a video thumbnail

Uploads or deletes a custom thumbnail. Uploaded images must be JPEG or PNG and no larger than 1600 by 1200 pixels.

Thumbnail uploads are limited to three attempts per minute per account. The current backend source requires a deployment fix before the upload action can run.

POST /v1/videos/thumbnail

Update a video thumbnail

cURL

curl --request POST \
  --url https://api.videobase.com/v1/videos/thumbnail \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <api-key>' \
  --form id=a1b2c3d4e5f6 \
  --form file='@example-file'

200

{
  "url": "<string>",
  "message": "<string>"
}

Authorizations

ApiKeyHeaderApiKeyQuery

X-Api-Key · string · header · required

Recommended. Your 16-character Videobase API key.

Body

multipart/form-data

id · string · required

Twelve-character Videobase video or remote-upload identifier.

Required string length: 12

Pattern: ^\w{12}$

Example:

"a1b2c3d4e5f6"

action · enum<string> · required

Available options: update, delete

file · file

Required for update. JPEG or PNG image.

Response

200

application/json

Thumbnail update or deletion result.

Option 1

Option 2

url · string<uri> · required

message · string · required