Bookmarks
13 endpoints.
GET /archives/{id}/bookmarks — unpaginated, just this one archive’s bookmarked pages
Section titled “GET /archives/{id}/bookmarks — unpaginated, just this one archive’s bookmarked pages”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:479), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
GET /archives/{id}/bookmarks — unpaginated, just this one archive’s bookmarked pages
(ascending, each with its resolved filename). Used by the reader (is the current page
bookmarked? — only page matters there) and BookmarkHoverGrid (needs both page and
filename for its caption, previously a second GET /archives/{id}/files call). Doesn’t
require the archive to exist — same posture as remove_bookmark, a nonexistent archive simply
has no bookmarks to report (and no filenames to resolve).
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:36.
This response carries no example body.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
DELETE /archives/{id}/bookmarks/{page} — idempotent, same as
Section titled “DELETE /archives/{id}/bookmarks/{page} — idempotent, same as”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:751), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
DELETE /archives/{id}/bookmarks/{page} — idempotent, same as
BookmarksRepository::remove’s own contract; doesn’t check archive existence first since
removing a bookmark for an already-deleted archive is a legitimate cleanup, not an error. The
activity-log lookup below is a best-effort label fetch only, separate from that leniency — a
missing archive still lets the removal itself proceed, just with target.label: None (falls
back to target.id alone, same as any other action type whose resource vanished first).
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:37.
This response carries no example body.
This endpoint needs an administrator token — a guest (read-only) token is refused by the server.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
POST /archives/{id}/bookmarks/{page} — bookmarks does not validate page against the
Section titled “POST /archives/{id}/bookmarks/{page} — bookmarks does not validate page against the”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:689), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
POST /archives/{id}/bookmarks/{page} — bookmarks does not validate page against the
archive’s real pagecount, matching update_progress’s own leniency (archives.rs) — the
reader is the only caller and always passes its own current, already-valid page.
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:37.
This response carries no example body.
This endpoint needs an administrator token — a guest (read-only) token is refused by the server.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
PUT /archives/{id}/bookmarks/{page}/name — sets or clears this bookmark’s own name
Section titled “PUT /archives/{id}/bookmarks/{page}/name — sets or clears this bookmark’s own name”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:562), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
PUT /archives/{id}/bookmarks/{page}/name — sets or clears this bookmark’s own name.
404s if the bookmark itself doesn’t exist yet (a name can’t outlive the bookmark it names,
and setting one on a nonexistent bookmark would silently create an orphaned NAMES_HASH_KEY
entry no add_bookmark call ever cleans up) — matches add_stamp’s own “archive must exist
first” posture, just checking bookmark existence instead of archive existence.
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:47.
This response carries no example body.
This endpoint needs an administrator token — a guest (read-only) token is refused by the server.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
GET /bookmarks — every bookmark, aggregated by archive, sorted and paginated per sort/
Section titled “GET /bookmarks — every bookmark, aggregated by archive, sorted and paginated per sort/”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:252), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
GET /bookmarks — every bookmark, aggregated by archive, sorted and paginated per sort/
cursor/limit. A bookmark whose archive has since been deleted is silently dropped from the
result rather than erroring the whole list (same tolerance BookmarksRepository::list_all
already applies to malformed individual entries — one dangling reference shouldn’t take down
every other still-valid bookmark).
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:29.
This response carries no example body.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
GET /bookmarks/hover-page-order — the saved BookmarkHoverGrid page-order preference
Section titled “GET /bookmarks/hover-page-order — the saved BookmarkHoverGrid page-order preference”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:984), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
GET /bookmarks/hover-page-order — the saved BookmarkHoverGrid page-order preference
(None when never set; the frontend applies its own default, "pageDesc", in that case).
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:48.
This response carries no example body.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
Not recorded to the activity log — a display-only preference, same posture settings.rs’s own
Section titled “Not recorded to the activity log — a display-only preference, same posture settings.rs’s own”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:1002), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
Not recorded to the activity log — a display-only preference, same posture settings.rs’s own
theme field takes (no record_manual call either).
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:48.
This response carries no example body.
This endpoint needs an administrator token — a guest (read-only) token is refused by the server.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
GET /bookmarks/only-matching — the saved “only show bookmarks that themselves matched q”
Section titled “GET /bookmarks/only-matching — the saved “only show bookmarks that themselves matched q””Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:1018), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
GET /bookmarks/only-matching — the saved “only show bookmarks that themselves matched q”
preference (false when never set, matching the historical always-show-everything behavior).
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:52.
This response carries no example body.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
Not recorded to the activity log — same display-only posture put_hover_page_order takes
Section titled “Not recorded to the activity log — same display-only posture put_hover_page_order takes”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:1035), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
Not recorded to the activity log — same display-only posture put_hover_page_order takes.
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:52.
This response carries no example body.
This endpoint needs an administrator token — a guest (read-only) token is refused by the server.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
GET /tankoubons/{id}/bookmarks — every bookmark across every member archive, translated into
Section titled “GET /tankoubons/{id}/bookmarks — every bookmark across every member archive, translated into”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:877), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
GET /tankoubons/{id}/bookmarks — every bookmark across every member archive, translated into
the Tankoubon’s own global page numbering. Unpaginated, ascending by global page — matches
list_bookmarks_for_archive’s own contract (used the same way, by BookmarkHoverGrid, just
for a Tankoubon card instead of a plain archive card). A member archive that no longer exists
(or has an empty pagecount, e.g. not yet scanned) contributes nothing, silently, rather than
failing the whole request — same tolerance TankoubonFullResponse’s own docs describe for
full_data silently omitting a missing member.
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:64.
This response carries no example body.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
DELETE /tankoubons/{id}/bookmarks/{page} — same resolve-then-delegate shape as
Section titled “DELETE /tankoubons/{id}/bookmarks/{page} — same resolve-then-delegate shape as”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:832), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
DELETE /tankoubons/{id}/bookmarks/{page} — same resolve-then-delegate shape as
[add_tank_bookmark], onto [remove_bookmark].
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:68.
This response carries no example body.
This endpoint needs an administrator token — a guest (read-only) token is refused by the server.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
POST /tankoubons/{id}/bookmarks/{page} — resolves the Tankoubon-global page down to the
Section titled “POST /tankoubons/{id}/bookmarks/{page} — resolves the Tankoubon-global page down to the”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:817), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
POST /tankoubons/{id}/bookmarks/{page} — resolves the Tankoubon-global page down to the
real member archive + local page (tankoubons::resolve_tank_page) and delegates to
[add_bookmark]’s own logic; the write itself still lands on the real archive id, same as a
stamp placed while reading a Tankoubon (stamps.rs’s own Tankoubon routes) — bookmarks.rs’s
underlying BookmarksRepository has no TANK_ concept of its own and never needs one.
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:68.
This response carries no example body.
This endpoint needs an administrator token — a guest (read-only) token is refused by the server.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.
PUT /tankoubons/{id}/bookmarks/{page}/name — same resolve-then-delegate shape as
Section titled “PUT /tankoubons/{id}/bookmarks/{page}/name — same resolve-then-delegate shape as”Not yet described in this reference. This endpoint is listed because the server registers it, but its request and response shapes have not been written down yet.
The note below is the handler’s own documentation comment (crates/lanrurugi-api/src/bookmarks.rs:665), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
PUT /tankoubons/{id}/bookmarks/{page}/name — same resolve-then-delegate shape as
add_tank_bookmark/remove_tank_bookmark, onto [rename_bookmark].
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/bookmarks.rs:72.
This response carries no example body.
This endpoint needs an administrator token — a guest (read-only) token is refused by the server.
Request failed — Usual causes: the instance address is wrong or unreachable; cross-origin access is not enabled on the instance; or this page is HTTPS while the instance is plain HTTP on a LAN address, which the browser blocks as mixed content. “Copy as cURL” above sends the same request from a terminal.
Your own instance address. Requests go from this browser straight to it.