---
title: "Changes to Update a layout"
method: PATCH
path: "/v1/videos/{id}/clips/{clipId}/layouts/{layoutId}"
---

# Changes to Update a layout

`PATCH /v1/videos/{id}/clips/{clipId}/layouts/{layoutId}`

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

## Timeline

Changed in 14 of 70 revisions.

- **2026-10-22** `156b28c30e54`: 1 warning, 3 info
- **2026-10-19** `127438d189a6`: 1 breaking, 1 info
- **2026-10-15** `12b6eccbb321`: 1 warning, 3 info
- **2026-10-14** `d414ee36581a`: 2 info
- **2026-10-13** `862d32ff02f5`: 4 info
- **2026-10-09** `25910750ad41`: 1 info
- **2026-10-09** `9773130bbc2b`: 2 info
- **2026-09-29** `704d6fc3bc60`: 4 warning, 4 info
- **2026-09-28** `ac47c99c144f`: 9 warning, 1 info
- **2026-09-25** `b25e530cdcc5`: 2 info
- **2026-09-21** `e70780c11bde`: 1 breaking, 3 info
- **2026-09-19** `64764729bd60`: 2 info
- **2026-09-16** `10a2535edf76`: 1 breaking, 3 info
- **2026-09-09** `6b1132ef42fb`: 14 warning, 2 info

## Changes

- **2026-10-22** `156b28c30e54`: 1 warning, 3 info
  - added the new `motion` enum value to the `layout/media/items/type` response property for the response status `200`
  - added `motion` discriminator mapping keys to the `media/allOf[#/components/schemas/ClipMedia]/` request property
  - added `#/components/schemas/ClipMediaMotion` to the `media/allOf[#/components/schemas/ClipMedia]/` request property `oneOf` list
  - added the optional property `layout/media/items/documentId` to the response with the `200` status
- **2026-10-19** `127438d189a6`: 1 breaking, 1 info
  - the response property `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #6: Camera Bubble]/shape` became optional for the status `200`
  - the request property `layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #6: Camera Bubble]/shape` became optional
- **2026-10-15** `12b6eccbb321`: 1 warning, 3 info
  - added the new `perspective` enum value to the `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #3: Side by Side]/style` response property for the response status `200`
  - added the new optional request property `layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #5: Cut Out]/style`
  - added the new `perspective` enum value to the request property `layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #3: Side by Side]/style`
  - added the optional property `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #5: Cut Out]/style` to the response with the `200` status
- **2026-10-14** `d414ee36581a`: 2 info
  - added the new optional request property `media/allOf[#/components/schemas/ClipMedia]/oneOf[subschema #2: ClipMediaVideo]/startTimeMs`
  - added the optional property `layout/media/items/startTimeMs` to the response with the `200` status
- **2026-10-13** `862d32ff02f5`: 4 info
  - added the new optional request property `media/allOf[#/components/schemas/ClipMedia]/oneOf[subschema #2: ClipMediaVideo]/muted`
  - added `recording` discriminator mapping keys to the `media/allOf[#/components/schemas/ClipMedia]/` request property
  - added `#/components/schemas/ClipMediaRecording` to the `media/allOf[#/components/schemas/ClipMedia]/` request property `oneOf` list
  - added the optional property `layout/media/items/muted` to the response with the `200` status
- **2026-10-09** `25910750ad41`: 1 info
  - added the new `cutout` enum value to the request property `cameraStyle`
- **2026-10-09** `9773130bbc2b`: 2 info
  - added the new optional request property `cameraStyle`
  - added the optional property `layout/cameraStyle` to the response with the `200` status
- **2026-09-29** `704d6fc3bc60`: 4 warning, 4 info
  - added the new `blob` enum value to the `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #9: Custom]/presentation/allOf[#/components/schemas/CustomLayoutSlot]/shape` response property for the response status `200`
  - added the new `blob` enum value to the `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #9: Custom]/subject/allOf[#/components/schemas/CustomLayoutSlot]/shape` response property for the response status `200`
  - added the new `blob-outline` enum value to the `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #9: Custom]/presentation/allOf[#/components/schemas/CustomLayoutSlot]/shape` response property for the response status `200`
  - added the new `blob-outline` enum value to the `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #9: Custom]/subject/allOf[#/components/schemas/CustomLayoutSlot]/shape` response property for the response status `200`
  - added the new `blob` enum value to the request property `layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #9: Custom]/presentation/allOf[#/components/schemas/CustomLayoutSlot]/shape`
  - added the new `blob` enum value to the request property `layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #9: Custom]/subject/allOf[#/components/schemas/CustomLayoutSlot]/shape`
  - added the new `blob-outline` enum value to the request property `layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #9: Custom]/presentation/allOf[#/components/schemas/CustomLayoutSlot]/shape`
  - added the new `blob-outline` enum value to the request property `layout/allOf[#/components/schemas/ClipLayoutShape]/oneOf[subschema #9: Custom]/subject/allOf[#/components/schemas/CustomLayoutSlot]/shape`
- **2026-09-28** `ac47c99c144f`: 9 warning, 1 info
  - 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`
  - added the optional property `layout/followsBase` to the response with the `200` status
- **2026-09-25** `b25e530cdcc5`: 2 info
  - added the new optional request property `crop`
  - added the optional property `layout/crop` to the response with the `200` status
- **2026-09-21** `e70780c11bde`: 1 breaking, 3 info
  - added `#/components/schemas/CustomLayout` to the `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/` response property `oneOf` list for the response status `200`
  - added `custom` discriminator mapping keys to the `layout/allOf[#/components/schemas/ClipLayoutShape]/` request property
  - added `#/components/schemas/CustomLayout` to the `layout/allOf[#/components/schemas/ClipLayoutShape]/` request property `oneOf` list
  - added `custom` discriminator mapping keys to the `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/` response property for the response status `200`
- **2026-09-19** `64764729bd60`: 2 info
  - added the new optional request property `popOut`
  - added the optional property `layout/popOut` to the response with the `200` status
- **2026-09-16** `10a2535edf76`: 1 breaking, 3 info
  - added `#/components/schemas/CutOutLayout` to the `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/` response property `oneOf` list for the response status `200`
  - added `cut-out` discriminator mapping keys to the `layout/allOf[#/components/schemas/ClipLayoutShape]/` request property
  - added `#/components/schemas/CutOutLayout` to the `layout/allOf[#/components/schemas/ClipLayoutShape]/` request property `oneOf` list
  - added `cut-out` discriminator mapping keys to the `layout/layout/allOf[#/components/schemas/ClipLayoutShape]/` response property for the response status `200`
- **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/layouts/:layoutId/patch.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/layouts/:layoutId/patch)