GraphQL Mutation Design: Hypermedia GraphQL API

A hypermedia-driven site provides information to navigate the site’s REST interfaces dynamically by including hypermedia links with the responses.

An example CheckoutCreatePayload Type, which provides a `__actions` field.
Mutation Operation
Mutation Response

I agree with your previous articles but not this one. I think machine-readable “hypermedia links” and “actions” in API responses are useless in most cases because you won’t be machine-building a UI from them. The UI will most of the times be built by hand and won’t be aligned one-to-one with either data objects or mutations.



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store