Doc api cleanup

Mostly unimportant, trivial cleanup of ``docs/rest_api.md``