0 Fork 0

Files

T

John O'Keefe e21e1facde docs(media-items,collections,koreader,admin): Beam batch 11 — final backfill

All remaining endpoint docs frontmatter'd: media-item bulk ops + audio
surface, collections book-listing/preview, koreader rating/review/stats
plugin protocol, hash-conflicts JSON list.

Scope call (Claude): resolve_hash_conflict.md DELETED — the resolve POST
renders an htmx fragment (renderResolved), a web-admin flow under rule 3;
only the GET list is a JSON API. update_media_review skipped by Beam
(correct): ratings/upsert_media_review.md already covers the PUT.

Registry: 16 entries. koreader rating/review/stats all bind
koreaderBookRef (query or body) — odd=half-star rating scale; audio track
endpoint serves raw bytes (ServeContent, Range) — response nil. Fixed
drift: deleted_annotations doc's secondary restore/purge fences
unlabeled (gate validates labeled blocks against the ONE frontmatter
route); chapters example labeled. UNVERIFIED: 1 (koreader book-ref
fields, push_stats). make test 9/9.

2026-10-24 18:21:17 -04:00

2.8 KiB

Raw Blame History

method, path, auth, area

method	path	auth	area
POST	/api/media-items/bulk-delete	jwt	media-items

Bulk Delete Media Items

Delete multiple media items at once (supports ebooks, comics, manga).

Endpoint: POST /api/media-items/bulk-delete Auth: Required Content-Type: application/json

Request Body

Field	Type	Required	Description
media_item_ids	array of UUID	Yes	Array of media item UUIDs to delete

Example Request

{
  "media_item_ids": [
    "550e8400-e29b-41d4-a716-446655440001",
    "660e8400-e29b-41d4-a716-446655440002",
    "770e8400-e29b-41d4-a716-446655440003"
  ]
}

Response (200 OK)

{
  "results": [
    {
      "media_item_id": "550e8400-e29b-41d4-a716-446655440001",
      "status": "success"
    },
    {
      "media_item_id": "660e8400-e29b-41d4-a716-446655440002",
      "status": "error",
      "error": "Media item not found"
    },
    {
      "media_item_id": "770e8400-e29b-41d4-a716-446655440003",
      "status": "success"
    }
  ],
  "total": 3,
  "deleted": 2,
  "failed": 1
}

Response Fields

Field	Type	Description
results	array	Individual result for each media item
results[].media_item_id	string	UUID of the media item
results[].status	string	"success" or "error"
results[].error	string	Error message (only present if status is "error")
total	number	Total number of media items processed
deleted	number	Number of media items successfully deleted
failed	number	Number of media items that failed to delete

Error Responses

Code	Description
400	Invalid request data or empty media_item_ids array
401	Invalid or expired token
403	User does not have permission
500	Server error during deletion

Notes

File deletion: Successfully deleted media items will also have their associated files removed from disk
Invalid UUIDs: Invalid UUID formats are counted as failures in the results array
Non-existent items: Media items that don't exist are counted as failures (not errors)
Partial success: The operation continues even if some deletions fail

2.8 KiB Raw Blame History