---
title: "Fix caption words or colour"
method: POST
path: "/videos/{id}/captions"
---

# Fix caption words or colour

`POST /videos/{id}/captions`

## Request

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

Fix caption words or the key-word colour of a finished video, without a new edit; timing never moves. Either rewrite lines (from, to, text from get_project_context captions) or swap words everywhere with replace: [{ heard, spelled }] (brand names, people). A swapped name is also remembered for later videos. Each spoken word keeps a caption word, so a 2-word name cannot become 1 word here: use remember plus revise_video. Free; 5 a day per video. Cost: Free: no credits and no change round. Same as the MCP tool fix_captions.

## Path parameters

- `id` string, required

## Request body

- object
  - `lines` object[]: The caption lines to rewrite, from get_project_context captions (from, to, text).
    - `from` integer, required
    - `to` integer, required
    - `text` string, required
  - `replace` object[]: Swap words everywhere they appear, e.g. a brand name: [{ heard: "Clip Mint", spelled: "ClipMint" }].
    - `heard` string, required: The words as the captions show them.
    - `spelled` string, required: How they should read.
  - `color` string: The key words' colour.
  - `base_version` string
  - `operation_id` string: A stable ID for this request. Preserve it on retries. Use a new ID only for a deliberate new request.

## Response `200`

Fix caption words or colour

- Result: The tool result, as the MCP tool of the same name returns it.

## 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)