---
title: "Change a motion style"
method: PUT
path: "/motion-style/{id}"
---

# Change a motion style

`PUT /motion-style/{id}`

## Request

- Base URL: `https://embed-api.postnitro.ai`
- URL: `https://embed-api.postnitro.ai/motion-style/{id}`
- Auth: API key in header `embed-api-key`

A new name, new motion, or both. Built-in styles can't be changed (422). Reading is open to every key; saving, changing and deleting need an active paid plan, a cancelled one counting until it ends (402 otherwise). A video keeps its own copy of the motion it was given, so changing or deleting one never changes a video already made.

## Path parameters

- `id` string, required

## Request body

- object: A new name, new motion (replacing the old whole), or both
  - `name` string
  - `designId` string: A video in the workspace, whose whole motion is saved, as Save as style keeps it in the editor
  - `slides` object: A built-in style for each slide type; body_slide covers body slides with a picture and without. A type left out takes after the nearest one given
    - `starting_slide` string
    - `body_slide` string
    - `ending_slide` string

## Response `200`

OK

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `style` MotionTemplateItem: A motion style or sequence. Built-in styles have only id, name, builtIn and summary
      - `id` string: For a style, the value of videoSettings.motionStyle: a built-in style's name or a saved style's id. For a sequence, the value of videoSettings.sequenceId
      - `name` string: As the editor shows it. Saved names needn't be unique
      - `builtIn` boolean: true for PostNitro's styles, which can't be changed or deleted
      - `summary` string: What it does, in a line, e.g. 'Starting slide: Typewriter · Body slides: Clean · Ending slide: Bold' or 'title typewriter/letter → description fade'
      - `motion` object: The stored motion, as the editor keeps it. Saved ones only: when one is read, saved or changed, not in a list
      - `createdAt` string, date-time
      - `updatedAt` string, date-time

## Other responses

- `400`: Motion that can't be used, with the reason: a design that isn't a video, an unknown slide type or style, a step that can't be used and where
- `402`: Saving, changing or deleting without an active paid plan (a cancelled plan counts until it ends)
- `404`: No such id in the workspace (of this kind), or a designId that isn't the workspace's
- `409`: The workspace already keeps 100 of this kind
- `422`: The body's shape: a missing name, motion given no way or more than one, an unknown field

---

[API](https://skmtc.dev/postnitro/apis/postnitro-embed-api.md) - [All operations](https://skmtc.dev/postnitro/apis/postnitro-embed-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postnitro/apis/postnitro-embed-api/revisions/428cb3ea3f6a?raw)