docs: add description for some api methods.