---
title: "Get model creation form configuration"
method: GET
path: "/v1/models/create-form-config"
tags: ["Models"]
---

# Get model creation form configuration

`GET /v1/models/create-form-config`

Returns the multi-step form config (steps, elements, options) for creating a model. Labels are localized to the user profile locale (or the optional locale query param for guests); option values stay English and are validated against enums on POST /v1/models.

## Query parameters

- `locale` string

## Response `200`

Form configuration retrieved successfully

- GetModelCreateFormConfigResponseDto
  - `steps` FormStepDto[], required — Ordered steps for the model creation form
    - `stepIndex` number, required — Step index (0-based)
    - `title` string — Optional step title
    - `sectionType` string — UI hint: grid, list, pills, cards, squares, single-select
    - `elements` FormElementDto[], required — Elements in this step
      - `elementIndex` number, required — Index of the element within the step
      - `type` string, required — Element type: single-select, multi-select, audio-select, option-grid, option-list, option-pills, option-squares
      - `fieldKey` string, required — Field key used in form state and in CreateModelRequestBodyDto
      - `title` string — Title above the element (e.g. "Choose Hair Style")
      - `label` string — Helper or placeholder text
      - `options` FormOptionDto[], required — Options for this element
        - `value` object, required — Value to submit with the form
        - `label` string, required — Label displayed in the UI
        - `imageUrl` string — Optional image URL
        - `coverImage` string — Optional cover image URL
        - `audioUrl` string — Optional audio URL (voice step)
        - `type` string — Optional type e.g. "audio"
        - `emoji` string — Optional emoji/icon for display
        - `description` string — Optional description (personality)
        - `icon` string — Optional icon for display
      - `maxSelections` number — Max selections (e.g. 3 for hobbies)

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)