# 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 |

---