---
title: "Generate a run title from parameter choices"
method: POST
path: "/cases/generate_run_title"
tags: ["cases"]
---

# Generate a run title from parameter choices

`POST /cases/generate_run_title`

Generate a short title for the run that applies user-chosen parameter
values to a case notebook. Takes the same request body as
/cases/generate_notebook and rejects the same parameter values (a
variable without a top-level assignment in the parameter cell, or a
notebook without a parameter cell). Only the parameters whose value
differs from the notebook's own assignment are named in the title,
which is generated by the LLM.

## Request body

- object
  - `case_template_id` string — Public id of the case template the notebook belongs to. When present, the template's parameter definitions (value types, labels and units) drive value quoting and the generated title; without it the current right-hand side of each assignment decides the quoting.
  - `language` 'ja' | 'en' — Language for the generated title. Defaults to "ja".
  - `notebook` object, required — The notebook JSON object (.ipynb) the parameters apply to.
  - `parameters` object[], required — Parameter values to apply to the notebook.
    - `value` string, required — New value for the variable.
    - `variable_name` string, required — Name of the notebook variable to rewrite.

## Response `200`

Run title generated successfully

- object
  - `title` string, required — Short title describing the computation with the applied parameters.

## Other responses

- `400` — Bad request
- `503` — Service unavailable
- `504` — Gateway timeout
- `default` — Other error

## Changes

- **2026-09-15** `f7cb634729fe` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/matlantis/apis/matlantis-web-ui-backend-api/changes/cases/generate_run_title/post.md)

---

[API](https://skmtc.dev/matlantis/apis/matlantis-web-ui-backend-api.md) · [All operations](https://skmtc.dev/matlantis/apis/matlantis-web-ui-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/matlantis/apis/matlantis-web-ui-backend-api/revisions/292994a87fa3?raw)