API v1 spec

This is still a work-in-progress, but any feedback is more than welcome.
Will the history include stuff that you can currently get from the fleet logs that help you track down why units were scheduled on specific machines or more importantly, not scheduled at all?