---
title: "Set a video's thumbnail"
method: PUT
path: "/v1/videos/{id}/thumbnail"
tags: ["Videos"]
---

# Set a video's thumbnail

`PUT /v1/videos/{id}/thumbnail`

Sets the video's thumbnail from either an uploaded image or a frame of the video itself. Provide exactly one of `sourceId` (an image source from `POST /v1/sources` with `kind: "image"` — upload the image bytes to its `uploadUrl` first) or `inpointMs` (a time on the video's playback timeline). Setting one mode clears the other.

## Path parameters

- `id` string, required — Unique video identifier

## Request body

- SetVideoThumbnailRequest — Request body for setting a video's thumbnail. Provide exactly one of sourceId (uploaded image) or inpointMs (frame from the video).
  - `inpointMs` integer — Pick a video frame as the thumbnail: time in ms on the video's playback timeline (cuts applied, cumulative across clips). Clears any previously uploaded thumbnail image. Mutually exclusive with sourceId.
  - `sourceId` string — Use an uploaded image as the thumbnail. Source ID from POST /v1/sources (kind: 'image'); upload the image bytes to the source's uploadUrl first. Mutually exclusive with inpointMs.

## Response `200`

Thumbnail set successfully

- SetVideoThumbnailResponse — The thumbnail that was set
  - `customThumbnailURL` string — CDN URL of the uploaded thumbnail image. Only present when the thumbnail was set from a sourceId.
  - `inpointMs` integer — The thumbnail frame time in ms. Only present when the thumbnail was set from an inpointMs.

## Other responses

- `400` — The request was malformed or contained invalid parameters.
- `401` — Authentication is required. Provide a valid API key.
- `403` — You don't have permission to access this resource.
- `404` — The requested resource was not found.
- `429` — You have exceeded the rate limit. Please slow down.
- `500` — An unexpected error occurred
- `501` — The requested operation is not implemented.

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) · [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withchima/tella-public-api/revisions/cd69045c703a/schema)