SHshopfront
Listings

Get presigned URLs for bulk image upload

Get presigned S3 upload URLs for large batches (up to 1000 images). Use this when you have more than 50 images — the URL input on POST /v1/listings/bulk is limited to 50.

Flow:

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

Presigned URLs expire after 10 minutes.

post/v1/listings/bulk/presign

Request

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

Request body

batchIdstring uuid required

Client-generated UUID for batch tracking

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.