Assets
Products

Attach assets to a listing product

Attaches one or more assets to a listing product gallery and optionally to multiple listing variants. mode=draft writes DB links only (with validation and draft promotion when needed). mode=publish triggers async Shopify upload via attachProducts flow and requires the listing to already have a live snapshot (listing.live). Accesses MongoDB for products, variants, and assets; publish mode is async.

post/assets/attachListing

Request

  • Base URL
    https://api.pics.io
  • Auth
    HTTP bearer

Request body

listingIdstring required
assetIdsstring[] required
variantIdsstring[]
listingGalleryboolean

When true, attaches assets to listing gallery. Defaults to true when variantIds is empty, false otherwise.

mode'draft' | 'publish'

Response

Ok

successboolean
attachedCountnumber
assetsToProcessCountnumber

Changes

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