---
title: "Generate images onto a canvas"
method: POST
path: "/v1/canvases/{assetId}/images"
tags: ["Canvas"]
---

# Generate images onto a canvas

`POST /v1/canvases/{assetId}/images`

## Path parameters

- `assetId` string, required

## Request body

- GenerateCanvasImagesDto
  - `requestId` string, uuid, required — Client-minted idempotency key for this submit
  - `prompt` string, required — What to draw or change in this iteration
  - `brief` string — The original design brief to preserve across iterations
  - `count` integer — How many variations
  - `intent` 'reference' | 'concept-plan' — Omit to let the backend resolve it
  - `sourceTreatment` 'text-only' | 'edit' | 'inspiration' — Omit to let the backend resolve it; only the retry path replays a stored one
  - `aspectRatio` '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '9:16' | '16:9' | '21:9'
  - `thinking` 'standard' | 'high' — Omit for standard thinking
  - `referenceAssetIds` string[] — Images to generate from
  - `replaceAssetId` string, uuid — The image this result takes the place of
  - `region` object — Where on the canvas the person is looking
    - `x` number, required
    - `y` number, required
    - `w` number, required
    - `h` number, required
  - `viewport` object — The visible canvas rectangle
    - `x` number, required
    - `y` number, required
    - `w` number, required
    - `h` number, required

## Response `201`

Images admitted

- GeneratedCanvasImagesResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object, required — Response data
    - `assetIds` string[], required — The pending assets created, in slot order
    - `replayed` boolean, required — True when this request id had already been admitted
  - `timestamp` string, date-time, required — Timestamp of the response

## Changes

- **2026-09-25** `ad71cae36f29` — 2 warning, 1 info
  - removed the request property `imageQuality`
  - removed the request property `reasoningEffort`
  - added the new optional request property `thinking`
- **2026-09-19** `28c2b3b6b3b4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maket/apis/virtual-architect-api/changes/v1/canvases/:assetId/images/post.md)

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maket/apis/virtual-architect-api/revisions/ad71cae36f29?raw)