v2

latestOpenAPI 3.1.02026-07-26102336742.6 KB

Design Pipeline

Create an offer from a design

Rate limit: 100 requests / 10 seconds per shop. See Rate limiting.

Deprecated. Use POST /open-api/v1.0/products (type=design) instead. Creates a design pipeline that generates product mockup images and creates a purchasable offer synchronously. Submit product, design placement info, and offer metadata. Returns pipelineId, customizationId, rendered images, and the created offerId in the response.

post/open-api/v1.0/design-pipeline/offers

Request body

productIdstring required

colorsstring[]

sizesstring[]

namestring required

descriptionstring

publishOnCreateboolean

metadataobject

Arbitrary key-value metadata stored on the pipeline and returned by the status endpoint. At most 25 entries; keys up to 100 characters, values up to 1000 characters.

Example request

{
  "regions": [
    {
      "region": "front",
      "placementStrategy": "AUTO"
    }
  ]
}

Response

Created

pipelineIdstring required

offerIdstring

customizationIdstring