net.olamaelcu.livtet.biblio.status.set

Upsert a bookStatus. Metadata is merged, createdAt survives an update, updatedAt is bumped.

Details · procedure
Kindprocedure
Authoritystatus.biblio.livtet.olamaelcu.net
Indexed

Procedure

procedure · POST

Input

application/json

book

requiredref

The catalog edition this status belongs to.

metadata

object

Optional progress metadata. `status` is taken from the top-level field.

shelf

string · at-uri

Optional shelf record URI to file the status under.

status

requiredstring

Reading status for the edition.

  • knownValues: to-read | reading | read | dnf

Output

application/json

status

requiredstring

The status that was written.

uri

requiredstring · at-uri

AT-URI of the bookStatus record.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Put a book on a shelf. The shelfItem rkey is <shelf rkey>-<edition rkey>, so the same pair always lands on the same record.

  • A reading status change event for a book. Records are append-only and timestamped — each status transition creates a new record rather than mutating an existing one. The current status of a book is derived by taking the most recent status record (by createdAt) referencing that book.

  • Where the reader stands with a Work. One per Work: the record key is the Work's Catalog identifier. Exists with or without a Copy. No record means unread.