---
title: "Ask for a change to a finished video in plain words"
method: POST
path: "/videos/{id}/changes"
---

# Ask for a change to a finished video in plain words

`POST /videos/{id}/changes`

## Request

- Base URL: `https://clypmint.com/api/v1`
- URL: `https://clypmint.com/api/v1/videos/{id}/changes`
- Auth: HTTP bearer

Uses an included change round, never credits. output_id selects one output. Optional voice replaces retained main scratch narration only, preserving script/edit with 'Change narrator to Brian. Keep the script and edit.' (selected name). Send other edits separately; unsupported/mixed narration changes return422.

## Path parameters

- `id` string, required

## Request body

- object
  - `change` string, required
  - `output_id` string
  - `operation_id` string
  - `base_version` string
  - `voice` 'matilda' | 'sarah' | 'jessica' | 'alice' | 'liam' | 'chris' | 'brian' | 'george' | 'roger' | 'laura' | 'charlie' | 'river' | 'will' | 'eric' | 'bella' | 'daniel' | 'lily' | 'bill' | 'adam' | 'callum' | 'harry': Retained main scratch narration only; use a voice-only change.
  - `dry_run` boolean

## Response `200`

Change requested, or why it cannot be

- Change
  - `video_id` string, required
  - `state` string
  - `progress` number
  - `ready` boolean
  - `allowed` boolean, required: False when no change rounds are left.
  - `message` string
  - `problem` string, nullable

## Other responses

- `400`: The request is invalid. The message names each field to fix.
- `401`: A valid bearer token (API key or OAuth access token) is required.
- `402`: This account has no allowance left for this, or does not include it. error.checkout_url is where to add it.
- `403`: This needs publishing permission (scope clypmint.publish), or is not open on this account yet.
- `404`: The video, upload, memory or calendar was not found in this account.
- `409`: Busy: an upload or edit is already running, the video changed, or too many upload links are waiting.
- `413`: The request body is too large.
- `422`: Clypmint could not apply it as asked; error.problems names each part.
- `429`: A daily limit was reached (direct edits, caption fixes, upload links).
- `501`: This is not available on Clypmint yet; the message says what to use instead.
- `503`: Clypmint is busy. Try again in a moment.

---

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