API docs and messaging

[gassc]

Finish up the Open API Spec document and implement some more consistent, human-friendly API feedback messaging as part of that.

[gassc]

Added model/example for POST and PUT required inputs.