Document kronos HTTP API

JSON schema v4 lets you attach tons of more optional metadata but this as is should still fall under it. Lets keep the types. Reading that schema spec is a nightmare.