caching service API improvements