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

# Changes to Add a highlight to a clip

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

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

## Timeline

Changed in 4 of 72 revisions.

- **2026-10-23** `f7923c831a59`: 2 info
- **2026-09-28** `ac47c99c144f`: 9 warning
- **2026-09-13** `8755ac4e46ca`: 2 info
- **2026-09-09** `6b1132ef42fb`: 14 warning, 2 info

## Changes

- **2026-10-23** `f7923c831a59`: 2 info
  - added the new optional request property `transition`
  - added the required property `mask/transition` 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-13** `8755ac4e46ca`: 2 info
  - added the new optional request property `intensity`
  - added the required property `mask/intensity` to the response with the `200` status
- **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/highlights/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/highlights/post)