Page optimized for desktop experience. Please use a desktop browser for best compatibility.

Upload thumbnail image

This endpoint uploads an alternate image to be used as a thumbnail for a specified video.  Rev auto-generates a default thumbnail if you do not upload one of your choice.

Note that if you replace Rev’s auto-generated thumbnail with one that you upload it will be deleted and may not be recovered.

POST
/api/uploads/images/{videoId}

Path Parameters

Parameter Type Validations
videoId string, required ID of the video to upload and attach thumbnail image to

Request Body

multipart/form-data

Thumbnail image to upload. Accepted file types include – .jpg .png .gif

Content-Type header for the uploaded files must be provided.

REQUEST: Post Thumbnail Image

curl -X POST --https://doug.rev-eu.demo.portal.vbrick.com/api/uploads/images/f63b69c8-3646-4350-a8e7-df263aa96f9f \
-H 'Authorization: VBrick -XQhEjgurerpdQzRwuTpSOfi826imBv0IiK2JUb5APiUx53X4nyIlp6Vr02UjpMFrTRIZtOHP0bbE6LKZaHQWSnounfzXeSwd3XgpbtCwnw-aDYnG01_o7NrYM50LAv0d4XGepgrJ_o2d5fp4AIPMQ2' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Postman-Token: 38fcb2d4-e5ea-4bd8-9025-c0e65aa2e7a2' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-F '=@C:\Doug\Samples\Thumbnail.jpg'

Response Body

successful response

Unauthorized error

Internal server error

Errors may include:

  • MalformedRequest = “Bad request format. Please check your request.”;
  • FileNotSupported = “Sorry! Cannot upload this file type.”;
  • FileNotSent = “The video file was not uploaded.”;
  • UserNotProvided = “Unable to upload video. Please ensure that video is associated to a valid user.”;
  • UserDoesNotExist = “Unable to upload video. Please ensure that video is associated to a valid user.”;
  • InternalServerError = “Unable to process request at this time. Please try again later.”