Miscellaneous other API
5 endpoints.
Queue a URL download
Section titled “Queue a URL download”Add a URL to be downloaded by the server and added to its library.
Query parameters
- urlstringoptional
- URL to download
- catidstring · min: 14 · max: 14 · patternoptional
- Category ID to add the downloaded URL to.
Request body
multipart/form-data
Responses
200Enqueued job
{
"job": 86,
"operation": "download_url",
"success": 1,
"url": "https://example.com"
}400Bad request
{
"error": "",
"operation": "",
"success": 0,
"successMessage": ""
}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 server info
Section titled “Get server info”Returns some basic information about the LRR instance this server is running.
Responses
200Server info
{
"archives_per_page": 100,
"authenticated_progress": false,
"cache_last_cleared": 1728852701,
"debug_mode": true,
"excluded_namespaces": [
"source",
"date_added"
],
"has_password": false,
"motd": "aye lads time to read some manga",
"name": "LANraragi",
"nofun_mode": false,
"restart_required": false,
"server_resizes_images": false,
"server_tracks_progress": true,
"total_archives": 104,
"total_pages_read": 252,
"version": "0.9.30",
"version_desc": "I'm under Japanese influence and my honor's at stake!",
"version_name": "Law (Earthlings On Fire)"
}This endpoint needs no credentials.
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 /api/llm/key-status — returns { configured: true/false }
Section titled “GET /api/llm/key-status — returns { configured: true/false }”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/misc.rs:115), quoted verbatim. It is written for maintainers of this codebase and may reference internal identifiers.
GET /api/llm/key-status — returns { configured: true/false }.
Responses
200The endpoint responded. Its exact shape is not documented yet — see the handler at crates/lanrurugi-api/src/misc.rs:20.
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.
Regenerate Thumbnails
Section titled “Regenerate Thumbnails”Queue a Minion job to regenerate missing/all thumbnails on the server.
Query parameters
- forcebooleanoptional
- Whether to generate all thumbnails, or only the missing ones.
Responses
200Enqueued job
{
"job": 3,
"operation": "regen_thumbnails",
"success": 1
}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.
Clean the Temporary Folder
Section titled “Clean the Temporary Folder”Cleans the server’s temporary folder.
Responses
200Cleanup result
{
"error": null,
"newsize": 0,
"operation": "cleantemp",
"success": 1
}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.