John O'Keefe
e21e1facde
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.
1.1 KiB
1.1 KiB
method, path, auth, area
| method | path | auth | area |
|---|---|---|---|
| POST | /api/collections/bulk-add-books | jwt | collections |
Bulk Add Books
Adds books to multiple collections in one request.
Example request
{
"operations": [
{
"collection_id": "550e8400-e29b-41d4-a716-446655440000",
"book_ids": [
"660e8400-e29b-41d4-a716-446655440001"
]
}
]
}
Example response
{
"results": [],
"total": 1
}
Fields
| Field | Type | Required | Notes |
|---|---|---|---|
| operations | array | Yes | List of {collection_id, book_ids} |
| operations[].collection_id | string (uuid) | Yes | Target collection |
| operations[].book_ids | array of string (uuid) | Yes | Books to add |
Errors
| Status | Body | When |
|---|---|---|
| 400 | {"error": "Invalid request"} / {"error": "operations required"} |
malformed |
| 400 | {"error": "smart collections are rule-based..."} |
smart collection |
| 500 | {"error": "..."} |
unexpected server error |