---
title: "Create a design preview"
method: POST
path: "/open-api/v1.0/design-pipeline/previews"
tags: ["Design Pipeline"]
deprecated: true
---

# Create a design preview

`POST /open-api/v1.0/design-pipeline/previews`

> **Deprecated.**

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Deprecated. Use POST /open-api/v1.0/products (type=design) to create design products. Creates a design preview pipeline that generates product mockup images synchronously. Submit product and design placement info, receive pipelineId, customizationId, and rendered images directly in the response.

## Request body

- ComFourthwallOpenapiModelDesignpipelineCreateDesignPipelinePreviewRequestV1
  - `customizationId` string
  - `productId` string
  - `regions` ComFourthwallOpenapiModelDesignpipelineDesignPipelineRegionV1[], required
    - `region` string, required — Name of the product region to place the image on, e.g. `front` or `back`.
    - `url` string — URL of the image to render on the region. Required unless `imageId` is given; `imageId` takes precedence when both are present.
    - `imageId` string — Id of a media image already saved via `POST /open-api/v1.0/media/images`. When set, the region renders that saved image and `url` is ignored — letting one upload back many previews without re-registering. Required unless `url` is given.
    - `placementId` string — Placement to target when `placementStrategy` is `PLACEMENT_ID`. Required for that strategy and ignored by the others.
    - `placementStrategy` 'AUTO' | 'FILL_ALL' | 'FULL_REGION' | 'PLACEMENT_ID' — How the image is placed on the region. Defaults to `AUTO` when omitted, and takes precedence over `placementId`/`fillAllPlacements`. - `AUTO` — let the renderer decide using the product's automation defaults (its preferred placement, or fill-all for products like mugs/stickers). - `FILL_ALL` — apply the image to every placement in the region. - `FULL_REGION` — render the image across the full region, skipping the preferred placement. - `PLACEMENT_ID` — target the single placement named by `placementId` (required for this strategy).
    - `width` integer — Image width in pixels. Provide with `height` so the image can be registered as a reusable media asset.
    - `height` integer — Image height in pixels. Provide with `width` so the image can be registered as a reusable media asset.
  - `colors` string[]
  - `sizes` string[]
  - `metadata` object — 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.

## Response `201`

Created

- ComFourthwallOpenapiModelDesignpipelineCreateDesignPipelinePreviewResponseV1
  - `pipelineId` string, required
  - `customizationId` string
  - `images` ComFourthwallOpenapiModelDesignpipelineDesignPipelineImageV1[]
    - `url` string, required
    - `width` integer, required
    - `height` integer, required
    - `style` string, required
    - `color` string, required
    - `size` string
    - `region` string

## Other responses

- `400` — Possible errors: `CUSTOMIZATION_ALREADY_USED_ERROR`, `CUSTOMIZATION_FOR_REQUESTABLE_PRODUCT_ERROR`, `CUSTOMIZATION_OPTION_DO_NOT_EXISTS`, `CUSTOMIZATION_REGIONS_DUPLICATION`, `CUSTOMIZATION_TOO_MANY_VARIANTS`, `DESIGN_PIPELINE_BACKEND_RENDERING_NOT_SUPPORTED`, `DESIGN_PIPELINE_INVALID_REGIONS`, `DESIGNER_NOT_SUPPORTED_PRODUCT_ERROR`, `DIGITAL_ITEMS_NOT_VALID_ERROR`, `DIGITAL_ITEMS_SIZE_LIMIT_ERROR`, `DUPLICATE_OFFER_VARIANT_TYPE_OPTION_ERROR`, `DUPLICATE_OFFER_VARIANT_TYPES_ERROR`, `ILLEGAL_FULFILLMENT_SERVICE_ERROR`, `ILLEGAL_FULFILLMENT_SERVICE_FOR_GIFT_CARD_ERROR`, `INVALID_OFFER_VARIANT_TYPE_METADATA_ERROR`, `MISSING_OFFER_COLOR_SWATCH_ERROR`, `MISSING_PRICE_FOR_SIZE_ERROR`, `MISSING_VERSION_ERROR`, `OFFER_INVALID_STATE_ERROR`, `OFFER_SHIPMENT_EDIT_NOT_ALLOWED_ERROR`, `RENDERING_PRODUCT_NOT_SUPPORTED_ERROR`, `TOTAL_DIGITAL_STORAGE_LIMIT_ERROR`, `UNTRUSTED_ASSET_SOURCE_ERROR`, `VARIANT_MISSING_SIZE_ERROR`
- `404` — Possible errors: `MEDIA_FILE_DO_NOT_EXISTS`, `OFFER_BY_CUSTOMIZATION_ID_AND_SHOP_ID_NOT_FOUND`, `OFFER_BY_CUSTOMIZATION_ID_NOT_FOUND_ERROR`, `OFFER_NOT_FOUND_BY_SHOP_ID_AND_ID_ERROR`, `PRODUCT_CATALOG_PRODUCT_ID_NOT_FOUND`, `RENDERING_NOT_SCHEDULED_ERROR`, `SHOP_TEAM_MEMBER_SHOP_NOT_FOUND_ERROR`
- `406` — Possible errors: `PRICING_CALCULATION_NOT_SUPPORTED`
- `409` — Possible errors: `OFFER_SLUG_DUPLICATION_ERROR`, `SQL_CONSTRAINTS_ERROR`
- `422` — Possible errors: `OFFER_CATEGORY_NOT_FOUND_ERROR`
- `429` — Rate limited: 100 requests / 10 seconds per shop.

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/revisions/ef273312f051/schema)