WIwithchima
Clips

Cut one or more time ranges from a clip

Changed on

Cut one or more time ranges from a clip in a single request. Pass cuts: [{fromMs, toMs}, ...] for multiple ranges or the legacy fromMs/toMs pair for a single range. Overlapping or adjacent ranges are merged into the clip's existing cuts. Zooms, blurs, highlights and overlays (text, images, media, sound effects) placed entirely on footage the cut removes are deleted with it; clearing the cuts later does not bring them back. To clear all cuts, call updateClip with cuts: [].

post/v1/videos/{id}/clips/{clipId}/cut

Request

Path parameters

idstring required

Video identifier

Example:vid_abc123def456
clipIdstring required

Clip identifier

Example:cl_xyz789ghi012

Request body

fromMsinteger

Single-range shortcut for cuts: [{fromMs, toMs}]. Use cuts for multiple ranges.

toMsinteger

Single-range shortcut for cuts: [{fromMs, toMs}]. Use cuts for multiple ranges.

Example request

{
  "cuts": [
    {
      "fromMs": 2000,
      "toMs": 3500
    }
  ],
  "fromMs": 2000,
  "toMs": 3500
}

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