It's the question of long-term consequences for supportability and product evolution. Will the next person supporting the API know all the hidden gotchas?