docs(media-items): Work Order 3 batch 3b — management endpoints (8)

New frontmatter'd docs:
- download (ServeFile — raw bytes, family-lens enforced; corrects the old
  download doc's claim that no download route is registered: ServeFile IS
  routed, DownloadBook is the dead code)
- set_audio_speed (speed range 0.25-4.0, NaN/Inf rejected)
- rescan (abridged example over the full 70+-column row; write-after-success
  guarantee noted)
- purge-archived (destructive, admin), unarchive (204), merge (SHA-256
  precondition, per-user collisions keep active copy)
- facets (two modes: facet+values, field autocomplete counts)
- filter_count (family lens)

Registry: RawMessage pins for map/abridged responses; Schema{} for non-JSON
body routes (download = raw bytes; unarchive = 204). Audit now:
missing docs down to ~55 (from 112), 0 orphans.
This commit is contained in:
John O'Keefe committed 2026-10-24 15:06:23 -04:00
1 parent ed0ce5d077
commit 4a6fb033cb
9 files changed
+307

No files matched your search

@@ -0,0 +1,20 @@
---
method: POST
path: /api/media-items/:id/unarchive
auth: jwt+admin
area: media-items
---
<!-- source: internal/handlers/media.go:1646 MediaHandler.UnarchiveMediaItem -->
# Unarchive Media Item
**Admin only.** Clears the archive flag from a media item so it re-enters the
active library. Success is **204 No Content** — no body.
## Errors
| Status | Body | When |
| ------ | ---- | ---- |
| 400 | `{"error": "invalid media item id"}` | malformed id |
| 403 | `{"error": "admin access required"}` | not an admin |
| 500 | `{"error": "..."}` | unexpected server error |