---
title: "Update a thumbnail"
method: PATCH
path: "/v2/sites/{site_id}/thumbnails/{thumbnail_id}/"
tags: ["thumbnails"]
---

# Update a thumbnail

`PATCH /v2/sites/{site_id}/thumbnails/{thumbnail_id}/`

Update a thumbnail

## Path parameters

- `site_id` string, required — Unique identifier for a resource
- `thumbnail_id` string, required — Unique identifier for a resource

## Request body

- object — Payload body used when updating a custom thumbnail resource
  - `relationships` object, required — Specifies the relationships of the thumbnail being created to the associated media
    - `media` object[], required — List of media objects related to the thumbnail
      - `is_poster` boolean, required — Boolean value indicating poster status of a thumbnail

## Response `200`

Resource successfully updated

- ThumbnailResourceRead
  - `schema` string
  - `id` string — Unique identifier for a resource
  - `created` string — Date and time at which the resource was created
  - `last_modified` string — Date and time at which the resource was most recently modified
  - `type` string — Name of the type of resource.
  - `relationships` object — Ancilliary resources associated to the primary resource being read
    - `media` object[], required
      - `id` RelationshipRead
        - `id` string — Unique identifier for a resource
        - `type` string — Resource type
  - `delivery_url` string — Link to retrieve thumbnail The value of this parameter will be `null` until it has been successfully uploaded and `status` is set to `ready`.
  - `file_type` 'jpeg' | 'mp4' — File extension used for this thumbnail
  - `status` 'created' | 'processing' | 'failed' | 'ready' — Readiness state of this thumbnail
  - `thumbnail_type` 'static' | 'video'
  - `source_type` 'custom_upload' | 'default' | 'generic_audio' | 'generic_video' | 'thumbstrip_image' — Source of the thumbnail upload **Possible Values**: - `custom_upload`: User-provided thumbnail - `default`: Default thumbnail automatically pulled from 10 seconds into the video - `generic_audio`: Default thumbnail created for externally hosted media with `media_type` set to `audio` - `generic_video`: Default thumbnail created for externally hosted media with `media_type` set to `video` - `thumbstrip_image`: Thumbnail selected from the thumbstrip images via `video_position` or `thumbstrip_index`
  - `metadata` ThumbnailResourceMetadata

## Other responses

- `400` — Bad Request The request either lacks certain attributes or contains malformed/invalid attributes.
- `404` — Not Found The requested asset could not be found.
- `409` — Request conflicts with state of target resource

---

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