Skip to main content
PATCH
Update a layout

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Video ID

clipId
string
required

Clip ID

layoutId
string
required

Layout (section) ID

Body

application/json

Update an existing layout on a clip

crop
object | null

Crop the clip's screen recording for this layout only — the editor's crop modal on “This layout only”. Other layouts keep following the clip's crop; null makes this layout follow it again. Masks that start in the layout stay anchored to their content, and a custom layout's screen box keeps its on-canvas scale unless the same request writes layout geometry. Needs a screen recording in the clip. To crop the recording across the whole clip use auto-crop.

durationMs
integer
Required range: 200 <= x <= 9007199254740991
layout
Fullscreen · object

Single-layer fullscreen. Camera-subject clips take an optional style (regular/stretch); basic-subject clips take an optional screenFit.

media
ClipMediaImage · object

Replace the layout's media content. Only valid on time-ranged layouts; rejected on the base (clip-spanning) layout.

popOut
object | null

Switch the camera pop-out on (an object merges over the current settings) or off (null). Omitted leaves it as it is, except that a cut-out layout drops it. On the base layout this and crop are accepted without layout.

startTimeMs
integer

Start time in ms on the clip's playback timeline (cuts applied)

Required range: 0 <= x <= 9007199254740991
transitionStyle
enum<string>

Only valid on time-ranged layouts; rejected on the base (clip-spanning) layout.

Available options:
spring,
hardCut

Response

OK

A layout on a clip

layout
object
required

A layout attached to a clip. Times are in ms on the clip's playback timeline (cuts applied). Internally the layout stays anchored to the footage, so it doesn't drift when cuts change later.

Last modified on October 6, 2026