Sometimes when you write documentation for APIs you realize something is terribly designed. That should have happened here.