update to rest api docs, still WIP