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.
43 lines
1.2 KiB
Markdown
43 lines
1.2 KiB
Markdown
---
|
|
method: DELETE
|
|
path: /api/devices/:id/collections/:collectionId
|
|
auth: jwt
|
|
area: collections
|
|
---
|
|
<!-- source: internal/handlers/collections.go:760 CollectionHandler.DeleteDeviceMapping -->
|
|
|
|
# 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 |
|
|
|
|
## Try It Out
|