API Version: Development

Phone Provisioning

Permissions

Requires System-Admin or Company-Admin with 'default' company access. If promoting a phone to a non-default company, a Company-Admin also needs access to the target company.

command 'inactive'

Path: /rest/dialplan/inactive/
List all phones which have requested provisioning, but have an outstanding activation step pending. No filtering is possible on this query.
{    
    "type": "phone"
}
Return value:
{
    "result": "success",
    "values": [
        {
            "phoneid": "phone id",
            "type": "phone type description"
            "created": creation epoch-time
        }
    ],
    "numrows": rows-returned
}
Note that the phoneid value is the handset identifier which is it's mac address and it's 'port' number combined. For most devices, the port number is a 0.

command 'promote'

Path: /rest/dialplan/promote/
Promote a phone from the inactive list into the active phones list. A multi-port device will have all ports activated. An OPTIONAL company value can be specified to promote and assign the handset in one operation. If omitted, the device is promoted into the default company. The user must have permission, and the company must exist.
{    
    "type": "phone",
    "scope": {
        "phoneid": "0123456789ab0"
    },
    "values": {
        "company": "acompany"
    }
}
Return value:
{
    "result": "success",
    "numrows": rows-updated
}

command 'demote'

Path: /rest/dialplan/demote/
Demote a phone from the inactive list, effectively deleting it. A multi-port device will have all ports deleted.
{    
    "type": "phone",
    "scope": {
        "phoneid": "0123456789ab0"
    }
}
Return value:
{
    "result": "success",
    "numrows": rows-removed
}