updated documentation for API