Update notes for submitted changes

* Implement the /v2/sample API
Update notes for submitted changes

* api: raise ClientSideError rather than ValueError