Return to the AirWatch console.

1. Click Groups & Settings.
2. Click All Settings.

1. Click on System.
2. Expand the Advanced section.
3. Expand the API section.
4. Click REST API.

1. Select Override for Current Setting.
2. Select Enabled for Enable API Access.
3. Using your mouse, highlight the API Key that is in API Key text box for the AirWatchAPI service.  Right click on the text and select Copy.

1. You may need to scroll down to find the Save button.
2. Click Save.
3. Click the Close button in the top right corner.

1. Click the Windows Start Button.
2. Type "Notepad" in the search field.
3. Click on Notepad in the Programs list.

1. In Notepad, click on Edit.
2. Click on Paste. This will paste the API key into notepad.

Double-click the Postman shortcut from the Desktop to launch Postman.

NOTE - The Postman application may take a second to launch after double-clicking, please wait while the application loads.

In this section, we will prepare the Postman REST client to test AirWatch REST APIs.

1. Notice the History tab, which tracks the history of the REST APIs that you have used. You can reuse the entries from this section if you want to use the same API with any modifications.
2. Click the Hide Sidebar button to hide the History and Collections tabs, as we will not be utilizing them during the lab.
3. Select the Authorization tab.
4. Click the Type dropdown.
5. Select Basic Auth.

NOTE - If there are any existing values in the Username or Password field, remove them and use the details below:

1. Enter the AirWatch Administrator account name. This will be your email address that you used to sign into the Lab.
2. Enter the password as "VMware1!"
3. Click on Show Password to ensure that you have entered the correct password.

Select Notepad from the tray.

1. In Notepad, click on Edit.
2. Click on Select All.

1. Click on Edit.
2. Click on Copy.

Select Postman from the tray.

1. Click on the Headers tab.
2. Enter "aw-tenant-code" in the Key field.
3. Click the Value field next to the aw-tenant-code Key you just entered to select it.
4. Click Edit.
5. Click Paste.

Now, we have our REST Client setup with Basic Authentication and another header with the AirWatch REST API key. In the following section, we will use this setup to make REST API calls.

NOTE - The AirWatch APIs also require the Authorization header, which is built from the username and password provided in the Basic Authorization section.  Postman will automation add this Authorization header when we send our first request.

1. Confirm that GET is selected..
2. Enter the URL https://hol.awmdm.com/api/mdm/devices/search?user=testuser in the URL field.
   NOTE - Please refer the section on how to copy and paste text in VLP in case you want to use that feature to enter URL.
3. Click the Send button.

NOTE - You may need to scroll down to find the Body section to view the full response.

1. Ensure that you get a status as 200 OK. That indicates that your query is successful.
2. Click on the response format to Pretty.
3. Note the value of key Id under Devices. We will be using this in one of the POST API queries. You may use notepad to note down this value as you did with the REST API key.
4. Note the value of key UserId under Devices. We will be using this in the following REST APIs. You may use notepad to note down this value as you did with the REST API key.

1. Confirm that GET is selected.
2. Enter the URL https://hol.awmdm.com/api/system/users/{UserId} in the URL field.  Replace {UserId} with the UserId obtained from from the Validate Search Device API Response step.
3. Click on the Send button.

NOTE - You may need to scroll down to find the Body section to view the full response.

1. Ensure that you get a status as 200 OK. That indicates that your query is successful.
2. Confirm the information about the enrollment user.

1. Confirm that GET is selected.
2. Enter the URL https://hol.awmdm.com/api/mam/apps/search?platform=Apple in the URL field.
3. Click on the Send button.

In this step, you will use the API to search for all Applications that are in the AirWatch App Catalog for Apple devices.

1. Ensure that you get a status as 200 OK. That indicates that your query is successful.
2. If you have multiple entries of Application entities, scroll down through the response until you find the entry with ApplicationName as AW REST API

This API command can remotely lock a device. Prior to performing this step, please confirm that your enrolled device is on and unlocked.

1. Change the command type to POST.
2. Enter the URL https://hol.awmdm.com/api/mdm/devices/{deviceID}/lockdevice. Replace {DeviceID} with the DeviceId returned in the Validate Search Device API Response.
3. Click on the button Send.

Confirm that the API Response status is a 202 Accepted.

Confirm that the enrolled device is now locked.

In this section, we will explore how to make a JSON REST API request. We will add a header to the POST request so that API uses JSON format instead of XML that we have used so far.

1. Confirm that POST is selected.
2. Enter the URL https://hol.awmdm.com/api/mdm/devices/{DeviceId}/sendmessage in the URL field.  Replace {DeviceId} with the DeviceId returned in the Validate Search Device API Response step.
3. Add a new header as "Content-Type".
4. Enter the value of the header as "application/json".

1. Click the Body tab.
2. Click on the Raw radio button to change the format.
3. Select JSON (application/json) from the dropdown.
4. Enter the following text in the body section. Please refer to the section How to Copy and Paste in VLP if you prefer copy and paste the following text:
   {    "MessageBody"  :   "AirWatch Test Push Message",    "Application"  :   "AirWatch Agent",    "MessageType"  :   "Push Notification" }
5. Ensure that you are not seeing X marks. If you do then double check quotes and commas in the text body to correct those errors.
6. Click on Send.

Ensure that you get the API response status as 202 Accepted is returned. You should now see a push notification with the text AirWatch Test Push Message on your device.

1. Ensure that you are selecting REST Query type as DELETE.
2. Use the following API to Delete the device from AirWatch UEM: https://hol.awmdm.com/API/mdm/devices/{DeviceId}. Replace {DeviceId} with the deviceId returned in the Validate Search Device API Response step.

1. Select form-data to clear the API request body.
2. Click on Send.
3. Ensure that you get the API response status as 200 OK.

The device will no longer be enrolled in AirWatch and the AW REST API app has been removed from the device along with any other applications that were present.