0 Fork 0

Files

T

John O'Keefe 18084de7a6 docs(book-matching,collections): Beam batch 10 — 15 endpoints

WO3 sync internals resolved: the book-matching docs ARE the sync surface
(books/query, link-book, bulk/auto-link, unlinked-books, suggestions,
file-alias CRUD) + collections rule/test/bulk-assign/shelf-mapping
surface.

Dedupe resolved (Claude call): search_books.md declared
GET /api/books/match but its BODY documents POST /api/sync/books/query —
both routes exist and are distinct (query-param device protocol vs JSON
body plugin protocol). Repointed search_books.md frontmatter to the POST
route; get_book_matches.md keeps the GET.

Claude registry: 15 entries (one pre-existing link-book entry deduped).
Drift fixed by gate: auto-link request {confidence_threshold, limit} not
{device_id, threshold}; bulk-link link objects {unlinked_book_id,
media_item_id, confidence_score} not {device_id, book_id, ...};
responses {results,total,successful,failed}/{auto_linked,results}; added
missing example-responses (bare delete, remove-rule is_smart-after
semantics, bulk-assign per-book results). make test 9/9.

2026-10-24 17:59:27 -04:00

3.5 KiB

Raw Blame History

method, path, auth, area

method	path	auth	area
POST	/api/collections/:id/rules	jwt	collections

Add Auto-Assign Rule

Add an automatic book assignment rule to a collection.

Endpoint: POST /api/collections/{id}/rules Auth: Required Content-Type: application/json

Path Parameters

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

Request Body

Field	Type	Required	Description
field	string	Yes	Field to match on (genre, author, series, language, publisher, copyright_year, tags)
operator	string	Yes	Comparison operator (equals, not_equals, contains, not_contains, starts_with, ends_with, greater_than, less_than)
value	string/number	Yes	Value to compare against
priority	integer	No	Rule priority (1 = highest, default: 1)
enabled	boolean	No	Whether rule is active (default: true)

Supported Fields

Field	Type	Description
genre	string	Book genre
author	string	Book author
series	string	Book series name
language	string	Book language
publisher	string	Publisher name
copyright_year	number	Publication year (numeric comparison)
tags	string	Book tags

Supported Operators

Operator	Type	Description
equals	all	Exact match
not_equals	all	Not equal
contains	string	Contains substring (case-insensitive)
not_contains	string	Does not contain
starts_with	string	Starts with (case-insensitive)
ends_with	string	Ends with (case-insensitive)
greater_than	number	Greater than
less_than	number	Less than

Example Request

{
  "field": "genre",
  "operator": "equals",
  "value": "Science Fiction",
  "priority": 1,
  "enabled": true
}

Response (201 Created)

{
  "collection_id": null,
  "is_smart": null,
  "rule": null
}

Error Responses

Code	Description
400	Invalid request (validation failed)
401	Authentication required
404	Collection not found
500	Internal server error

3.5 KiB Raw Blame History