doc: add admin api doc

Ok. My suggestion then is to fix the response before we release this API to the world, then.