doc: add admin api doc

there is already an issue for this. we need to change the actual code. the current doc describes what the current behavior of the api.