# Subtitles

Media subtitle management

## Endpoints

### GET /api/v1/media/{id}/subtitles

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In   | Required | Description   |
| ---- | ---- | -------- | ------------- |
| `id` | path | Yes      | Media item ID |

#### Responses

| Status | Description                             |
| ------ | --------------------------------------- |
| 200    | Subtitles and available embedded tracks |
| 401    | Unauthorized                            |
| 404    | Not found                               |

---

### POST /api/v1/media/{id}/subtitles

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In   | Required | Description   |
| ---- | ---- | -------- | ------------- |
| `id` | path | Yes      | Media item ID |

#### Request Body

`Content-Type: application/json`

See `docs/api/openapi.json` for the full schema.

#### Responses

| Status | Description           |
| ------ | --------------------- |
| 200    | Subtitle added        |
| 400    | Bad request           |
| 401    | Unauthorized          |
| 500    | Internal server error |

---

### GET /api/v1/media/{media_id}/subtitles/{subtitle_id}/content

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name          | In   | Required | Description   |
| ------------- | ---- | -------- | ------------- |
| `media_id`    | path | Yes      | Media item ID |
| `subtitle_id` | path | Yes      | Subtitle ID   |

#### Responses

| Status | Description      |
| ------ | ---------------- |
| 200    | Subtitle content |
| 401    | Unauthorized     |
| 404    | Not found        |

---

### DELETE /api/v1/subtitles/{id}

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In   | Required | Description |
| ---- | ---- | -------- | ----------- |
| `id` | path | Yes      | Subtitle ID |

#### Responses

| Status | Description      |
| ------ | ---------------- |
| 200    | Subtitle deleted |
| 401    | Unauthorized     |
| 404    | Not found        |

---

### PATCH /api/v1/subtitles/{id}/offset

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In   | Required | Description |
| ---- | ---- | -------- | ----------- |
| `id` | path | Yes      | Subtitle ID |

#### Request Body

`Content-Type: application/json`

See `docs/api/openapi.json` for the full schema.

#### Responses

| Status | Description    |
| ------ | -------------- |
| 200    | Offset updated |
| 401    | Unauthorized   |
| 404    | Not found      |

---