Skip to main content
PATCH
/
v1
/
videos
/
{id}
/
clips
/
{clipId}
/
layouts
/
{layoutId}
Update a layout
curl --request PATCH \
  --url https://api.tella.com/v1/videos/{id}/clips/{clipId}/layouts/{layoutId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "durationMs": 123,
  "layout": {
    "kind": "fullscreen",
    "screenFit": "cover",
    "style": "regular"
  },
  "media": {
    "height": 123,
    "imageUrl": "<string>",
    "type": "image",
    "width": 123
  },
  "startTimeMs": 4503599627370495,
  "transitionStyle": "spring"
}
'
{
  "layout": {
    "id": "<string>",
    "durationMs": 5000,
    "layout": {
      "kind": "fullscreen",
      "screenFit": "cover",
      "style": "regular"
    },
    "media": {
      "height": 123,
      "imageUrl": "<string>",
      "type": "image",
      "width": 123
    },
    "startTimeMs": 0,
    "transitionStyle": "spring"
  }
}

Documentation Index

Fetch the complete documentation index at: https://tella.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

​
durationMs
integer
Required range: 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.

​
startTimeMs
integer
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