Update notes for submitted changes

* proposed spec for v1 api