Update API documentation

- [ ] Update apiary.apib
- [ ] Use apiary as a public mock API
- [ ] Add expected API results as specs