---
title: "Update a caption"
method: PATCH
path: "/videos/{videoId}/captions/{language}"
tags: ["Captions"]
---

# Update a caption

`PATCH /videos/{videoId}/captions/{language}`

Update caption settings.

## Path parameters

- `videoId` string, required
- `language` string, required

## Request body

- CaptionsUpdatePayload
  - `default` boolean — Set this parameter to `true` to define a caption as the default for a video.

## Response `200`

Success

- Caption
  - `uri` string — The unique resource identifier of the uploaded caption.
  - `src` string — A direct URL to the uploaded caption file.
  - `srclang` string — Indicates the language of the uploaded caption file using IETF language tags.
  - `languageName` string — Returns the native name of the caption language in UTF-8 encoding.
  - `default` boolean — Whether you will have subtitles or not. True for yes you will have subtitles, false for no you will not have subtitles.

## Other responses

- `400` — Bad request error
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/apivideo/apis/api-video.md) · [All operations](https://skmtc.net/apivideo/apis/api-video/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apivideo/api-video/revisions/45ec26f342b6/schema)