Retire multiple devices in bulk. The request is processed asynchronously: the response is 202 Accepted with a Location header (and the same URL in the body's location) that points to Get operation. Poll that URL until the operation's status is Completed or Failed.
deviceIds is required and must be non-empty. Every ID must be non-blank, unique within the request, belong to this account and not already be retired; otherwise the request is rejected with 400 Bad Request listing each offending device ID. There is no maximum number of devices per request.
Unauthorized. The access token is missing, invalid or expired. Returned by the gateway with an empty body.
Forbidden. The caller lacks permission, or the account is unknown, belongs to another tenant or is inactive. Returned by the gateway with an empty body.