* initial commit of REST API doc in MD * clarify PUT/POST; improve footnote formatting * change anchor name to endnote