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

# Upload an external subtitle file.

`POST /Videos/{itemId}/Subtitles`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/Videos/{itemId}/Subtitles`
- Auth: none declared
- TypeScript: <https://skmtc.dev/jellyfin/apis/jellyfin-api/docs/Videos/:itemId/Subtitles/post.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/jellyfin/apis/jellyfin-api.md) - [All operations](https://skmtc.dev/jellyfin/apis/jellyfin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jellyfin/apis/jellyfin-api/revisions/eb6f75af7066?raw)