[Caveat: this is focused on HTTP-based, or REST APIs]
In the software world, we often refer to building ‘extensible’ designs. In essence, this means that we can build a system that is light and nimble, capable of changing and growing over time.
In the world of API design, we can’t always make rapid changes. Many API clients become dependent on existing functionality.
Think about this from the perspective of sustainability:
How long can we keep and grow this design?
How long before we have to start over on another version?