Files

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

830 B

Raw Blame History

Delete Media Item

Delete a media item from the library (Admin only).

Endpoint: DELETE /api/media-items/{media_id} Auth: Required (Admin only)

Path Parameters

Parameter	Type	Required	Description
media_id	string	Yes	Media item UUID

Request Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer token

Example Request

DELETE /api/media-items/uuid-here
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Response (204 No Content)

Media item deleted successfully.

Error Responses

Code	Description
401	Invalid or expired token
403	User is not an admin
404	Media item not found

830 B Raw Blame History