Files
bookhoard/docs/developer/api/libraries/delete_library.md
T
John O'Keefe b77eab7ffd docs(libraries): Beam WO5 batch 5 — 11 endpoints backfilled + pilot recovery
Beam backfilled 11 library docs (CRUD, folders, visibility, browse, stats,
media-items) and re-attached frontmatter to create_collection.md — which had
silently lost its pilot version in cc893f75: the negative-test
'git checkout --' restored the OLD file because the pilot was never staged,
and a frontmatter-less doc is invisible to the gate. Claude restored the full
corrected pilot content (priority higher-wins, time.String() note, 409).

Claude registry: 11 entries + one inverted catch — DELETE /:id/folders DOES
bind {folder_path} (handler reuses AddLibraryFolderRequest); registry first
draft said bodyless. GET /:id/visibility returns joined
GetUserVisibleLibrariesRow (type_name etc.), not bare Libraries.

Gate-driven merges fixed create/get library response shapes (sqlc row keys:
created_by_admin_id, library_type_id, updated_at; dropped invented type/
folders/is_visible). Fixed invented request fields (user_id in
set-visibility; library_type_id in update). make test 9/9.
2026-10-24 16:18:48 -04:00

1.2 KiB

method, path, auth, area
method path auth area
DELETE /api/libraries/:id jwt+admin libraries

Delete Library

Delete a library and all associated data.

Endpoint: DELETE /api/libraries/:id Auth: Required (Admin only)

Path Parameters

Parameter Type Required Description
id string (UUID) Yes Library UUID

Request Headers

Header Type Required Description
Authorization string Yes Bearer token (must have admin role)

Example Request

DELETE /api/libraries/550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Response (204 No Content)

Library deleted successfully.

Error Responses

Code Description
401 Invalid or expired token
403 User does not have admin privileges
404 Library not found