Files
bookhoard/docs/developer/api/collections/delete_shelf_mapping.md
T
john-okeefe 4d321528b2 docs: update comprehensive API documentation and project guides
This commit updates all documentation files throughout the project:

- Updated IMPLEMENTATION_PLAN.md with new implementation details
- Updated PROJECT_GUIDELINES.md with coding standards and practices
- Updated README.md with current project information
- Updated SCREENSHOT_AUTOMATION.md with new automation details
- Added TEST_DATA.md with test fixtures data
- Updated cover_image_serving_plan.md with static URL patterns

Documentation API updates:
- Updated API reference documentation for all endpoints including:
  - Authentication (login, logout, register, refresh_token)
  - Book matching (auto_link, bulk_link, link_book, search)
  - Collections (CRUD operations, shelf mappings, auto-assign rules)
  - Conflicts (bulk operations, resolve/dismiss)
  - Devices (registration, approval, shelf management)
  - Highlights (create, update, delete, get)
  - Kobo sync (bookmark, markup, initialization, sync)
  - KOReader sync (library, metadata, bookmarks, progress)
  - Libraries (CRUD, folders, media items, stats)
  - Media items (bulk operations, CRUD)
  - Notes (CRUD operations)
  - OPDS (acquisition, feeds, publication)
  - Progress (reading progress tracking)
  - Queue (device queue management)
  - Ratings (star ratings)
  - Scanner (watch mode, scan operations)
  - Sync protocols (Kobo, KOReader)
  - Users (profile, password, admin operations)
  - WebSocket protocols

- Updated user guides (admin, dashboard, settings, sync)
- Updated device setup guides (Kobo, KOReader)
- Updated developer guides (testing, contributing, operations)
- Updated scripts/README.md
2026-02-27 17:06:22 -05:00

1002 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