Comment 3 for bug 1477109

However, for an asynchronous response, the heat code should make sure it follows the API working group guideline here: http://specs.openstack.org/openstack/api-wg/guidelines/http.html#xx-success-codes

I believe that suspend stack should return a URI of a status resource and also should return a 202 Accepted. Please log a bug against heat itself rather than the docs, and do not work on a doc change until the doc bug is triaged and set to Confirmed.