v1

latestOpenAPI 3.0.02026-08-06165119238.1 KB
Component Library

Generate Thumbnail 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.
post/v4/thumbnails/upload-url

Request body

fileNamestring

The name of the file. Unique file names are recommended but not enforced; the system generates a unique ID for each upload.

contentTypestring

The MIME type of the file. Supported MIME types include image/jpeg, image/png, and image/gif.

Example request

{
  "fileName": "unique-thumbnail.jpg",
  "contentType": "image/jpeg"
}

Response

Successfully generated URL for thumbnail upload.

idstring

A unique identifier for the uploaded thumbnail, used for referencing in the application.

uploadUrlstring

The pre-signed URL for uploading the thumbnail.