Improve doc on general HTTP API and fix new instance handling