Clips

Add a clip from an uploaded source

Add a new clip to a video. Create a source via POST /v1/sources, PUT the bytes, then pass the returned sourceId here.

post/v1/videos/{id}/clips

Path parameters

idstring required

Video identifier

Example:vid_abc123def456

Video identifier

Request body

namestring

Clip name. Defaults to the next Clip N.

sourceIdstring required

Source ID from POST /v1/sources.

Example request

{
  "name": "Intro"
}

Response

Example response

{
  "clip": {
    "animatedCursor": true,
    "background": {
      "color": "#000000ff",
      "gradientAngle": 45,
      "gradientColor1": "#ff0080ff",
      "gradientColor2": "#7928caff",
      "sourceId": "su_abc123",
      "type": "solid",
      "videoDurationSeconds": 12.4
    },
    "createdAt": "2026-01-15T10:30:00.000Z",
    "cuts": [
      {
        "durationMs": 750,
        "startTimeMs": 1500
      }
    ],
    "durationSeconds": 12.5,
    "id": "cl_xyz789ghi012",
    "layoutSceneType": "combi",
    "maxDurationSeconds": 14.2,
    "microphoneVolume": 0.4,
    "name": "Intro",
    "transition": "default",
    "updatedAt": "2026-01-15T14:45:00.000Z",
    "videoId": "vid_abc123def456"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.