JSON API » phones » phones/unregister

Deletes all registration information for a telephone line. This does not affect the handset, which will still appear to be registered.

Input parameters

Requires authentication and the administrator role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
nameStringTelephone line to unregister.Yes

Responses

CodeDescription
204Success.
401The authentication details provided are invalid.
402Your role does not allow this.
404The telephone line does not exist, or you do not have permission to unregister it.

Data returned

No data is returned.

Example: With required parameters

http://enswitch.example.com/api/json/phones/unregister/?auth_username=user;auth_password=password;name=1234567

{ "responses":[ { "code":"204", "key":"", "message":"OK" } ] }

Change history

VersionChanges
3.13Function added.