so, let's add some comments. at least to explain why. maybe create an issue or a thread on dev.gaia to explain the need of such API.