This should begin to capture it:
https://datahubproject.io/docs/metadata-service#api-documentation
In a nutshell, GraphQL is a semantic API that allows you to perform high-level actions liking adding / removing links, owners, tags, etc.
Rest.li is a low level storage API for reading and writing the metadata models directly, reading and writing should generally be reserved for authorized users