Good thread on why designing an API upfront is a bad idea.
Design it based on needs of consumers.
That's why I think https://docs.pact.io/ is great, because it flips the relation and lets consumers describe what they want, and the API needs to provide that. https://twitter.com/stilkov/status/1250355402501492736