[rbalicki]

The problem with REST (or really, any current non GraphQL solution) is there is only an implicit link between the consumer of a field and the query declaration. So, REST queries are append only, especially at large organizations where incremental perf improvements are less good than accidentally bringing down the site is bad. That’s the failure mode of specialized REST endpoints that deliver exactly what a given view needs.

[eddd-ddde]

If you require something more explicit, you can totally define strict schemas that your API adheres to.

Would you elaborate on "queries are append only"? I fail to understand the downside you mention.

If you mean that you can only append to the data you return from a resource, you can use versioning to deprecate properties on a resource.