Restart Polycom phones via Rest API using Postman

Owned by Pramuk Shyam Pathy (Unlicensed)
Last updated: Nov 21, 2019
2 min read

UDM Pro uses the Rest API as one of its methods to reboot phones. When troubleshooting issues with rest API reboots, it is helpful to understand what is causing the issue, the phones (i.e. its config) or in UDM Pro.

This guide will help you send a Rest API reboot command to the phones from a source other than UDM Pro. This way you can rule out the phone or UDM Pro in your troubleshooting.

Instructions

  1. Download and install Postman. You can download this application here: https://www.getpostman.com/downloads/

  2. Once Installed, open Postman.

  3. Click on the dropdown to the left of the URL field and choose “POST”

  4. Enter the following URL: https://<phone IP address>/api/v1/mgmt/safeRestart (replace <Phone IP address> with the actual IP address of the phone).

  5. Under the URL Field, Select “Authorization”, Choose the “Basic Auth” as the Type and enter the following credentials:
    Username: Polycom (make sure the first letter is capitalized)
    Password: <Your phone admin pin>

  6. Next, select “Headers” and add the following values:
    Key: Content-Type
    Value: application/json
    Like the screenshot below:

     

  7. Now you are ready to send the reboot command. Go ahead and click Send.

  8. The return code from the phone will help identify the issue. Below is the list of all the error codes for your reference:
    Success:
    2000 API executed successfully.

    Failed:
    4000 Invalid input parameters.
    4001 Device busy.
    4002 Line not registered.
    4003 Operation not allowed.
    4004 Operation Not Supported
    4005 Line does not exist.
    4006 URLs not configured.
    4007 Call Does Not Exist
    4008 Configuration Export Failed
    4009 Input Size Limit Exceeded
    4010 Default Password Not Allowed

    5000 Failed to process request.