---
title: "Renames a generated motion (Roles: user)"
method: PUT
path: "/games/motions/{id}"
tags: ["Gamestorming"]
---

# Renames a generated motion (Roles: user)

`PUT /games/motions/{id}`

## Request

- Base URL: `https://api.ludo.ai/api`
- URL: `https://api.ludo.ai/api/games/motions/{id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ludo/apis/ludo-ai-api/docs/games/motions/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Request body

- MotionUpdatePayload
  - `name` string, required: Lowercase ASCII letters, digits and hyphens (safe as a clip name in Godot, Blender and Unity).

## Response `200`

Success

- Motion
  - `_id` string, required
  - `user_id` string, required
  - `name` string: A kebab-case name written by the ML (e.g. overhead-two-handed-sword-slash-to-the-ground), which the user can change. It names the clip in 3D animations made from the motion.
  - `prompt` string: The request the motion was generated from.
  - `caption` string: The description the motion model was given.
  - `seed` integer
  - `duration` number, float
  - `fps` integer
  - `loop` boolean
  - `start_idle` boolean
  - `end_idle` boolean
  - `keep_facing` boolean
  - `left_hand` string
  - `right_hand` string
  - `preview_url` string: mp4 of the motion on the presets' mannequin (low / SW view), at real speed.
  - `clip_url` string: The motion data as the ML returned it (gzip). Server side only.
  - `ml_id` string: The id the ML gave the motion. Server side only.
  - `date` integer
  - `deleted` boolean

## Other responses

- `400`: Error

## Changes

- **2026-11-10** `970a84f6c315`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ludo/apis/ludo-ai-api/changes/games/motions/:id/put.md)

---

[API](https://skmtc.dev/ludo/apis/ludo-ai-api.md) - [All operations](https://skmtc.dev/ludo/apis/ludo-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ludo/apis/ludo-ai-api/revisions/970a84f6c315?raw)