---
title: "Upload an external subtitle file."
method: POST
path: "/Videos/{itemId}/Subtitles"
tags: ["Subtitle"]
---

# Upload an external subtitle file.

`POST /Videos/{itemId}/Subtitles`

## Path parameters

- `itemId` string, uuid, required — The item the subtitle belongs to.

## Request body

- UploadSubtitleDto — Upload subtitles dto.
  - `Language` string, required — Gets or sets the subtitle language.
  - `Format` string, required — Gets or sets the subtitle format.
  - `IsForced` boolean, required — Gets or sets a value indicating whether the subtitle is forced.
  - `Data` string, required — Gets or sets the subtitle data.

## Response `204`

Subtitle uploaded.

---

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