updated docs for api and router