DELETE

api

platform

telephony

bridges

{slug}

Delete Bridge

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

import requests

url = "https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/"

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/bridges/{slug}/', 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/bridges/{slug}/",
  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/bridges/{slug}/"

	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/bridges/{slug}/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/")

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": "Bridge not found.",
  "errors": "No bridge exists with the provided slug"
}

HTTP/1.1 204 No Content

{
  "status_code": 404,
  "message": "Bridge not found.",
  "errors": "No bridge exists with the provided slug"
}

Delete Bridge

Permanently delete a telephony bridge by its slug. Once deleted, the bridge and all associated configurations are removed. This action cannot be undone.

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

Deleting a bridge that has active phone numbers or is actively routing calls will disrupt service. Disconnect all providers and reassign numbers before deleting.

Path Parameters

Name	Type	Required	Description
slug	string	Yes	Unique bridge slug

You can get the bridge slug by hitting the Get All Bridges API. The slug field in the response is your Bridge Slug.

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 - Bridge deleted successfully
401	Unauthorized - Invalid or missing API token
403	Forbidden - Invalid organization handle
404	Not Found - Bridge 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 bridge
const deleteBridge = async (slug) => {
  await axios.delete(
    `https://unpod.ai/api/v2/platform/telephony/bridges/${slug}/`,
    { headers }
  );
  console.log(`Bridge '${slug}' deleted successfully`);
};

// Example usage
deleteBridge('sales-bridge-001');

import requests

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

def delete_bridge(slug: str):
    """Delete a telephony bridge"""
    url = f'https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/'
    response = requests.delete(url, headers=headers)
    if response.status_code == 204:
        print(f"Bridge '{slug}' deleted successfully")
    else:
        print(f"Error: {response.json()}")

# Example usage
delete_bridge('sales-bridge-001')

# Delete a bridge
curl -X DELETE "https://unpod.ai/api/v2/platform/telephony/bridges/sales-bridge-001/" \
  -H "Authorization: Token your-api-token" \
  -H "Org-Handle: your-org-handle"

Best Practices

Disconnect First: Always disconnect the provider from the bridge before deleting it
Irreversible: Deletion is permanent - verify the correct slug before proceeding
204 Response: A successful delete returns HTTP 204 with no body - handle this in your code
Error Handling: Handle 404 gracefully - the bridge may have already been deleted
Pre-check: Use Get Bridge by Slug to verify the bridge exists and check for active numbers before deletion
Security: Keep API tokens secure and rotate them regularly

Authorizations

Authorization

string

header

required

Format: Token

Headers

Org-Handle

string

required

Organization domain handle

Example:

"unpod.tv"

Path Parameters

slug

string

required

Example:

"sales-bridge-001"

Response

Bridge deleted successfully - No Content

Connect Provider to BridgeConnect a provider credential to a telephony bridge to add a number

Delete Bridge

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

import requests

url = "https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/"

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/bridges/{slug}/', 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/bridges/{slug}/",
  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/bridges/{slug}/"

	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/bridges/{slug}/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/")

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": "Bridge not found.",
  "errors": "No bridge exists with the provided slug"
}

Getting Started

API Lists

Delete Bridge

Delete Bridge

Path Parameters

Headers

Common Error Codes

Code Examples

Best Practices

Authorizations

Headers

Path Parameters

Response

​Delete Bridge

​Path Parameters

​Headers

​Common Error Codes

​Code Examples

​Best Practices

Authorizations

Headers

Path Parameters

Response

Delete Bridge

Path Parameters

Headers

Common Error Codes

Code Examples

Best Practices