Document kronos HTTP API

Also `@id` is reserved and we be mercilessly clobbered by the server.