adding docs for a few apis