Phone Numbers
Detach Phone Numbers from Persona
Detach one or more inbound phone numbers from a persona. Detached numbers will no longer use the persona’s configuration and will have their persona settings cleared.
POST
/
v1
/
personas
/
{persona_id}
/
inbound
/
detach
Detach Phone Numbers from Persona
curl --request POST \
--url https://api.bland.ai/v1/personas/{persona_id}/inbound/detach \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"inbound_numbers": [
"<string>"
]
}
'import requests
url = "https://api.bland.ai/v1/personas/{persona_id}/inbound/detach"
payload = { "inbound_numbers": ["<string>"] }
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({inbound_numbers: ['<string>']})
};
fetch('https://api.bland.ai/v1/personas/{persona_id}/inbound/detach', 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://api.bland.ai/v1/personas/{persona_id}/inbound/detach",
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([
'inbound_numbers' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$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://api.bland.ai/v1/personas/{persona_id}/inbound/detach"
payload := strings.NewReader("{\n \"inbound_numbers\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
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://api.bland.ai/v1/personas/{persona_id}/inbound/detach")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"inbound_numbers\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/personas/{persona_id}/inbound/detach")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"inbound_numbers\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "12345678-1234-1234-1234-123456789012",
"name": "Support Agent",
"user_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"created_at": "2025-09-23T15:13:36.348Z",
"updated_at": "2025-09-23T15:20:00.000Z"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "PERSONA_NOT_FOUND",
"message": "Persona not found or access denied"
}
]
}
Headers
Path Parameters
Body Parameters
Array of E.164 formatted phone numbers to detach from this persona. Only numbers currently attached to this persona will be affected.
Response
The updated persona object after detaching the specified numbers.
{
"data": {
"id": "12345678-1234-1234-1234-123456789012",
"name": "Support Agent",
"user_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"created_at": "2025-09-23T15:13:36.348Z",
"updated_at": "2025-09-23T15:20:00.000Z"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "PERSONA_NOT_FOUND",
"message": "Persona not found or access denied"
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Detach Phone Numbers from Persona
curl --request POST \
--url https://api.bland.ai/v1/personas/{persona_id}/inbound/detach \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"inbound_numbers": [
"<string>"
]
}
'import requests
url = "https://api.bland.ai/v1/personas/{persona_id}/inbound/detach"
payload = { "inbound_numbers": ["<string>"] }
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({inbound_numbers: ['<string>']})
};
fetch('https://api.bland.ai/v1/personas/{persona_id}/inbound/detach', 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://api.bland.ai/v1/personas/{persona_id}/inbound/detach",
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([
'inbound_numbers' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$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://api.bland.ai/v1/personas/{persona_id}/inbound/detach"
payload := strings.NewReader("{\n \"inbound_numbers\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
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://api.bland.ai/v1/personas/{persona_id}/inbound/detach")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"inbound_numbers\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/personas/{persona_id}/inbound/detach")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"inbound_numbers\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "12345678-1234-1234-1234-123456789012",
"name": "Support Agent",
"user_id": "12345678-1234-1234-1234-123456789012",
"inbound_numbers": [],
"created_at": "2025-09-23T15:13:36.348Z",
"updated_at": "2025-09-23T15:20:00.000Z"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "PERSONA_NOT_FOUND",
"message": "Persona not found or access denied"
}
]
}