updates to API doc