---
title: "Changes to List layouts on a clip"
method: GET
path: "/v1/videos/{id}/clips/{clipId}/layouts"
---

# Changes to List layouts on a clip

`GET /v1/videos/{id}/clips/{clipId}/layouts`

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

## Timeline

Changed in 13 of 72 revisions.

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

## Changes

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