Sign in

v1

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

Delete User Extensions

Deletes user extension(s) and either keeps or destroys the assets - numbers and devices. Multiple extensions can be deleted with a single API call.

Please note: This API cannot be tested on Sandbox.

delete/restapi/v2/accounts/{accountId}/extensions

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)

Request body

keepAssetsInInventoryboolean

Indicates that the freed users' assets (phone numbers and devices) should be moved to account inventory rather than deleted. If set to true, the phone numbers and devices assigned to deleted extensions will be kept in the account's inventory. If set to false, these assets will be deleted from the account and returned to either the partner's phone numbers or RingCentral's phone number pool

Example request

{
  "records": [
    {
      "id": "12345"
    }
  ]
}

Response

Successful response

Example response

{
  "records": [
    {
      "id": "1162820004",
      "bulkItemSuccessful": true,
      "bulkItemErrors": [
        {
          "errorCode": "XXX-123",
          "message": "Something went wrong"
        }
      ]
    }
  ]
}