library-rpc

Partially update a book.

RPCbooks.update

Applies only the parameters present in the call; omitted parameters are left unchanged. The book's status cannot be changed here — it only changes via loans.borrow and loans.return, so it always reflects a real open loan.

Servers

•mock: https://mock.api.selfdochub.com/rpc

Parameters

NameInTypeRequiredDescription
idparamsstringyesThe book's unique identifier.
titleparamsstringThe book's new display title, 1-200 characters.
isbnparamsstringThe book's new ISBN. Must be unique across the catalog.
authorIdparamsstringThe id of a different existing Author to reassign this book to.
publishedYearparamsintegerThe book's new published year. Must be between 1450 and next year.

Responses

result The updated book.

application/json

FieldTypeRequiredDescription
authorIdstringyesThe id of the Author who wrote this book.
createdAtstring (date-time)yesWhen the book record was created.
idstringyesUnique identifier assigned by the server, prefixed with bk_.
isbnstringyesThe book's ISBN. Must be unique across the catalog.
publishedYearintegeryesThe year the book was first published. Must be between 1450 and next year.
statusstringyesA book's availability. "borrowed" means it is out on an open loan. Allowed values: available, borrowed
titlestringyesThe book's display title, 1-200 characters.
updatedAtstring (date-time)yesWhen the book record was last modified.

Errors

CodeMessageDescription
-32602Invalid params
-32004Not found
-32001Conflict

Request example

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "books.update",
  "params": {
    "authorId": "authorId_844",
    "id": "id_365",
    "isbn": "isbn_574",
    "publishedYear": 344,
    "title": "title_266"
  }
}

Response example

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "authorId": "authorId_433",
    "createdAt": "createdAt_317",
    "id": "id_680",
    "isbn": "isbn_361",
    "publishedYear": 260,
    "status": "available",
    "title": "title_448",
    "updatedAt": "updatedAt_871"
  }
}