more documentation for apis