DELETE

api

platform

telephony

providers-configurations

{id}

Delete Provider

curl --request DELETE \
  --url https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/ \
  --header 'Authorization: <api-key>' \
  --header 'Org-Handle: <org-handle>'

import requests

url = "https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/"

headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>"
}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {'Org-Handle': '<org-handle>', Authorization: '<api-key>'}
};

fetch('https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Org-Handle: <org-handle>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

HTTP/1.1 204 No Content

{
  "status_code": 404,
  "message": "Provider configuration not found."
}

HTTP/1.1 204 No Content

{
  "status_code": 404,
  "message": "Provider configuration not found."
}

Delete Provider Configuration

Permanently delete a telephony provider configuration by its ID. Once deleted, this configuration can no longer be used to connect to bridges. This action cannot be undone.

Prerequisites: Make sure you have your API Token and Org-Handle ready. See Authentication for details.

Deleting a provider configuration that is actively connected to a bridge may disrupt call routing. Disconnect the provider from all bridges before deleting.

Path Parameters

Name	Type	Required	Description
id	integer	Yes	Unique identifier of the provider configuration

You can get the provider configuration id by hitting the Get All Providers API.

Headers

Name	Type	Required	Description
Authorization	string	Yes	API Key format: `Token <token>`
Org-Handle	string	Yes	Organization domain handle

Common Error Codes

Status Code	Description
204	No Content - Configuration deleted successfully
401	Unauthorized - Invalid or missing API token
403	Forbidden - Invalid organization handle
404	Not Found - Provider configuration not found
500	Internal Server Error - Server-side error

Code Examples

const axios = require('axios');

const headers = {
  'Authorization': 'Token your-api-token',
  'Org-Handle': 'your-org-handle'
};

// Delete a provider configuration
const deleteProvider = async (id) => {
  await axios.delete(
    `https://unpod.ai/api/v2/platform/telephony/providers-configurations/${id}/`,
    { headers }
  );
  console.log(`Provider configuration #${id} deleted successfully`);
};

// Example usage
deleteProvider(42);

import requests

headers = {
    'Authorization': 'Token your-api-token',
    'Org-Handle': 'your-org-handle'
}

def delete_provider(config_id: int):
    """Delete a provider configuration"""
    url = f'https://unpod.ai/api/v2/platform/telephony/providers-configurations/{config_id}/'
    response = requests.delete(url, headers=headers)
    if response.status_code == 204:
        print(f"Provider configuration #{config_id} deleted successfully")
    else:
        print(f"Error: {response.json()}")

# Example usage
delete_provider(42)

# Delete a provider configuration
curl -X DELETE "https://unpod.ai/api/v2/platform/telephony/providers-configurations/42/" \
  -H "Authorization: Token your-api-token" \
  -H "Org-Handle: your-org-handle"

Best Practices

Disconnect First: Always disconnect the provider from bridges before deleting a configuration
Irreversible: Deletion is permanent - verify the correct id before proceeding
Audit Trail: Note the deletion in your records for compliance and troubleshooting purposes
204 Response: A successful delete returns HTTP 204 with no body - handle this in your code
Error Handling: Handle 404 gracefully - the configuration may have already been deleted

Authorizations

Authorization

string

header

required

Format: Token

Headers

Org-Handle

string

required

Organization domain handle

Example:

"unpod.tv"

Path Parameters

integer

required

Example:

42

Response

Provider deleted successfully - No Content

OverviewIntroduction to the Billing API

Delete Provider

curl --request DELETE \
  --url https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/ \
  --header 'Authorization: <api-key>' \
  --header 'Org-Handle: <org-handle>'

import requests

url = "https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/"

headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>"
}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {'Org-Handle': '<org-handle>', Authorization: '<api-key>'}
};

fetch('https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Org-Handle: <org-handle>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/telephony/providers-configurations/{id}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

HTTP/1.1 204 No Content

{
  "status_code": 404,
  "message": "Provider configuration not found."
}

Getting Started

API Lists

Delete Provider

Delete Provider Configuration

Path Parameters

Headers

Common Error Codes

Code Examples

Best Practices

Authorizations

Headers

Path Parameters

Response

​Delete Provider Configuration

​Path Parameters

​Headers

​Common Error Codes

​Code Examples

​Best Practices

Authorizations

Headers

Path Parameters

Response

Delete Provider Configuration

Path Parameters

Headers

Common Error Codes

Code Examples

Best Practices