Spec out 1.0 API

[ergo]

There is legacy API right now that generally works, but there should be a better versioned API for the server, that utilizes HTTP verbs better, we probably should revamp some configuration keys and response formats too.

[ergo]

The api should also prepare for multi tenancy and plugin support