updated docs and endpoints