update API method docs