---
title: "Read a motion style"
method: GET
path: "/motion-style/{id}"
---

# Read a motion style

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

One saved style with its stored motion, or a built-in style by its name

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `success` boolean
  - `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

- `404`: No such id in the workspace (of this kind), or a designId that isn't the workspace's

---

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