0 Fork 0

Files

T

John O'Keefe 7a7b2ab82a docs(highlights,notes,opds,progress,analytics): Beam batch 9 — 13 endpoints

Highlights + notes CRUD (media-item scoped, jwt), progress delete,
reading-stats analytics, and the OPDS trio frontmatter'd. OPDS docs are
the first XML entries: example-response intentionally omitted (Atom
responses), gate contract honored via nil-Response registry pins.

Gate fix: group .Use() middleware now parsed (opds.Use(DeviceAuth...
Authenticate) previously resolved to auth 'none'). Registry: 13 entries.
Drift fixed by gate: reading-stats key names (total_reading_time_minutes,
most_active_day_of_week, daily_reading_minutes — draft invented
reading_time_hours/books_completed); notes/highlights list endpoints
return BARE arrays (no {notes:[]}/{highlights:[]} wrapper); create-note
request has no percentage_location/epubcfi_location. New
/tmp/merge_arrays.py handles array-example merges.

make test 9/9.

2026-10-24 17:47:07 -04:00

1.1 KiB

Raw Blame History

method, path, auth, area

method	path	auth	area
DELETE	/api/media-items/:id/highlights/:highlightId	jwt	media-items

Delete Highlight

Delete a highlight.

Endpoint: DELETE /api/media-items/:id/highlights/:highlightId Auth: Required

Path Parameters

Parameter	Type	Required	Description
highlight_id	string	Yes	Highlight UUID

Request Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer token

Example Request

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

Response (204 No Content)

Highlight deleted successfully.

Error Responses

Code	Description
401	Invalid or expired token
403	User does not own this highlight
404	Highlight not found

1.1 KiB Raw Blame History