tbc: API has little or no documentation.

Certainly my fault but we need to document `tbc` and other websocket APIs. We should add at least a one liner describing what each API command does and why it exists. Where appropriate describe the parameters as well.

Extra credits are to be had if we can somehow automatically pull this into `hemictl` to print as online help.