John O'Keefe
e21e1facde
All remaining endpoint docs frontmatter'd: media-item bulk ops + audio surface, collections book-listing/preview, koreader rating/review/stats plugin protocol, hash-conflicts JSON list. Scope call (Claude): resolve_hash_conflict.md DELETED — the resolve POST renders an htmx fragment (renderResolved), a web-admin flow under rule 3; only the GET list is a JSON API. update_media_review skipped by Beam (correct): ratings/upsert_media_review.md already covers the PUT. Registry: 16 entries. koreader rating/review/stats all bind koreaderBookRef (query or body) — odd=half-star rating scale; audio track endpoint serves raw bytes (ServeContent, Range) — response nil. Fixed drift: deleted_annotations doc's secondary restore/purge fences unlabeled (gate validates labeled blocks against the ONE frontmatter route); chapters example labeled. UNVERIFIED: 1 (koreader book-ref fields, push_stats). make test 9/9.
1.2 KiB
1.2 KiB
method, path, auth, area
| method | path | auth | area |
|---|---|---|---|
| DELETE | /api/devices/:id/collections/:collectionId | jwt | collections |
Delete Shelf Mapping
Remove a collection-to-shelf mapping for a device.
Endpoint: DELETE /api/devices/{deviceId}/collections/{collectionId}
Auth: Required
Content-Type: application/json
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| deviceId | string (UUID) | Yes | Device UUID |
| collectionId | string (UUID) | Yes | Collection UUID |
Response (204 No Content)
Shelf mapping deleted successfully. No response body.
Notes
- Deleting a mapping does NOT delete the collection
- Deleting a mapping does NOT delete books from the device
- It only removes the association between the collection and device shelf
Error Responses
| Code | Description |
|---|---|
| 401 | Authentication required |
| 404 | Device or collection not found |
| 500 | Internal server error |