Library

Operation	What it does
`GET /v1/library/objects`	Search every saved item, standalone note, and highlight
`GET /v1/library/objects/{ref}`	Read a saved item, standalone note, or highlight by ref
`GET /v1/library/items`	Search and filter saved library content or reading history
`POST /v1/library/items`	Save an item to the library
`PATCH /v1/library/items`	Update up to 100 library items in one request
`GET /v1/library/counts`	Count library items by status and content kind
`GET /v1/library/changes`	Incrementally sync every library mutation and deletion
`GET /v1/library/items/{id}`	Read one saved library item and its text
`PATCH /v1/library/items/{id}`	Move, tag, classify, or mark a saved item read
`DELETE /v1/library/items/{id}`	Delete a saved item
`PUT /v1/library/items/{id}/asset`	Upload or replace a library item’s original file bytes
`GET /v1/library/items/{id}/asset`	Stream a library item’s original image, audio, or file bytes
`GET /v1/library/items/{id}/content`	Read a bounded content window with a continuation cursor
`POST /v1/library/items/{id}/search`	Find relevant passages inside one saved library item

Operation

What it does

GET /v1/library/objects

Search every saved item, standalone note, and highlight

GET /v1/library/objects/{ref}

Read a saved item, standalone note, or highlight by ref

GET /v1/library/items

Search and filter saved library content or reading history

POST /v1/library/items

Save an item to the library

PATCH /v1/library/items

Update up to 100 library items in one request

GET /v1/library/counts

Count library items by status and content kind

GET /v1/library/changes

Incrementally sync every library mutation and deletion

GET /v1/library/items/{id}

Read one saved library item and its text

PATCH /v1/library/items/{id}

Move, tag, classify, or mark a saved item read

DELETE /v1/library/items/{id}

Delete a saved item

PUT /v1/library/items/{id}/asset

Upload or replace a library item’s original file bytes

GET /v1/library/items/{id}/asset

Stream a library item’s original image, audio, or file bytes

GET /v1/library/items/{id}/content

Read a bounded content window with a continuation cursor

POST /v1/library/items/{id}/search

Find relevant passages inside one saved library item

Notes and highlights are read-only here. They are created in the smry reader; there is no endpoint that makes one.