Document initial api

The plan is to document the initial api methods and use the PR to get everyone's feedback on how the api should look before starting on the implementation.
Using this format for timestamps since its the format expected by pretty much all client side things (since this is the js [`Date`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) format).