---
title: "List Tella Motion effects"
method: GET
path: "/v1/motion/effects"
tags: ["Tella Motion"]
---

# List Tella Motion effects

`GET /v1/motion/effects`

## Request

- Base URL: `https://api.tella.com`
- URL: `https://api.tella.com/v1/motion/effects`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/motion/effects/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the effect kinds the `addEffect` command puts on a node's stack, each with its parameters' names, types, ranges, units and defaults, and its presets by name. `kind` returns one effect with its presets' values, and `kind` with `preset` one preset's.

## Query parameters

- `kind` string: One effect kind: the response is `effect`, with each preset's values where they differ from the kind's defaults.
- `preset` string: With `kind`: one of its presets, with every value it sets.

## Response `200`

OK

- MotionEffectsResponse: The effect kinds the `addEffect` command takes
  - `effect` object: With `kind`: that effect, its presets with their values; with `preset` too, that preset's `params`.
  - `effects` object[]: Without `kind`: each effect kind (blurs, glows, shadows, colour grading, keying, distortion, wipes, path effects, echo, repeater) with its parameters' names, types, ranges, units and defaults, its presets by name and description, and `presetsKeep`, the parameters a preset leaves as they are.

## Other responses

- `400`: The request was malformed or contained invalid parameters.
- `401`: Authentication is required. Provide a valid API key.
- `403`: You don't have permission to access this resource.
- `404`: The requested resource was not found.
- `409`: The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.
- `429`: You have exceeded the rate limit. Please slow down.
- `500`: An unexpected error occurred
- `501`: The requested operation is not implemented.
- `503`: A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.

## Changes

> 65 revisions in range; 1 not diffed.

- **2026-10-27** `5caf72ed8935`: 1 breaking, 3 info
  - the response property `effects` became optional for the status `200`
  - added the new optional `query` request parameter `kind`
  - added the new optional `query` request parameter `preset`
  - added the optional property `effect` to the response with the `200` status
- **2026-10-22** `156b28c30e54`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/motion/effects/get.md)

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withchima/apis/tella-public-api/revisions/0cc3fcd307ad?raw)