---
title: "Change Video Edit"
method: POST
path: "/v1/video-edits/{edit_id}"
---

# Change Video Edit

`POST /v1/video-edits/{edit_id}`

## Request

- Base URL: `https://api.scriptseen.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.scriptseen.com/v1/video-edits/{edit_id}`
- Auth: none declared

## Path parameters

- `edit_id` string, required

## Request body

- VideoEditBody: What the video editor card sends: its own changes to the edit.
  - `changes` Change[], required
    - `op` 'choose' | 'auto' | 'order' | 'skip' | 'use' | 'captions' | 'note' | 'clear' | 'render' | 'add_clips' | 'remove_clip' | 'move' | 'audio' | 'cut' | 'render_status' | 'handoff', required
    - `sentence` integer, nullable: Sentence number, from 1.
    - `through` integer, nullable: Last sentence of a range, inclusive.
    - `clip` union: Clip id (c1, c2, …), its number, or its exact file name.
      - string
      - integer
    - `clips` union[], nullable: For order: clip ids in order.
      - union
        - string
        - integer
    - `start_s` number, nullable: For choose: seconds into the clip to start from.
    - `on` boolean, nullable: For captions.
    - `text` string, nullable: For note: what the clip shows.
    - `add` ClipIn[], nullable
      - `name` string, required
      - `duration_ms` integer, required
      - `width` integer, nullable
      - `height` integer, nullable
    - `source` 'read' | 'file', nullable
    - `seconds` number, nullable
    - `voice` string, nullable
    - `cut` CutReport
      - `audio_ms` integer, required
      - `total_ms` integer, required
      - `shots` integer, required
      - `sentences` SentenceCut[]
        - `ms` integer, required
        - `clip` string, nullable
        - `clips` string[]
        - `chosen` boolean
        - `pace_pct` integer
        - `held` boolean
      - `notes` string[]
      - `warnings` string[]
      - `decisions` string
    - `status` 'idle' | 'requested' | 'rendering' | 'done' | 'failed' | 'cancelled', nullable
    - `progress` number, nullable
    - `bytes` integer, nullable
    - `message` string, nullable
    - `card` string, nullable
    - `by_steps` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/scriptseen/apis/scriptseen-api.md) · [All operations](https://skmtc.dev/scriptseen/apis/scriptseen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scriptseen/apis/scriptseen-api/revisions/234ca7365a93?raw)