sync API with most recent version of the doc.