[adamors]

GraphQL adds:

  * living documentation
  * much better approach to versioning/deprecation
  * type system

etc.

For REST based APIs you have to figure out all of these (and usually they are completely different accross projects/languages etc.).

Solutions like Swagger offer some sort of solution but they are still a PIA to work with.