Skip to main content
PATCH
/
v1
/
videos
/
{id}
/
clips
/
{clipId}
Update a clip
curl --request PATCH \
  --url https://api.tella.com/v1/videos/{id}/clips/{clipId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cuts": [
    {
      "durationMs": 750,
      "startTimeMs": 1500
    }
  ],
  "name": "Updated intro",
  "order": 2
}
'
{
  "clip": {
    "background": {
      "type": "solid",
      "color": "#000000ff",
      "gradientAngle": 45,
      "gradientColor1": "#ff0080ff",
      "gradientColor2": "#7928caff",
      "imageUrl": "https://cdn.example.com/bg.png",
      "videoDurationSeconds": 12.4,
      "videoUrl": "https://cdn.example.com/bg.mp4"
    },
    "createdAt": "2026-01-15T10:30:00.000Z",
    "cuts": [
      {
        "durationMs": 750,
        "startTimeMs": 1500
      }
    ],
    "durationSeconds": 12.5,
    "id": "cl_xyz789ghi012",
    "layoutSceneType": "combi",
    "maxDurationSeconds": 14.2,
    "name": "Intro",
    "order": 0,
    "updatedAt": "2026-01-15T14:45:00.000Z",
    "videoId": "vid_abc123def456"
  }
}

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 identifier

Example:

"vid_abc123def456"

clipId
string
required

Clip identifier

Example:

"cl_xyz789ghi012"

Body

application/json

Request body for updating a clip. At least one field must be provided.

background
object

Clip background. Use type = 'solid' with color, type = 'image' with imageUrl, type = 'video' with videoUrl + videoDurationSeconds, or type = 'gradient' with gradientColor1, gradientColor2, gradientAngle.

cuts
object[]

Replaces the clip's cuts. Total cut duration must be less than maxDurationSeconds.

name
string

New clip name

Required string length: 1 - 255
Example:

"Updated intro"

order
integer

New position of the clip within the video

Required range: 0 <= x <= 9007199254740991
Example:

2

Response

OK

Response shape for a single clip

clip
object
required

A section of a video