Document URL: 

https://access.redhat.com/documentation/en-us/red_hat_cloudforms/4.7/html-single/release_notes/index
https://access.redhat.com/documentation/en-us/red_hat_cloudforms/4.7/html-single/red_hat_cloudforms_rest_api/index#retire-service-immediately

Section Number and Name: 

release note : section 4, enhancements
API documentation : 3.7.5, 3.7.6, 3.7.7, three sections related to service retirement

Describe the issue: 

the correct api call now is 
~~~
POST POST /api/services/<<id>>
{
	"action" : "request_retire"
}
~~~
calls to the ancient method results in retirement to fail (bz#1698116)

Suggestions for improvement: 

we need to update the documentation to cover request_retire

Additional information: 
related to bug#1698116