further updates to API