WIwithchima
Clips

Add a clip from an uploaded source

Changed on

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

Request

Path parameters

idstring required

Video identifier

Example:vid_abc123def456

Request body

namestring

Clip name. Defaults to the next Clip N.

sourceIdstring required

Source ID from POST /v1/sources.

Example request

{
  "name": "Intro"
}

Response

OK

Example response

{
  "clip": {
    "animatedCursor": true,
    "background": {
      "color": "#000000ff",
      "gradientAngle": 45,
      "gradientColor1": "#ff0080ff",
      "gradientColor2": "#7928caff",
      "shaderGradientPreset": "Halo",
      "sourceId": "su_abc123",
      "type": "solid",
      "videoDurationSeconds": 12.4
    },
    "borderStyle": "subtle-shadow",
    "cameraFocusPoint": {
      "xPct": 50,
      "yPct": 35
    },
    "corners": "regular",
    "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

  • 5caf72ed8935Revision changes
    • info

      added the optional property / to the response with the status

  • 12b6eccbb321Revision changes
    • warning

      added the new ambient enum value to the // response property for the response status

    • info

      added the optional property // to the response with the status