Fix some issues with API spec (#2424)
Fix some issues with API spec (#2424)

* Fix some bugs in the API yaml

* Remove limitEmbedded

* Explain different query types

* Remove unused schema def

graknlabs/grakn,lolski/grakn,graknlabs/grakn,graknlabs/grakn,lolski/grakn,lolski/grakn,lolski/grakn,graknlabs/grakn