Phone Provisioning
Permissions
Requires System-Admin
or Company-Admin
with appropriate company access.
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"
}
],
"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
.
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.
{
"type": "phone",
"scope": {
"phoneid": "0123456789ab0"
}
}
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
}