function telecoms.num.dealloc

** page under construction **

Use to remove a phone number from an account.

If the number is currently routing to a destination, the routing is also removed.

Note: if there are DNI specific facilities (eg mobile routing) attached to this number, that will need to be separately removed by using the telecoms.facility.cancel facility.

In order to run this function, you must be logged in to an account that is registered as an owner of the range from which the number being deallocated belongs. Unless you are a registered telco with your ranges added to our system, this function won't be useful to you.

Use telecoms.num.list to obtain a list of numbers on an account.

Arguments:

argrequired?syntaxinfo
custIDYposintcustID of account from which the number is being removed
numberNposintthe phone number to remove