Skip to content

Generate a presigned S3 PUT URL for uploading a polst image.

POST
/brands/me/polsts/{slug}/images/upload-url

Returns an S3 PUT URL the client uses to upload the binary. After the upload completes, call PATCH /brands/me/polsts/{slug} with the returned publicUrl in optionA.imageUrl or optionB.imageUrl.

slug
required
string
>= 1 characters <= 128 characters
X-Polst-Idempotency-Key
required
string
>= 8 characters <= 255 characters

Idempotency key, 8–255 URL-safe chars.

object
slot
required
string
Allowed values: optionA optionB combined
contentType
required
string
Allowed values: image/png image/jpeg image/webp

Presigned URL.

object
data
required
object
uploadUrl
required
string format: uri
key
required
string
publicUrl
required
string format: uri
expiresIn
required
integer
> 0 <= 9007199254740991
method
required
string
Allowed value: PUT
headers
required
object
key
additional properties
string

Missing idempotency key.

Missing or invalid bearer.

Missing manage scope or no brand context.

Polst not found or not owned by brand.

Validation error.