Files
bookhoard/docs/developer/api/book-matching/delete_device_file_alias.md
T
John O'Keefe 18084de7a6 docs(book-matching,collections): Beam batch 10 — 15 endpoints
WO3 sync internals resolved: the book-matching docs ARE the sync surface
(books/query, link-book, bulk/auto-link, unlinked-books, suggestions,
file-alias CRUD) + collections rule/test/bulk-assign/shelf-mapping
surface.

Dedupe resolved (Claude call): search_books.md declared
GET /api/books/match but its BODY documents POST /api/sync/books/query —
both routes exist and are distinct (query-param device protocol vs JSON
body plugin protocol). Repointed search_books.md frontmatter to the POST
route; get_book_matches.md keeps the GET.

Claude registry: 15 entries (one pre-existing link-book entry deduped).
Drift fixed by gate: auto-link request {confidence_threshold, limit} not
{device_id, threshold}; bulk-link link objects {unlinked_book_id,
media_item_id, confidence_score} not {device_id, book_id, ...};
responses {results,total,successful,failed}/{auto_linked,results}; added
missing example-responses (bare delete, remove-rule is_smart-after
semantics, bulk-assign per-book results). make test 9/9.
2026-10-24 17:59:27 -04:00

1.3 KiB

method, path, auth, area
method path auth area
DELETE /api/devices/:id/file-aliases/:aliasId jwt book-matching

Delete Device File Alias

Delete a device file alias.

Endpoint: DELETE /api/devices/:id/file-aliases/:aliasId Auth: Required

Path Parameters

Parameter Type Required Description
id string (UUID) Yes Device UUID
aliasId string (UUID) Yes File alias UUID

Request Headers

Header Type Required Description
Authorization string Yes Bearer token

Example Request

DELETE /api/devices/550e8400-e29b-41d4-a716-446655440000/file-aliases/660e8400-e29b-41d4-a716-446655440001
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Response (204 No Content)

File alias deleted successfully.

{
  "message": "File alias deleted successfully"
}

Error Responses

Code Description
401 Invalid or expired token
404 Device or file alias not found