0 Fork 0

Files

T

John O'Keefe 6f13dc2b63 docs(media-items core): Beam WO5 batch 4 — 12 endpoints backfilled, registry pinned

Beam backfilled list/get/create/update/delete media-item, search, ratings
CRUD, progress GET/PUT. Beam correctly identified create/update/delete as
jwt+admin (admin group in the router — verified).

Claude registry: 12 entries. Notable pins:
- get_media_item: hand-built ~44-key map pinned verbatim from the handler
- create/update return the full database.MediaItems row (74 columns) —
  examples merged up to the real shape via gate-driven merge script
- search returns []SearchMediaItemsRow (sqlc row — Real type pinned)
- rating scale is 1-10 int (odd = half-star); GET returns {rating: null} when
  absent; update reuses the create handler (201)
- progress GET: 25 base keys + 4 CONDITIONAL position-authority keys
  (css_selector/anchor_href/char_offset/context_text — added by the handler
  for convertible formats with a valid CFI); PUT progress binds
  sync.SaveProgressRequest and returns database.ReadingProgress
- Beam's examples were missing entirely on 4 files (list/search/progress
  GET/PUT) — relabeled existing fences or inserted contract-shaped blocks

Gate-driven merge scripts (object + array variants) brought all examples to
the exact handler key sets. make test 9/9.

2026-10-24 16:09:38 -04:00

1.0 KiB

Raw Blame History

method, path, auth, area

method	path	auth	area
DELETE	/api/media-items/:id	jwt+admin	media-items

Delete Media Item

Delete a media item from the library (Admin only).

Endpoint: DELETE /api/media-items/{media_id} Auth: Required (Admin only)

Path Parameters

Parameter	Type	Required	Description
media_id	string	Yes	Media item UUID

Request Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer token

Example Request

DELETE /api/media-items/uuid-here
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Response (204 No Content)

Media item deleted successfully.

Error Responses

Code	Description
401	Invalid or expired token
403	User is not an admin
404	Media item not found

1.0 KiB Raw Blame History