4Adding a Device Lock on iOS Devices

Description Add a screen lock on iOS devices.

Resource Path /lock

URL /ios/operation/lock

HTTP Method POST

Request/Response Format application/json

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>/ios/operation/lock

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. For more information see Sample JSON Definition.
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.

For example: device_id.json has the device ID's listed as shown under sample request.

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -d @'device_id.json' -k -v https://ip:9443/ios/operation/lock

Sample output

Sample JSON
Definition

The following are sample configurations that can be used in a JSON to carryout common iOS operations:

[
  "2be702beaaf4ad34fc9e7f8da2b6b808c453fa72b", 
  "2ec33430ad456713c633de75b2219376bac45de56"
]

Property Value	Description	Required	Default Value	Data Type	Example
device id	ID of the iOS device. Multiple device IDs can be added by using comma separated values. For more information on retrieving the device ID, see Retrieving the ID of an iOS device.	Yes	N/A	String	2be702beaaf4ad34fc9e 7f8da2b6b808c453fa72b