# Transcode

Video transcoding sessions

## Endpoints

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

**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    | Transcode job submitted |
| 400    | Bad request             |
| 401    | Unauthorized            |
| 500    | Internal server error   |

---

### GET /api/v1/transcode

**Authentication:** Required (Bearer JWT)

#### Responses

| Status | Description                |
| ------ | -------------------------- |
| 200    | List of transcode sessions |
| 401    | Unauthorized               |

---

### GET /api/v1/transcode/{id}

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In   | Required | Description          |
| ---- | ---- | -------- | -------------------- |
| `id` | path | Yes      | Transcode session ID |

#### Responses

| Status | Description               |
| ------ | ------------------------- |
| 200    | Transcode session details |
| 401    | Unauthorized              |
| 404    | Not found                 |

---

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

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In   | Required | Description          |
| ---- | ---- | -------- | -------------------- |
| `id` | path | Yes      | Transcode session ID |

#### Responses

| Status | Description                 |
| ------ | --------------------------- |
| 200    | Transcode session cancelled |
| 401    | Unauthorized                |
| 404    | Not found                   |

---