The Account Management REST API is mentioned here [1] as supported (and enabled by default) feature. Yet there seems to be no documentation for is[2]. Is this an official API which is here to stay or will it eventually be removed?
[1] Enabling and disabling features - Keycloak
[2] Full documentation of account management REST API?
AFAIK this is an official API and made to stay, although it‘s not documented.
It‘s planned to remove the legacy account client with the next major version and the React.js based account app using the account API becomes default (resp. the only one). Perhaps some documentation will be added, perhaps not.
What I do (and many others I know): Use the account console, open the browser dev console, network tab, and record/view the requests you are interested in… This should give you most of the needed information.
I’m not a keycloak developer, but there is very little activity in this forum in terms of replies, so I’ll answer anyway.
That API is not documented. There is no promise that it will stay the same. But it is used from the account management interface for normal, non-privileged users. I’d expect it to stay, though it may be subject to some changes.
The alternative would be to make your own backend microservice that exposes account management functionality using the more stable and better documented Administration REST API. But arguably, this is more work than updating a few API requests if you decide to update keycloak to a breaking version.
It is now the default, and will likely remain for the current account theme (keycloak.v2) and the one that is currently being worked on. I made an OpenAPI spec file to ease building clients: