mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-06 19:06:02 +03:00
Bookstack Version via API #2720
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @chrisnails on GitHub (Mar 23, 2022).
API Endpoint or Feature
It would be helpful if i could get the current Version of the Bookstack Instance via the API
Use-Case
I'd like to add a Check in my Monitoring System to get notified if my Bookstack Instance is not on the latest Version.
Additional context
i can check the latest bookstack release like this
curl -sL https://api.github.com/repos/BookStackApp/BookStack/releases/latest | jq -r ".tag_name"i just need somethign similar for Bookstack itself, compare Versions and Notify
@ssddanbrown commented on GitHub (Mar 23, 2022):
Hi @chrisnails,
The version is used as a cache breaker on asset urls so it is possible to do the following:
If you need more than that, we do have a status endpoint we could maybe add the version to. I do wonder though if our usage of the version in such a status endpoint (and the existing cache breaker usage) would be a security concern for some (for those that want more obscurity).
Maybe we could add a new api-side
/systemendpoint which shows additional detail such as app name and app logo and the version. Just trying to avoid single-use-endpoints if other similar details also get requested.@chrisnails commented on GitHub (Mar 23, 2022):
hi @ssddanbrown,
thanks for the quick answer!
For my current use-case, the cache breaker angle works fine.
But i agree that this Info might better be kept behind authentication.
@ssddanbrown commented on GitHub (Mar 23, 2022):
Cool, since the cache breaker angle works for you I'll close this off but I'll keep it in mind for the future similar requests.
If we ever break you cache breaker scraping (Probably unlikely unless we start hiding versions) then just let us know on here and we can quickly move to implement such an endpoint if nothing already exists by that point.
@Bartiff commented on GitHub (Oct 14, 2022):
I'm voting for a new api endpoint like /system!
@ssddanbrown commented on GitHub (May 22, 2025):
@chrisnails @Bartiff In case it's still desired by either of you, an endpoint has been added via #5607 (Via Issue #5603) to be part of the next release.