v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
User Settings

Delete Extension

Deletes extension(s) by ID(s). When an extension is being deleted the default API behavior is as follows:

  • user's direct numbers are preserved by becoming additional company numbers;
  • user's digital lines (both device & associated phone number) are deleted.

You can change this behavior using the filters:

  • create unassigned extensions for each digital line of the deleted extension by setting the query parameter savePhoneLines to true in request path;
  • remove direct numbers of the deleted extension by setting the savePhoneNumbers query parameter to false in request path

Note! Since this API is now deprecated, please use the following API method DELETE /restapi/v2/accounts/{accountId}/extensions for users deletion.

delete/restapi/v1.0/account/{accountId}/extension/{extensionId}

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

Query parameters

savePhoneLinesboolean
savePhoneNumbersboolean

Response

No Content