POST

api

platform

telephony

bridges

{slug}

disconnect-provider

Disconnect Provider from Bridge

curl --request POST \
  --url https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/disconnect-provider/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Org-Handle: <org-handle>' \
  --data '
{
  "phone_number": "+1234567890"
}
'

import requests

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

payload = { "phone_number": "+1234567890" }
headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Org-Handle': '<org-handle>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({phone_number: '+1234567890'})
};

fetch('https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/disconnect-provider/', 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}/disconnect-provider/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phone_number' => '+1234567890'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"phone_number\": \"+1234567890\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/disconnect-provider/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_number\": \"+1234567890\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_number\": \"+1234567890\"\n}"

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

{
  "status_code": 200,
  "message": "Provider disconnected from bridge successfully.",
  "data": {
    "message": "Provider disconnected successfully",
    "bridge_slug": "sales-bridge-001"
  }
}

{
  "status_code": 400,
  "message": "Failed to disconnect provider.",
  "errors": "Phone number is not connected to this bridge"
}

{
  "status_code": 200,
  "message": "Provider disconnected from bridge successfully.",
  "data": {
    "message": "Provider disconnected successfully",
    "bridge_slug": "sales-bridge-001"
  }
}

{
  "status_code": 400,
  "message": "Failed to disconnect provider.",
  "errors": "Phone number is not connected to this bridge"
}

Disconnect Provider from Bridge

Disconnect a telephony provider from a specific bridge, removing the associated phone number from the bridge. Use this before deleting a bridge or reassigning a phone number to a different bridge.

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

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
Content-Type	string	Yes	`application/json`

You can get the Org-Handle by hitting the Get All Organizations API. The domain_handle field in the response is your Org-Handle.

Request Body

Field	Type	Required	Description
phone_number	string	Yes	Phone number (E.164 format) to remove from the bridge

Response Fields

Field	Type	Description
status_code	integer	HTTP status code
message	string	Response message
data	object	Disconnection result

Data Object Fields

Field	Type	Description
message	string	Success message
bridge_slug	string	The bridge slug the provider disconnected from

Common Error Codes

Status Code	Description
200	Success - Provider disconnected successfully
400	Bad Request - Phone number not connected or invalid
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',
  'Content-Type': 'application/json'
};

// Disconnect a provider from a bridge
const disconnectProviderFromBridge = async (slug, phoneNumber) => {
  const response = await axios.post(
    `https://unpod.ai/api/v2/platform/telephony/bridges/${slug}/disconnect-provider/`,
    { phone_number: phoneNumber },
    { headers }
  );
  console.log(`Provider disconnected from bridge: ${response.data.data.bridge_slug}`);
  return response.data.data;
};

// Example usage
disconnectProviderFromBridge('sales-bridge-001', '+1234567890');

import requests

headers = {
    'Authorization': 'Token your-api-token',
    'Org-Handle': 'your-org-handle',
    'Content-Type': 'application/json'
}

def disconnect_provider_from_bridge(slug: str, phone_number: str):
    """Disconnect a provider from a bridge"""
    url = f'https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/disconnect-provider/'
    payload = {'phone_number': phone_number}
    response = requests.post(url, headers=headers, json=payload)
    data = response.json()
    print(f"Provider disconnected from bridge: {data['data']['bridge_slug']}")
    return data['data']

# Example usage
disconnect_provider_from_bridge('sales-bridge-001', '+1234567890')

# Disconnect a provider from a bridge
curl -X POST "https://unpod.ai/api/v2/platform/telephony/bridges/sales-bridge-001/disconnect-provider/" \
  -H "Authorization: Token your-api-token" \
  -H "Org-Handle: your-org-handle" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+1234567890"
  }'

Best Practices

Pre-disconnect Check: Verify the phone number is currently connected using Get Bridge by Slug before disconnecting
Phone Number Format: Use E.164 format (e.g., +1234567890) for the phone_number field
Before Deletion: Always disconnect providers before deleting a bridge to ensure clean teardown
Error Handling: Handle 400 errors - the phone number may not be connected to the specified bridge
Service Disruption: Disconnecting an active number will stop calls routing through the bridge immediately
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"

Body

application/json

phone_number

string

required

Example:

"+1234567890"

Response

Provider disconnected from bridge

OverviewIntroduction to the Providers API

Disconnect Provider from Bridge

curl --request POST \
  --url https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/disconnect-provider/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Org-Handle: <org-handle>' \
  --data '
{
  "phone_number": "+1234567890"
}
'

import requests

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

payload = { "phone_number": "+1234567890" }
headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Org-Handle': '<org-handle>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({phone_number: '+1234567890'})
};

fetch('https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/disconnect-provider/', 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}/disconnect-provider/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phone_number' => '+1234567890'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"phone_number\": \"+1234567890\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/disconnect-provider/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_number\": \"+1234567890\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_number\": \"+1234567890\"\n}"

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

{
  "status_code": 200,
  "message": "Provider disconnected from bridge successfully.",
  "data": {
    "message": "Provider disconnected successfully",
    "bridge_slug": "sales-bridge-001"
  }
}

{
  "status_code": 400,
  "message": "Failed to disconnect provider.",
  "errors": "Phone number is not connected to this bridge"
}

Getting Started

API Lists

Disconnect Provider from Bridge

Disconnect Provider from Bridge

Path Parameters

Headers

Request Body

Response Fields

Data Object Fields

Common Error Codes

Code Examples

Best Practices

Authorizations

Headers

Path Parameters

Body

Response

​Disconnect Provider from Bridge

​Path Parameters

​Headers

​Request Body

​Response Fields

​Data Object Fields

​Common Error Codes

​Code Examples

​Best Practices

Authorizations

Headers

Path Parameters

Body

Response

Disconnect Provider from Bridge

Path Parameters

Headers

Request Body

Response Fields

Data Object Fields

Common Error Codes

Code Examples

Best Practices