You&#x27;re absolutely right. FWIW, I think this iterative process should take place before publishing your API. Sometimes a design needs to &#x27;sit&#x27; for a month or two and be used a bit before you realize its boundaries: what it does well, and what could be improved. If you&#x27;re judicious about improvements (i.e. don&#x27;t rewrite) you&#x27;ll avoid the second-system effect and put out an API that&#x27;ll be better than your first attempt. I realize that&#x27;s not always possible.