Thanks for the link. Actually, maybe they could spend some time expanding that api doc. There are other http api's that I've picked up in the forum that aren't documented there.
That link is for the API to the clients. The server API is undocumented, and not guaranteed to be stable.