---
title: "List motion styles"
method: GET
path: "/motion-style"
---

# List motion styles

`GET /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`

The 14 built-in motion styles, from the stillest to the liveliest, then the workspace's saved styles, newest first. Use an id as videoSettings.motionStyle. Docs: https://postnitro.ai/docs/embed/api/motion-styles.md

## Response `200`

OK

- object
  - `success` boolean
  - `data` object
    - `styles` MotionTemplateItem[]
      - `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

---

[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)