---
title: "Generate Version Mockups"
method: POST
path: "/api/v1/render/generate-version"
tags: ["Generating Mockups"]
---

# Generate Version Mockups

`POST /api/v1/render/generate-version`

## Request

- Base URL: `https://mockupper.damdafa.com/mockupper`
- URL: `https://mockupper.damdafa.com/mockupper/api/v1/render/generate-version`
- Auth: HTTP bearer

Triggers async mockup generation.
Returns jobId.

## Headers

- `ProviderId` 'firebase' | 'google' | 'apple'
- `X-Provider-Id` 'firebase' | 'google' | 'apple'
- `X-Device-Id` string, nullable

## Request body

- GenerateVersionRequest
  - `projectId` string, required
  - `versionId` string, required
  - `groupId` string, required
  - `screenIds` string[], nullable
  - `locales` MockupperLocale[], nullable
  - `platforms` Platform[], nullable
  - `batchId` string, nullable
  - `generationId` string, nullable
  - `quality` 'draft' | 'standard' | 'pro'
  - `translateOnlyText` boolean, nullable: Translate only text

## Response `200`

Successful Response

- GenerateVersionResponse
  - `jobId` string, required

## Other responses

- `401`: Unauthorized
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/damdafa/apis/mockupper-api.md) · [All operations](https://skmtc.dev/damdafa/apis/mockupper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/damdafa/apis/mockupper-api/revisions/5713d43bfed1?raw)