4Ringing Windows Devices via the Rest API

Overview

Description	Ring Windows devices.
Resource Path	`/ring`
URL	`/mdm-windows-agent/services/windows/ring`
HTTP Method	`POST`
Request/Response Format	`application/json`

Sample request

[
 "urn:uuid:FAEFB2D5-1771-5446-A635-797AFC474895",
 "urn:uuid:FEDCB4T2-1345-2857-F274-263BES386554"
]

For information on the property value definitions, see Resource Definition for Common Windows Operations.

cURL command

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -d @'<JSON_PAYLOAD>' -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-windows-agent/services/windows/ring

For more information on how to generate the EMM API token, see Generating the EMM API Token.
Define the path to the JSON file, which lists the devices that this operation is applied on, as the <JSON_PAYLOAD> value.
By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.