updated documentation for api