Remove User from Memory
curl --request POST \
--url https://api.bland.ai/v1/memory/{memory_id}/user/delete \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"phone_number": "<string>",
"external_memory_key": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/memory/{memory_id}/user/delete"
payload = {
"phone_number": "<string>",
"external_memory_key": "<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({phone_number: '<string>', external_memory_key: '<string>'})
};
fetch('https://api.bland.ai/v1/memory/{memory_id}/user/delete', 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/memory/{memory_id}/user/delete",
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' => '<string>',
'external_memory_key' => '<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/memory/{memory_id}/user/delete"
payload := strings.NewReader("{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\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/memory/{memory_id}/user/delete")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/{memory_id}/user/delete")
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 \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"message": "User +1234567890 removed from memory successfully"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "Phone number is required."
}
]
}
{
"data": null,
"errors": [
{
"error": "MEMORY_REMOVE_USER_ERROR",
"message": "Failed to remove user from memory."
}
]
}
User Management
Remove User from Memory
Remove a specific user/phone number and all their associated data from a memory.
POST
/
v1
/
memory
/
{memory_id}
/
user
/
delete
Remove User from Memory
curl --request POST \
--url https://api.bland.ai/v1/memory/{memory_id}/user/delete \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"phone_number": "<string>",
"external_memory_key": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/memory/{memory_id}/user/delete"
payload = {
"phone_number": "<string>",
"external_memory_key": "<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({phone_number: '<string>', external_memory_key: '<string>'})
};
fetch('https://api.bland.ai/v1/memory/{memory_id}/user/delete', 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/memory/{memory_id}/user/delete",
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' => '<string>',
'external_memory_key' => '<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/memory/{memory_id}/user/delete"
payload := strings.NewReader("{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\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/memory/{memory_id}/user/delete")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/{memory_id}/user/delete")
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 \"phone_number\": \"<string>\",\n \"external_memory_key\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"message": "User +1234567890 removed from memory successfully"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "Phone number is required."
}
]
}
{
"data": null,
"errors": [
{
"error": "MEMORY_REMOVE_USER_ERROR",
"message": "Failed to remove user from memory."
}
]
}
Headers
Your API key for authentication.
Path Parameters
The unique identifier of the memory to remove the user from.
Body Parameters
The phone number of the user to remove from the memory.
Optional external key for additional memory validation or cross-referencing.
Response
Response data confirming user removal.
Success message confirming user was removed from memory.
Error array (null on success).
{
"data": {
"message": "User +1234567890 removed from memory successfully"
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "Phone number is required."
}
]
}
{
"data": null,
"errors": [
{
"error": "MEMORY_REMOVE_USER_ERROR",
"message": "Failed to remove user from memory."
}
]
}
⚠️ Warning
This action will permanently remove:- The user’s entry from the memory
- All associated metadata for this user
- The user’s summary and interaction history
- All call associations for this user within this memory
The actual calls will remain in your account, but their association with this memory will be removed.
Docs for agents: llms.txtWas this page helpful?
⌘I