---
title: "Upload video thumbnail"
method: POST
path: "/thumbs/{video_id}"
tags: ["Thumbnails"]
---

# Upload video thumbnail

`POST /thumbs/{video_id}`

Uploads a custom thumbnail (multipart/form-data) for a video. Use query ?type=pause|live|end to target a specific kind; omit type for the default start/cover thumbnail.

## Path parameters

- `video_id` string, uuid, required

## Query parameters

- `type` 'pause' | 'live' | 'end'

## Response `200`

Thumbnail uploaded successfully

- object
  - `response` UploadThumbnailResponse — Response after successful thumbnail upload
    - `thumb` string — Filename of the uploaded thumbnail
    - `pauseThumbnail` string[] — Array of pause thumbnail filenames (for pause type)
    - `endThumbnail` string — Filename of the end thumbnail (for end type)
    - `thumbnail` string — Filename of the live thumbnail (for live type)

## Other responses

- `400` — Bad request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing authentication
- `404` — Not found - Resource does not exist
- `500` — Internal server error

---

[API](https://skmtc.net/pandavideo/apis/api-v2.md) · [All operations](https://skmtc.net/pandavideo/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandavideo/api-v2/revisions/4fbd3c623ca9/schema)