upfated public API.