Files
bookhoard/docs/developer/api/collections/delete_shelf_mapping.md
T
john-okeefe 253f56399d docs: restructure documentation into audience-based portals
BREAKING CHANGE: Documentation URLs have changed

New structure:
- user/ - End-user documentation (device setup, sync guides, frontend)
- developer/ - Developer documentation (API reference, protocols, specs)
- operations/ - Operations documentation (deployment, troubleshooting)
- contributing/ - Contribution guides

Changes:
- Created portal INDEX.md files for each audience section
- Moved device guides to user/devices/ (kobo-setup.md, koreader-setup.md)
- Moved API docs to developer/ (api-reference.md, collections-api.md)
- Moved sync guide to user/sync-guide.md
- Moved troubleshooting to operations/troubleshooting.md
- Moved all split API docs to developer/api/
- Renamed protocol files (kobo-protocol.md, koreader-protocol.md)
- Added placeholder user guides (frontend, user-areas, settings, admin)
- Updated all internal links to new paths
- Updated Go code (http_handler.go, navigation.go) for new paths
- Updated main INDEX.md for audience-based navigation

Benefits:
- Clear separation of user and developer documentation
- Scalable structure for future user guide expansion
- Better organization and discoverability
- Audience-specific landing pages

Related to DOCS_IMPLEMENTATION_PLAN.md Phase 2 completion
2026-02-02 15:58:34 -05:00

896 B

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