---
title: "Save a motion style"
method: POST
path: "/motion-style"
---

# Save a motion style

`POST /motion-style`

## Request

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

Saves a style for the workspace, from a video's motion (designId) or from built-in styles by slide type (slides). It's the same as Your styles in the video editor. 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. Docs: https://postnitro.ai/docs/embed/api/motion-styles.md

## Headers

- `Idempotency-Key` string

## Request body

- object: A name, and the motion one way: designId or slides
  - `name` string, required
  - `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)