adding docs for new rest apis.