---
title: "Generate Thumbnail Upload URL"
method: POST
path: "/v4/thumbnails/upload-url"
tags: ["Component Library"]
---

# Generate Thumbnail Upload URL

`POST /v4/thumbnails/upload-url`

Generates a pre-signed URL for securely uploading a thumbnail image. The link expires after *10 minutes*.

**Considerations:**
- Uploaded images are not optimized by the server; please upload images pre-optimized for web use.
- Each uploaded file receives a unique `thumbnailId` for reference within your application, but the file name in the bucket is derived from this ID, ensuring no conflicts with existing files.

## Request body

- object
  - `fileName` string — The name of the file. Unique file names are recommended but not enforced; the system generates a unique ID for each upload.
  - `contentType` string — The MIME type of the file. Supported MIME types include image/jpeg, image/png, and image/gif.

## Response `200`

Successfully generated URL for thumbnail upload.

- object
  - `id` string — A unique identifier for the uploaded thumbnail, used for referencing in the application.
  - `uploadUrl` string — The pre-signed URL for uploading the thumbnail.

## Other responses

- `400` — The request is invalid. A required attribute is missing or an attribute did not meet the expected criteria.
- `401` — Authentication credentials were not provided or are invalid.

---

[API](https://skmtc.net/zuora/apis/admin-api-reference.md) · [All operations](https://skmtc.net/zuora/apis/admin-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuora/admin-api-reference/revisions/789812d35ac8/schema)