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.
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.