Delete Provisioned Route

Permanently deletes a call routing configuration and performs comprehensive cleanup of all associated resources.

What Gets Deleted/Modified:

Route Configuration

Sets provisioned route status to 'deleted'

Clears webhook associations

Nullifies referral end dates

Phone Number Management

Reserves associated phone number (status: 'reserved')

Clears phone detail associations (app_id, org_unit_id, provisioned_route_id)

Marks provisioned_route_number as inactive with removal timestamp

Disables misdial protection

DNI (Dynamic Number Insertion)

Deactivates all DNI settings (dni_active = false)

Updates modification timestamp

Call Flow Configuration

Suspends call flow status

Removes hunt group options and types

Cleans up routing rules

Component Counting

Decrements active number count for active routes (component 18)

Decrements secondary total for inactive routes

Decrements referral count for referral routes (component 28)

Handles premium number components appropriately

Transaction Safety:

All operations execute within a single database transaction

Automatic rollback on any error

Data integrity guaranteed

Validation Rules:

Only routes with routable_type = 'SimpleRoute' can be deleted

Route must exist and not be already deleted

Valid provisioned_route_id required (positive integer)

Authorization:

Admin role: Full access

Standard role: Full access

ReadOnly role: Access denied (cannot delete routes)

Use Cases:

Removing test/demo tracking numbers

Decommissioning expired campaigns

Cleaning up unused routing configurations

Bulk route management and optimization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Delete Provisioned Route

Request

Responses