---
title: "Render a preview mockup"
method: POST
path: "/v1/mockups"
---

# Render a preview mockup

`POST /v1/mockups`

## Request

- Base URL: `https://pod.agentmade.dev`
- URL: `https://pod.agentmade.dev/v1/mockups`
- Auth: none declared

## Request body

- CreateMockup
  - `artwork_id` string, required
  - `product_id` string, required
  - `color` string, required: Product colour, e.g. "black".
  - `size` string
  - `style` 'flat' | 'packshot': flat: quick placement drawing. packshot: product photo with the exact print at real size (where a product photo exists).
  - `placement` string: Print location on the product, e.g. "front" or "back". See get_product for the list.
  - `preset` string: Named position inside the placement, e.g. "center_chest", "left_chest", "full_front". Defaults to the placement default.
  - `width_mm` number: Exact printed width of the visible artwork in millimetres. Height follows the aspect ratio.
  - `height_mm` number: Maximum printed height in millimetres.
  - `top_mm` number: Distance from the top of the print area to the top of the artwork.
  - `left_mm` number: Distance from the left edge of the print area. Default: horizontally centred.

## Response `201`

Mockup URL

- Mockup
  - `mockup_url` string, required: PNG preview of the exact print on the product.
  - `style` 'flat' | 'packshot', required
  - `blank_image_url` string, nullable, required
  - `validation_status` 'PASS' | 'WARN' | 'FAIL', required
  - `summary` string, required
  - `image_prompt` string, required: A prompt for your own image model, to make an illustration from mockup_url.
  - `note` string, required

## Other responses

- `4XX`: Error with a machine-readable code and a hint for the next step
- `5XX`: Error with a machine-readable code and a hint for the next step

---

[API](https://skmtc.dev/agentmade/apis/agentmade-print-on-demand-api.md) · [All operations](https://skmtc.dev/agentmade/apis/agentmade-print-on-demand-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentmade/apis/agentmade-print-on-demand-api/revisions/542fad1de43b?raw)