> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.videogen.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.videogen.io/_mcp/server.

# Edit a video

POST https://api.videogen.io/v1/projects/{projectId}/videos/{editableVideoId}/edits
Content-Type: application/json

Apply a bounded batch of typed immediate edits to this specific editable video, or start one background edit on it. Supply the inspected expectedRevision and a fresh mutationId UUID. Retry the same request unchanged to recover its original receipt. Immediate edits save at once and do not generate media or export. A background command (logo, transitions, zoom, transcript cleanup, image animation or restyle, upscale, narrator change, stock shuffle, generated music, translation, added or draft media, or a tool on one asset) must be sent alone. It returns outcome STARTED with a videoEditId to follow through GET /v1/projects/\{projectId}/video-edits. Paid background commands spend credits.

Reference: https://docs.videogen.io/rest-api-reference/projects/edit-video

## Authentication

- `Authorization` header (bearer token, required) — API key from [app.videogen.io/api](https://app.videogen.io/api). The full key is only shown once when you create it.

## Request

### Path parameters

- `projectId` (string, required)
- `editableVideoId` (string, required)

### Body (application/json)

This endpoint expects an EditVideoCommandsRequest.

- `mode` ("COMMANDS", required)
- `mutationId` (string, required)
- `expectedRevision` (integer, required)
- `commands` (list of EditVideoCommandsRequestCommandsItems, required) — Immediate commands save together. A background command (logo, transitions, zoom, transcript cleanup, generation, translation, added or draft media, asset tools) must be the only command in its request and starts a background task.

## Response

### 200

Current authorized result.

- `projectId` (string, required)
- `mutationId` (string, required)
- `outcome` (enum, required)
  - Allowed values: `APPLIED`, `NO_OP`, `CONFLICT`, `STARTED`
- `projectRevision` (integer, required)
- `editableVideoId` (string, optional)
- `videoEditId` (string, optional) — Present when outcome is STARTED. Follow this id in GET /v1/projects/\{projectId}/video-edits.

## Types

### EditVideoCommandsRequestCommandsItems

- EditVideoCommandsRequestCommandsItems0
- EditVideoCommandsRequestCommandsItems1
- EditVideoCommandsRequestCommandsItems2
- EditVideoCommandsRequestCommandsItems3
- EditVideoCommandsRequestCommandsItems4
- EditVideoCommandsRequestCommandsItems5
- EditVideoCommandsRequestCommandsItems6
- EditVideoCommandsRequestCommandsItems7
- EditVideoCommandsRequestCommandsItems8
- EditVideoCommandsRequestCommandsItems9
- EditVideoCommandsRequestCommandsItems10
- EditVideoCommandsRequestCommandsItems11
- EditVideoCommandsRequestCommandsItems12
- EditVideoCommandsRequestCommandsItems13
- EditVideoCommandsRequestCommandsItems14
- EditVideoCommandsRequestCommandsItems15
- EditVideoCommandsRequestCommandsItems16
- EditVideoCommandsRequestCommandsItems17
- EditVideoCommandsRequestCommandsItems18
- EditVideoCommandsRequestCommandsItems19
- EditVideoCommandsRequestCommandsItems20
- EditVideoCommandsRequestCommandsItems21
- EditVideoCommandsRequestCommandsItems22
- EditVideoCommandsRequestCommandsItems23
- EditVideoCommandsRequestCommandsItems24
- EditVideoCommandsRequestCommandsItems25
- EditVideoCommandsRequestCommandsItems26
- EditVideoCommandsRequestCommandsItems27
- EditVideoCommandsRequestCommandsItems28
- EditVideoCommandsRequestCommandsItems29
- EditVideoCommandsRequestCommandsItems30
- EditVideoCommandsRequestCommandsItems31
- EditVideoCommandsRequestCommandsItems32
- EditVideoCommandsRequestCommandsItems33
- EditVideoCommandsRequestCommandsItems34
- EditVideoCommandsRequestCommandsItems35
- EditVideoCommandsRequestCommandsItems36
- EditVideoCommandsRequestCommandsItems37
- EditVideoCommandsRequestCommandsItems38
- EditVideoCommandsRequestCommandsItems39
- EditVideoCommandsRequestCommandsItems40
- EditVideoCommandsRequestCommandsItems41
- EditVideoCommandsRequestCommandsItems42
- EditVideoCommandsRequestCommandsItems43
- EditVideoCommandsRequestCommandsItems44
- EditVideoCommandsRequestCommandsItems45
- EditVideoCommandsRequestCommandsItems46
- EditVideoCommandsRequestCommandsItems47
- EditVideoCommandsRequestCommandsItems48
- EditVideoCommandsRequestCommandsItems49
- EditVideoCommandsRequestCommandsItems50
- EditVideoCommandsRequestCommandsItems51
- EditVideoCommandsRequestCommandsItems52
- EditVideoCommandsRequestCommandsItems53
- EditVideoCommandsRequestCommandsItems54
- EditVideoCommandsRequestCommandsItems55
- EditVideoCommandsRequestCommandsItems56
- EditVideoCommandsRequestCommandsItems57
- EditVideoCommandsRequestCommandsItems58
- EditVideoCommandsRequestCommandsItems59
- EditVideoCommandsRequestCommandsItems60
- EditVideoCommandsRequestCommandsItems61
- EditVideoCommandsRequestCommandsItems62
- EditVideoCommandsRequestCommandsItems63
- EditVideoCommandsRequestCommandsItems64

### EditVideoCommandsRequestCommandsItems0

- `type` ("SET_CAPTION_WORD", required)
- `assetId` (string, required)
- `chunkIndex` (integer, required)
- `wordIndex` (integer, required)
- `expectedText` (string, required)
- `text` (string, required)

### EditVideoCommandsRequestCommandsItems1

- `type` ("INSERT_SECTION", required)
- `atIndex` (integer, required)
- `name` (string, required)
- `durationSeconds` (double, required)

### EditVideoCommandsRequestCommandsItems2

- `type` ("ADD_TEXT", required)
- `sectionId` (string, required)
- `text` (string, required)
- `position` (EditVideoCommandsRequestCommandsItemsOneOf2Position, optional)

### EditVideoCommandsRequestCommandsItems3

- `type` ("SET_SECTION_SUMMARY", required)
- `sectionId` (string, required)
- `summary` (string, required)

### EditVideoCommandsRequestCommandsItems4

- `type` ("SET_SECTION_VOICEOVER", required)
- `sectionId` (string, required)
- `text` (string, required)

### EditVideoCommandsRequestCommandsItems5

- `type` ("SET_SECTION_DIRECTION", required)
- `sectionId` (string, required)
- `direction` (string, required)

### EditVideoCommandsRequestCommandsItems6

- `type` ("SET_SECTION_SPEECH_VOLUME", required)
- `sectionId` (string, required)
- `volume` (double, required)

### EditVideoCommandsRequestCommandsItems7

- `type` ("SET_SECTION_VOICE_SPEED", required)
- `sectionId` (string, required)
- `speed` (double, required)

### EditVideoCommandsRequestCommandsItems8

- `type` ("SET_SECTION_SOURCE_TRIM", required)
- `sectionId` (string, required)
- `startSeconds` (double, required)
- `endSeconds` (double, required, nullable)

### EditVideoCommandsRequestCommandsItems9

- `type` ("REPLACE_ASSET_MEDIA", required)
- `assetId` (string, required)
- `fileId` (string, required)

### EditVideoCommandsRequestCommandsItems10

- `type` ("ADD_BACKGROUND_MUSIC", required)
- `fileId` (string, required)
- `volume` (double, required)

### EditVideoCommandsRequestCommandsItems11

- `type` ("MOVE_ASSET", required)
- `assetId` (string, required)
- `destinationLayerId` (string, required)
- `timeSeconds` (double, required) — Destination time in seconds from the start of this editable video.
- `ripple` (boolean, required)

### EditVideoCommandsRequestCommandsItems12

- `type` ("SET_ASSET_BORDER", required)
- `assetId` (string, required)
- `border` (EditVideoCommandsRequestCommandsItemsOneOf12Border, required, nullable)

### EditVideoCommandsRequestCommandsItems13

- `type` ("SET_ASSET_BORDER_RADIUS", required)
- `assetId` (string, required)
- `radii` (EditVideoCommandsRequestCommandsItemsOneOf13Radii, required, nullable)

### EditVideoCommandsRequestCommandsItems14

- `type` ("SET_ASSET_TEXT_STYLE", required)
- `assetId` (string, required)
- `style` (EditVideoCommandsRequestCommandsItemsOneOf14Style, required)

### EditVideoCommandsRequestCommandsItems15

- `type` ("SET_ASSET_FILTERS", required)
- `assetId` (string, required)
- `filters` (list of EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems, required)

### EditVideoCommandsRequestCommandsItems16

- `type` ("SET_SHAPE_FILL", required)
- `assetId` (string, required)
- `color` (string, required)
- `alpha` (double, required)

### EditVideoCommandsRequestCommandsItems17

- `type` ("SET_SVG_COLORS", required)
- `assetId` (string, required)
- `overrides` (map from string to string, required, nullable)

### EditVideoCommandsRequestCommandsItems18

- `type` ("SET_ASSET_AUDIO_FADE", required)
- `assetId` (string, required)
- `phase` (enum, required)
  - Allowed values: `ENTER`, `EXIT`
- `durationSeconds` (double, required, nullable)

### EditVideoCommandsRequestCommandsItems19

- `type` ("SET_ASPECT_RATIO", required)
- `width` (integer, required)
- `height` (integer, required)

### EditVideoCommandsRequestCommandsItems20

- `type` ("SET_SECTION_TRANSITION", required)
- `sectionId` (string, required)
- `style` (enum, required)
  - Allowed values: `NONE`, `FADE`, `RISE`, `PAN`, `POP`, `WIPE`
- `durationSeconds` (double, required)

### EditVideoCommandsRequestCommandsItems21

- `type` ("SET_ASSET_TRANSITION", required)
- `assetId` (string, required)
- `style` (enum, required)
  - Allowed values: `NONE`, `FADE`, `RISE`, `PAN`, `POP`, `WIPE`
- `durationSeconds` (double, required)

### EditVideoCommandsRequestCommandsItems22

- `type` ("SET_ASSET_ANIMATION", required)
- `assetId` (string, required)
- `phase` (enum, required)
  - Allowed values: `ENTER`, `EXIT`
- `style` (enum, required)
  - Allowed values: `NONE`, `FADE`, `SLIDE`
- `durationSeconds` (double, required)

### EditVideoCommandsRequestCommandsItems23

- `type` ("SET_ASSET_PLAYBACK", required)
- `assetId` (string, required)
- `playback` (enum, required)
  - Allowed values: `CONTROLLED`, `STRETCH`

### EditVideoCommandsRequestCommandsItems24

- `type` ("SET_CAPTIONS", required)
- `enabled` (boolean, required)

### EditVideoCommandsRequestCommandsItems25

- `type` ("SET_ASSET_CAPTIONS", required)
- `assetId` (string, required)
- `enabled` (boolean, required)

### EditVideoCommandsRequestCommandsItems26

- `type` ("SET_ASSET_LOCKED", required)
- `assetId` (string, required)
- `locked` (boolean, required)

### EditVideoCommandsRequestCommandsItems27

- `type` ("SET_ASSET_VOLUME", required)
- `assetId` (string, required)
- `volume` (double, required)

### EditVideoCommandsRequestCommandsItems28

- `type` ("SET_ASSET_OPACITY", required)
- `assetId` (string, required)
- `opacityPercent` (double, required)

### EditVideoCommandsRequestCommandsItems29

- `type` ("SET_ASSET_POSITION", required)
- `assetId` (string, required)
- `position` (EditVideoCommandsRequestCommandsItemsOneOf29Position, required)

### EditVideoCommandsRequestCommandsItems30

- `type` ("SET_ASSET_CROP", required)
- `assetId` (string, required)
- `crop` (EditVideoCommandsRequestCommandsItemsOneOf30Crop, required, nullable)

### EditVideoCommandsRequestCommandsItems31

- `type` ("SET_ASSET_PLAYBACK_RATE", required)
- `assetId` (string, required)
- `rate` (double, required)

### EditVideoCommandsRequestCommandsItems32

- `type` ("SET_ASSET_TRIM", required)
- `assetId` (string, required)
- `startSeconds` (double, required)
- `endSeconds` (double, required, nullable)

### EditVideoCommandsRequestCommandsItems33

- `type` ("SET_ASSET_TTS_TEXT", required)
- `assetId` (string, required)
- `text` (string, required)

### EditVideoCommandsRequestCommandsItems34

- `type` ("SET_ASSET_TTS_ENABLED", required)
- `assetId` (string, required)
- `enabled` (boolean, required)

### EditVideoCommandsRequestCommandsItems35

- `type` ("SET_TEXT", required)
- `assetId` (string, required)
- `text` (string, required)

### EditVideoCommandsRequestCommandsItems36

- `type` ("SET_ASSET_FIT", required)
- `assetId` (string, required)
- `fit` (enum, required)
  - Allowed values: `COVER`, `CONTAIN`

### EditVideoCommandsRequestCommandsItems37

- `type` ("DELETE_ASSET", required)
- `assetId` (string, required)

### EditVideoCommandsRequestCommandsItems38

- `type` ("DELETE_SECTION", required)
- `sectionId` (string, required)

### EditVideoCommandsRequestCommandsItems39

- `type` ("DUPLICATE_SECTION", required)
- `sectionId` (string, required)

### EditVideoCommandsRequestCommandsItems40

- `type` ("SET_SECTION_NAME", required)
- `sectionId` (string, required)
- `name` (string, required)

### EditVideoCommandsRequestCommandsItems41

- `type` ("SET_SECTION_DESCRIPTION", required)
- `sectionId` (string, required)
- `description` (string, required)

### EditVideoCommandsRequestCommandsItems42

- `type` ("SET_SECTION_DURATION", required)
- `sectionId` (string, required)
- `durationSeconds` (double, required)
- `strategy` (enum, required)
  - Allowed values: `SCALE_ALL`, `TRIM_END`

### EditVideoCommandsRequestCommandsItems43

- `type` ("REORDER_SECTIONS", required)
- `sectionIds` (list of string, required)

### EditVideoCommandsRequestCommandsItems44

- `type` ("DELETE_LAYER", required)
- `layerId` (string, required)

### EditVideoCommandsRequestCommandsItems45

- `type` ("SPLIT_LAYER", required)
- `layerId` (string, required)
- `timeSeconds` (double, required) — Seconds from the beginning of this editable video; must fall within the selected layer.

### EditVideoCommandsRequestCommandsItems46

- `type` ("SEND_ASSET_TO_FRONT", required)
- `assetId` (string, required)

### EditVideoCommandsRequestCommandsItems47

- `type` ("SEND_ASSET_TO_BACK", required)
- `assetId` (string, required)

### EditVideoCommandsRequestCommandsItems48

- `type` ("SET_CAPTION_STYLE", required)
- `style` (EditVideoCommandsRequestCommandsItemsOneOf48Style, required)

### EditVideoCommandsRequestCommandsItems49

- `type` ("SET_LOGO", required)
- `fileId` (string, required) — A file id your team can access.
- `position` (enum, required, nullable)
  - Allowed values: `TOP_LEFT`, `TOP_CENTER`, `TOP_RIGHT`, `BOTTOM_LEFT`, `BOTTOM_CENTER`, `BOTTOM_RIGHT`
- `sizePercent` (double, required, nullable)

### EditVideoCommandsRequestCommandsItems50

- `type` ("REMOVE_LOGO", required)

### EditVideoCommandsRequestCommandsItems51

- `type` ("APPLY_TRANSITIONS", required)
- `sections` (EditVideoCommandsRequestCommandsItemsOneOf51Sections, required, nullable)
- `baseLayerAssets` (EditVideoCommandsRequestCommandsItemsOneOf51BaseLayerAssets, required, nullable)

### EditVideoCommandsRequestCommandsItems52

- `type` ("ADD_ZOOM", required)

### EditVideoCommandsRequestCommandsItems53

- `type` ("CLEAN_UP_TRANSCRIPT", required)
- `removeFillers` (boolean, required)
- `removePauses` (boolean, required)
- `fillerWords` (list of string, required, nullable) — Words to treat as fillers. Null uses the default list.
- `minPauseSeconds` (double, required)

### EditVideoCommandsRequestCommandsItems54

- `type` ("CONVERT_IMAGES_TO_VIDEOS", required)
- `motionPrompt` (string, required, nullable)
- `muteOutputVideos` (boolean, required)
- `quality` (enum, required)
  - Allowed values: `LOW`, `STANDARD`, `HIGH`, `MAX`

### EditVideoCommandsRequestCommandsItems55

- `type` ("REGENERATE_IMAGES", required)
- `stylePrompt` (string, required)
- `quality` (enum, required)
  - Allowed values: `LOW`, `STANDARD`, `HIGH`, `MAX`

### EditVideoCommandsRequestCommandsItems56

- `type` ("UPSCALE_ASSETS", required)
- `includeVideos` (boolean, required)
- `includeStockContent` (boolean, required)

### EditVideoCommandsRequestCommandsItems57

- `type` ("CHANGE_NARRATOR", required)
- `voiceId` (string, required) — A voiceId from GET /v1/resources/tts-voices, or a catalog voice display name.
- `voiceSpeed` (double, required, nullable)
- `actorEntityId` (string, required, nullable)
- `avatarQuality` (enum, required, nullable) — Only with actorEntityId.
  - Allowed values: `LOW`, `STANDARD`, `HIGH`, `MAX`

### EditVideoCommandsRequestCommandsItems58

- `type` ("SHUFFLE_STOCK_VISUALS", required)

### EditVideoCommandsRequestCommandsItems59

- `type` ("GENERATE_MUSIC", required)
- `prompt` (string, required)

### EditVideoCommandsRequestCommandsItems60

- `type` ("TRANSLATE_PROJECT", required)
- `outputLanguageCode` (string, required) — ISO 639 language code, e.g. en, es, zh.
- `changeVoice` (boolean, required)
- `translateImageText` (boolean, required)
- `dubVideos` (boolean, required) — Also dub the speech in uploaded videos. Expensive: billed per second of every video with speech. When false, those videos keep their original audio and their captions are still translated.

### EditVideoCommandsRequestCommandsItems61

- `type` ("ADD_MEDIA", required)
- `sectionId` (string, required) — A sectionId from this video's inspection.
- `fileId` (string, required) — A file id your team can access.
- `startSeconds` (double, required, nullable) — Seconds from the start of the section. Null places it at the start.

### EditVideoCommandsRequestCommandsItems62

- `type` ("ADD_DRAFT_MEDIA", required)
- `sectionId` (string, required) — A sectionId from this video's inspection.
- `toolType` (enum, required)
  - Allowed values: `GENERATE_IMAGE`, `GENERATE_VIDEO_CLIP`, `GENERATE_SOUND_EFFECT`, `TEXT_TO_SPEECH`
- `prompt` (string, required, nullable)
- `durationSeconds` (double, required, nullable)
- `startSeconds` (double, required, nullable) — Seconds from the start of the section. Null places it at the start.

### EditVideoCommandsRequestCommandsItems63

- `type` ("GENERATE_DRAFT_MEDIA", required)

### EditVideoCommandsRequestCommandsItems64

- `type` ("RUN_TOOL_ON_ASSET", required)
- `assetId` (string, required) — An assetId from this video's inspection.
- `toolType` (enum, required)
  - Allowed values: `GENERATE_IMAGE`, `GENERATE_MOTION_GRAPHIC`, `GENERATE_SOUND_EFFECT`, `GENERATE_VIDEO_CLIP`, `IMAGE_3D_EFFECT`, `REMOVE_IMAGE_BACKGROUND`, `REMOVE_VIDEO_BACKGROUND`, `UPSCALE_IMAGE`, `UPSCALE_VIDEO`, `VECTORIZE_IMAGE`
- `prompt` (string, required, nullable)

### EditVideoCommandsRequestCommandsItemsOneOf2Position

- `xStartPct` (double, required)
- `xEndPct` (double, required)
- `yStartPct` (double, required)
- `yEndPct` (double, required)
- `rotationDeg` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf12Border

- `width` (double, required)
- `color` (string, required)

### EditVideoCommandsRequestCommandsItemsOneOf13Radii

- `topLeftPercent` (double, required)
- `topRightPercent` (double, required)
- `bottomLeftPercent` (double, required)
- `bottomRightPercent` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf14Style

- `fontFamily` (string, optional)
- `fontSize` (double, optional)
- `fontWeight` (EditVideoCommandsRequestCommandsItemsOneOf14StyleFontWeight, optional)
- `textColor` (string, optional)

### EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems

- EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems0
- EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems1
- EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems2
- EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems3
- EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems4
- EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems5
- EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems6

### EditVideoCommandsRequestCommandsItemsOneOf29Position

- `xStartPct` (double, required)
- `xEndPct` (double, required)
- `yStartPct` (double, required)
- `yEndPct` (double, required)
- `rotationDeg` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf30Crop

- `xStartPct` (double, required)
- `xEndPct` (double, required)
- `yStartPct` (double, required)
- `yEndPct` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf48Style

- `fontFamily` (string, optional)
- `fontSize` (double, optional)
- `fontWeight` (EditVideoCommandsRequestCommandsItemsOneOf48StyleFontWeight, optional)
- `textColor` (string, optional)

### EditVideoCommandsRequestCommandsItemsOneOf51Sections

- EditVideoCommandsRequestCommandsItemsOneOf51Sections0
- EditVideoCommandsRequestCommandsItemsOneOf51Sections1

### EditVideoCommandsRequestCommandsItemsOneOf51BaseLayerAssets

- EditVideoCommandsRequestCommandsItemsOneOf51BaseLayerAssets0
- EditVideoCommandsRequestCommandsItemsOneOf51BaseLayerAssets1

### EditVideoCommandsRequestCommandsItemsOneOf14StyleFontWeight

- double
- double
- double
- double
- double
- double
- double
- double
- double

### EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems0

- `type` ("BLUR", required)
- `amount` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems1

- `type` ("BRIGHTNESS", required)
- `amount` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems2

- `type` ("CONTRAST", required)
- `amount` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems3

- `type` ("HUE_ROTATE", required)
- `amount` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems4

- `type` ("INVERT", required)
- `amount` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems5

- `type` ("SATURATION", required)
- `amount` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf15FiltersItems6

- `type` ("SEPIA", required)
- `amount` (double, required)

### EditVideoCommandsRequestCommandsItemsOneOf48StyleFontWeight

- double
- double
- double
- double
- double
- double
- double
- double
- double

### EditVideoCommandsRequestCommandsItemsOneOf51Sections0

- `type` ("FIXED", required)
- `style` (enum, required)
  - Allowed values: `NONE`, `FADE`, `RISE`, `PAN`, `POP`, `WIPE`

### EditVideoCommandsRequestCommandsItemsOneOf51Sections1

- `type` ("DYNAMIC", required)

### EditVideoCommandsRequestCommandsItemsOneOf51BaseLayerAssets0

- `type` ("FIXED", required)
- `style` (enum, required)
  - Allowed values: `NONE`, `FADE`, `RISE`, `PAN`, `POP`, `WIPE`

### EditVideoCommandsRequestCommandsItemsOneOf51BaseLayerAssets1

- `type` ("DYNAMIC", required)

## Examples

**Request**

```json
{
  "mode": "string",
  "mutationId": "string",
  "expectedRevision": 1,
  "commands": [
    {
      "assetId": "string",
      "chunkIndex": 1,
      "expectedText": "string",
      "text": "string",
      "type": "string",
      "wordIndex": 1
    }
  ]
}
```

**Response**

```json
{
  "projectId": "string",
  "mutationId": "string",
  "outcome": "APPLIED",
  "projectRevision": 1,
  "editableVideoId": "string",
  "videoEditId": "string"
}
```

**SDK Code**

```python
import requests

url = "https://api.videogen.io/v1/projects/projectId/videos/editableVideoId/edits"

payload = {
    "mode": "string",
    "mutationId": "string",
    "expectedRevision": 1,
    "commands": [
        {
            "assetId": "string",
            "chunkIndex": 1,
            "expectedText": "string",
            "text": "string",
            "type": "string",
            "wordIndex": 1
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```