---
title: "Update media overlay transform"
method: PATCH
path: "/projects/{projectId}/timeline/media/{timelineItemId}"
tags: ["Media Library"]
---

# Update media overlay transform

`PATCH /projects/{projectId}/timeline/media/{timelineItemId}`

## Request

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

Update media overlay transform.

## Path parameters

- `projectId` string, required
- `timelineItemId` string, required

## Request body

- object
  - `position_preset` 'center' | 'fullscreen' | 'top-half' | 'bottom-half' | 'pip-top-left' | 'pip-top-right' | 'pip-bottom-left' | 'pip-bottom-right'
  - `position_x` number
  - `position_y` number
  - `width_px` number
  - `height_px` number
  - `keep_aspect_ratio` boolean
  - `scale` number
  - `opacity` number
  - `animation_preset` 'none' | 'fadeIn' | 'fadeOut' | 'zoomIn' | 'zoomOut' | 'slideLeft' | 'slideRight' | 'slideUp' | 'slideDown' | 'popIn' | 'bounce' | 'spin'
  - `remove_animations` boolean
  - `blurred_background` boolean
  - `volume` number

## Response `200`

Successful response

- union
  - object
    - `success` true, required
    - `timelineItemId` string, required
    - `updated` object, required
      - `positionX` number, required
      - `positionY` number, required
      - `widthPx` number, nullable, required
      - `heightPx` number, nullable, required
      - `keepAspectRatio` boolean, required
      - `opacity` number, nullable, required
      - `blurredBackground` boolean, required
      - `volume` number, required
    - `animationApplied` string, nullable, required
    - `keyframeCount` integer, required
    - `warnings` string[], required
    - `message` string, required
  - object
    - `success` false, required
    - `error` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `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)