documenting cache endpoints