---
title: "Add a zoom effect"
method: POST
path: "/projects/{projectId}/effects/zoom"
tags: ["Platform"]
---

# Add a zoom effect

`POST /projects/{projectId}/effects/zoom`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/projects/{projectId}/effects/zoom`
- Auth: API key in header `Authorization`

Add a zoom effect.

## Path parameters

- `projectId` string, required

## Request body

- object
  - `timeline_item_id` string, uuid: Optional unused ID for the new effect timeline item. Omit to generate one; this is not the ID of an existing clip.
  - `content_item_id` string, uuid: Optional unused ID for the new effect content item. Omit to generate one.
  - `effect_id` string, uuid: Optional unused ID for the new effect. Omit to generate one.
  - `name` string
  - `start_time_seconds` number
  - `duration_seconds` number
  - `easing` 'linear' | 'easeIn' | 'easeOut' | 'easeInOut'
  - `layer_index` integer
  - `order_index` integer
  - `settings` object
    - `scale` object
      - `start` number, required
      - `end` number, required
    - `translate` object
      - `start` object, required
        - `x` number, required
        - `y` number, required
      - `end` object, required
        - `x` number, required
        - `y` number, required
    - `anchor` object
      - `x` number, required
      - `y` number, required
    - `style` 'transition' | 'hard'
    - `phase` 'in' | 'out' | 'both' | 'none'
    - `inDurationSeconds` number
    - `outDurationSeconds` number, nullable
    - `outScale` number, nullable

## Response `200`

Successful response

- object
  - `success` true, required
  - `project_id` string, required
  - `timeline_item_id` string, required
  - `content_item_id` string, required
  - `effect_id` string, required
  - `effect_type` 'zoom' | 'mask' | 'colorgrade' | 'transition' | 'remotion', required
  - `txid` number, nullable, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)