# Miscellaneous other API

## Get server info

> Returns some basic information about the LRR instance this server is running.

```json
{"openapi":"3.1.0","info":{"title":"LANraragi API","version":"0.9.6"},"tags":[{"name":"misc","description":"Other APIs that don't fit a dedicated theme."}],"servers":[{"url":"https://lrr.tvc-16.science/api"}],"paths":{"/info":{"get":{"operationId":"getServerInfo","summary":"Get server info","description":"Returns some basic information about the LRR instance this server is running.","tags":["misc"],"responses":{"200":{"description":"Server info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerInfo"}}}}}}}},"components":{"schemas":{"ServerInfo":{"type":"object","description":"Server info payload emitted by /api/info. Older server versions used integers instead of booleans here.","properties":{"name":{"type":"string","description":"Name of the instance"},"motd":{"type":"string","description":"MOTD of the instance"},"version":{"type":"string","description":"Version of the server"},"version_name":{"type":"string","description":"Version name"},"version_desc":{"type":"string","description":"Version description"},"has_password":{"type":"boolean","description":"Whether the instance is password-protected"},"debug_mode":{"type":"boolean","description":"Whether the instance has debug mode enabled"},"nofun_mode":{"type":"boolean","description":"Whether the instance has no-fun mode enabled"},"archives_per_page":{"type":"integer","description":"How many archives per page the server lists"},"server_resizes_images":{"type":"boolean","description":"Whether the instance auto-downsizes images before serving them"},"server_tracks_progress":{"type":"boolean","description":"Whether the instance tracks reading progression server-side"},"authenticated_progress":{"type":"boolean","description":"Whether the instance requires authentication for server-side progress updates"},"total_pages_read":{"type":"integer","description":"Total amount of pages read"},"total_archives":{"type":"integer","description":"Total amount of archives stored on instance"},"cache_last_cleared":{"type":"integer","description":"Timestamp for last time the search cache was wiped"},"excluded_namespaces":{"type":"array","items":{"type":"string"},"description":"List of tag namespaces excluded from search suggestions and tag statistics"}}}}}}
```

## Clean the Temporary Folder

> Cleans the server's temporary folder.

```json
{"openapi":"3.1.0","info":{"title":"LANraragi API","version":"0.9.6"},"tags":[{"name":"misc","description":"Other APIs that don't fit a dedicated theme."}],"servers":[{"url":"https://lrr.tvc-16.science/api"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"Authorization","in":"header","description":"Use Authorization: Bearer <base64(api_key)>"}}},"paths":{"/tempfolder":{"delete":{"operationId":"cleanTempfolder","summary":"Clean the Temporary Folder","description":"Cleans the server's temporary folder.","tags":["misc"],"responses":{"200":{"description":"Cleanup result","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string","enum":["cleantemp"]},"success":{"type":"integer","enum":[0,1]},"error":{"type":["string","null"],"description":"Error message if something went wrong during cleanup. (The call will still return 200)"},"newsize":{"type":"integer","description":"Current size of the temporary folder post-cleanup."}}}}}}}}}}}
```

## Queue a URL download

> Add a URL to be downloaded by the server and added to its library.

```json
{"openapi":"3.1.0","info":{"title":"LANraragi API","version":"0.9.6"},"tags":[{"name":"misc","description":"Other APIs that don't fit a dedicated theme."}],"servers":[{"url":"https://lrr.tvc-16.science/api"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"Authorization","in":"header","description":"Use Authorization: Bearer <base64(api_key)>"}},"schemas":{"OperationResponse":{"type":"object","required":["operation","success"],"properties":{"operation":{"type":"string","description":"Name of operation"},"error":{"type":"string","description":"Error message if any"},"successMessage":{"type":"string","description":"Success message if any"},"success":{"type":"integer","description":"Returns 1 if operation was successful, else 0","enum":[0,1]}}}}},"paths":{"/download_url":{"post":{"operationId":"downloadUrl","summary":"Queue a URL download","description":"Add a URL to be downloaded by the server and added to its library.","tags":["misc"],"parameters":[{"name":"url","in":"query","description":"URL to download","required":false,"schema":{"type":"string","format":"uri"}},{"name":"catid","in":"query","required":false,"description":"Category ID to add the downloaded URL to.","schema":{"type":"string","minLength":14,"maxLength":14}}],"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":["url"],"properties":{"url":{"description":"URL to download","type":"string","format":"uri"},"catid":{"type":"string","description":"Category ID to add the downloaded URL to.","minLength":14,"maxLength":14}}}}}},"responses":{"200":{"description":"Enqueued job","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string","enum":["download_url"]},"url":{"type":"string","description":"URL queued for download"},"category":{"type":["string","null"]},"success":{"type":"integer","enum":[0,1]},"job":{"type":"integer"}}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}}}}}}}
```

## Regenerate Thumbnails

> Queue a Minion job to regenerate missing/all thumbnails on the server.

```json
{"openapi":"3.1.0","info":{"title":"LANraragi API","version":"0.9.6"},"tags":[{"name":"misc","description":"Other APIs that don't fit a dedicated theme."}],"servers":[{"url":"https://lrr.tvc-16.science/api"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"Authorization","in":"header","description":"Use Authorization: Bearer <base64(api_key)>"}}},"paths":{"/regen_thumbs":{"post":{"operationId":"regenThumbnails","summary":"Regenerate Thumbnails","description":"Queue a Minion job to regenerate missing/all thumbnails on the server.","tags":["misc"],"parameters":[{"name":"force","in":"query","description":"Whether to generate all thumbnails, or only the missing ones.","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Enqueued job","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string","enum":["regen_thumbnails"]},"success":{"type":"integer","enum":[0,1]},"job":{"type":"integer"}}}}}}}}}}}
```

## Metrics

The `/api/info/metrics` endpoint returns metrics in the [Prometheus exposition format](https://prometheus.io/docs/instrumenting/exposition_formats/#text-format-example).

```sh
# HELP lanraragi_api_requests_total Total number of API requests
# TYPE lanraragi_api_requests_total counter
lanraragi_api_requests_total{endpoint="/",method="GET"} 4063
lanraragi_api_requests_total{endpoint="/api/archives/:id",method="DELETE"} 2
lanraragi_api_requests_total{endpoint="/api/archives/:id/categories",method="GET"} 1
lanraragi_api_requests_total{endpoint="/api/archives/:id/files",method="GET"} 7
lanraragi_api_requests_total{endpoint="/api/archives/:id/files/thumbnails",method="POST"} 5
lanraragi_api_requests_total{endpoint="/api/archives/:id/isnew",method="DELETE"} 7
lanraragi_api_requests_total{endpoint="/api/archives/:id/metadata",method="GET"} 8
# ...
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sugoi.gitbook.io/lanraragi/api-documentation/miscellaneous-other-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
