Updates to API responses
Draft Write API documentation
Merge branch 'my'