---
title: "Changes to Add an overlay to a clip"
method: POST
path: "/v1/videos/{id}/clips/{clipId}/overlays"
---

# Changes to Add an overlay to a clip

`POST /v1/videos/{id}/clips/{clipId}/overlays`

> Every recorded change to this operation, newest first.
> 72 revisions in range; 1 not diffed.

## Timeline

Changed in 7 of 72 revisions.

- **2026-10-31** `5e88f2f4b81d`: 1 info
- **2026-10-22** `156b28c30e54`: 1 warning, 5 info
- **2026-10-13** `4def4dc82a45`: 1 info
- **2026-10-09** `9773130bbc2b`: 2 info
- **2026-09-29** `704d6fc3bc60`: 1 info
- **2026-09-28** `ac47c99c144f`: 9 warning
- **2026-09-09** `6b1132ef42fb`: 14 warning, 2 info

## Changes

- **2026-10-31** `5e88f2f4b81d`: 1 info
  - added the new optional request property `transition`
- **2026-10-22** `156b28c30e54`: 1 warning, 5 info
  - added the new `motion` enum value to the `overlay/type` response property for the response status `200`
  - added the new optional request property `depthChanges`
  - added the new optional request property `motionDocumentId`
  - the request property `sourceId` became optional
  - added the optional property `overlay/depthChanges` to the response with the `200` status
  - added the optional property `overlay/motionDocumentId` to the response with the `200` status
- **2026-10-13** `4def4dc82a45`: 1 info
  - added the new optional request property `depth`
- **2026-10-09** `9773130bbc2b`: 2 info
  - added the new optional request property `animation`
  - added the required property `overlay/animation` to the response with the `200` status
- **2026-09-29** `704d6fc3bc60`: 1 info
  - added the required property `overlay/zIndex` to the response with the `200` status
- **2026-09-28** `ac47c99c144f`: 9 warning
  - added the new `edit_conflict` enum value to the `error` response property for the response status `400`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `401`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `403`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `404`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `409`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `429`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `500`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `501`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `503`
- **2026-09-09** `6b1132ef42fb`: 14 warning, 2 info
  - added the new `conflict` enum value to the `error` response property for the response status `400`
  - added the new `conflict` enum value to the `error` response property for the response status `401`
  - added the new `conflict` enum value to the `error` response property for the response status `403`
  - added the new `conflict` enum value to the `error` response property for the response status `404`
  - added the new `conflict` enum value to the `error` response property for the response status `429`
  - added the new `conflict` enum value to the `error` response property for the response status `500`
  - added the new `conflict` enum value to the `error` response property for the response status `501`
  - added the new `unavailable` enum value to the `error` response property for the response status `400`
  - added the new `unavailable` enum value to the `error` response property for the response status `401`
  - added the new `unavailable` enum value to the `error` response property for the response status `403`
  - added the new `unavailable` enum value to the `error` response property for the response status `404`
  - added the new `unavailable` enum value to the `error` response property for the response status `429`
  - added the new `unavailable` enum value to the `error` response property for the response status `500`
  - added the new `unavailable` enum value to the `error` response property for the response status `501`
  - added the non-success response with the status `409`
  - added the non-success response with the status `503`

---

[Operation](https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/videos/:id/clips/:clipId/overlays/post.md) - [API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [Page](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/videos/:id/clips/:clipId/overlays/post)