docs: auto-generate API route documentation

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: Id0d1f9769b7ccdbf83d5fa78adef62e46a6a6964

docs/api/upload.md

@@ -0,0 +1,89 @@
+# 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 |
+
+---
+