# Upload

File upload and managed storage

## Endpoints

### GET /api/v1/managed/stats

Get managed storage statistics GET /api/managed/stats

**Authentication:** Required (Bearer JWT)

#### Responses

| Status | Description                |
| ------ | -------------------------- |
| 200    | Managed storage statistics |
| 401    | Unauthorized               |
| 500    | Internal server error      |

---

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

Download a managed file GET /api/media/{id}/download

**Authentication:** Required (Bearer JWT)

#### Parameters

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

#### Responses

| Status | Description  |
| ------ | ------------ |
| 200    | File content |
| 400    | Bad request  |
| 401    | Unauthorized |
| 404    | Not found    |

---

### POST /api/v1/media/{id}/move-to-managed

Migrate an external file to managed storage POST /api/media/{id}/move-to-managed

**Authentication:** Required (Bearer JWT)

#### Parameters

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

#### Responses

| Status | Description           |
| ------ | --------------------- |
| 204    | File migrated         |
| 400    | Bad request           |
| 401    | Unauthorized          |
| 500    | Internal server error |

---

### POST /api/v1/upload

Upload a file to managed storage POST /api/upload

**Authentication:** Required (Bearer JWT)

#### Responses

| Status | Description           |
| ------ | --------------------- |
| 200    | File uploaded         |
| 400    | Bad request           |
| 401    | Unauthorized          |
| 500    | Internal server error |

---