---
title: "Get full wizard form schema (backend-driven forms)"
method: GET
path: "/v1/scenes/wizard/schema"
tags: ["Scene Wizard"]
---

# Get full wizard form schema (backend-driven forms)

`GET /v1/scenes/wizard/schema`

## Response `200`

Form schema retrieved successfully

- WizardFormSchema
  - `steps` WizardStepSchema[], required — All wizard steps
    - `step` number, required — Step number (1-based)
    - `title` string, required — Step title
    - `description` string — Step description
    - `fields` FormFieldSchema[], required — Fields in this step
      - `name` string, required — Field identifier
      - `type` 'text' | 'textarea' | 'select' | 'image_upload' | 'image_generate' | 'image_crop', required — Input type
      - `label` string, required — Display label
      - `placeholder` string — Placeholder text
      - `required` boolean, required — Whether field is required
      - `examples` string[] — Example values
      - `maxLength` number — Maximum character length
      - `minLength` number — Minimum character length
      - `options` string[] — Predefined options (for select type)
      - `allowCustom` boolean — Allow custom value input (for select type)
      - `helperText` string — Helper text / description
  - `totalSteps` number, required — Total number of steps
  - `price` number, required — Price in coins to create scene
  - `maxCoverGenerations` number, required — Maximum cover generations per scene
  - `coverGenerationCost` number, required — Cost in coins per cover generation

---

[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)