Updated the HTTP API docs.

Needs more description and a summary.