---
title: "Step by step game generator (Roles: user)"
method: POST
path: "/games/generate/step-by-step"
tags: ["Gamestorming"]
---

# Step by step game generator (Roles: user)

`POST /games/generate/step-by-step`

## Request body

- StepByStepPayload
  - `request_id` string
  - `genre` string
  - `n` integer
  - `platform` string
  - `step` string
  - `step_choices` StepValue[]
    - `step` string
    - `description` string
    - `value` string
    - `score` LudoScore
      - `metrics` LudoScoreMetric[]
        - `_max_similarity` number, double
        - `_min_similarity` number, double
        - `description` string
        - `key` string
        - `name` string
        - `score` number, double
        - `supporting_games_title` string
        - `supporting_games` string[]
        - `core_metric` boolean
        - `plotly_plot` PlotlyPlot
          - `data` PlotlyPlotData[]
            - `mode` string
          - `layout` PlotlyPlotData
            - `mode` string
        - `insights` LudoScoreInsight[]
          - `tag` string
          - `text` string
      - `params` string
      - `score_text` string
      - `score_unit` string
      - `score` number, double
      - `timestamp` integer
      - `country` string
      - `sources` string[]
      - `version` string
      - `badge` LudoScoreBadge
        - `description` string
        - `icon_url` string
        - `key` string
        - `name` string
      - `insights` LudoScoreInsight[]
        - `tag` string
        - `text` string

## Response `200`

Success

- StepValue[]
  - `step` string
  - `description` string
  - `value` string
  - `score` LudoScore
    - `metrics` LudoScoreMetric[]
      - `_max_similarity` number, double
      - `_min_similarity` number, double
      - `description` string
      - `key` string
      - `name` string
      - `score` number, double
      - `supporting_games_title` string
      - `supporting_games` string[]
      - `core_metric` boolean
      - `plotly_plot` PlotlyPlot
        - `data` PlotlyPlotData[]
          - `mode` string
        - `layout` PlotlyPlotData
          - `mode` string
      - `insights` LudoScoreInsight[]
        - `tag` string
        - `text` string
    - `params` string
    - `score_text` string
    - `score_unit` string
    - `score` number, double
    - `timestamp` integer
    - `country` string
    - `sources` string[]
    - `version` string
    - `badge` LudoScoreBadge
      - `description` string
      - `icon_url` string
      - `key` string
      - `name` string
    - `insights` LudoScoreInsight[]
      - `tag` string
      - `text` string

## Other responses

- `400` — Error

---

[API](https://skmtc.net/ludo/apis/ludo-ai-api.md) · [All operations](https://skmtc.net/ludo/apis/ludo-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ludo/ludo-ai-api/revisions/3af866d68651/schema)