Files
bookhoard/docs/developer/api/libraries/delete_library_folder.md
T
john-okeefe b44e4e4709 docs: remove Phase X placeholders from API documentation
Clean up API documentation files by removing Phase X references:

Remove 'API Explorer will be inserted here in Phase X' placeholders from:
- 70+ API endpoint documentation files
- Authentication endpoints (login, logout, register, refresh)
- User endpoints (profile, settings, password)
- Device endpoints (registration, sync, shelves)
- Library endpoints (CRUD, folders, visibility)
- Media endpoints (items, progress, highlights, notes)
- Admin endpoints (users, analytics)
- Sync endpoints (Kobo, KOReader)
- OPDS endpoints
- Scanner endpoints
- Queue endpoints

These placeholders were from planning documents and have no meaning
to API consumers. The documentation is now clean and ready for use.
2026-02-13 21:50:44 -05:00

876 B

Delete Library Folder

Delete a folder from a library.

Endpoint: DELETE /api/libraries/:id/folders Auth: Required (Admin only) Content-Type: application/json

Path Parameters

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

Request Body

Field Type Required Description
folder_path string Yes Absolute path to the folder to delete

Example Request

{
  "folder_path": "/path/to/library/folder"
}

Response (204 No Content)

Library folder deleted successfully.

Error Responses

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