(doc) updated documentation for api endpoints