API Reference

Upload video thumbnail

Uploads a custom thumbnail for a video, replacing any existing custom thumbnail

POST /thumbs/{video_id}

Detailed Description

Uploads a custom thumbnail for a video. If a custom thumbnail already exists, this operation replaces it. You may optionally target a specific thumbnail type.

HTTP Method & Path

POST /thumbs/{video_id}

Authentication Requirements

  • Security Scheme: PandaAuth (apiKey)
  • Header: Authorization: <your_api_token>

Parameters

NameInTypeRequiredDescription
AuthorizationheaderstringYesPanda API token
video_idpathstring (uuid)YesUnique identifier of the video.
typequerystring (enum: pause, live, end)NoTarget thumbnail type to upload.

Request Body

Content-Type: multipart/form-data

FieldTypeRequiredDescription
filestring (binary)YesImage file for the thumbnail. Supported formats: JPEG, PNG, or GIF.

Notes

  • When type=pause, the service manages pause-screen thumbnails (array behavior is implied in the schema).
  • When type=live, the upload sets the live thumbnail.
  • When type=end, the upload sets the end-screen thumbnail.

Example

Usage example available in our github

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!