SHshopfront
Listings

Get presigned URLs for single listing image upload

Get presigned S3 upload URLs for single listing generation. Use this when sending images via S3 keys instead of URLs or base64.

Flow:

  1. Call this endpoint with requestId and imageCount
  2. Upload images directly to S3 using the returned presigned URLs (parallel PUT requests)
  3. Call POST /v1/listings/generate with the returned keys as imageS3Keys

Presigned URLs expire after 10 minutes. The first upload slot (offset 0) includes a dedicated hero image URL.

post/v1/listings/presign

Request

  • Base URL
    https://api.shopfront.app
  • Auth
    HTTP bearer

Request body

requestIdstring uuid required

Client-generated UUID for request tracking (same ID used in generate call)

imageCountinteger required

Number of presigned URLs to generate

offsetinteger

Starting index for image keys (for chunked uploads)

Response

Presigned URLs generated

Changes

No recorded changes to this operation across all 1 revision of this API.