Reset Contact Memory
curl --request POST \
--url https://api.bland.ai/v1/memory/reset \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"contact_id": "<string>",
"persona_id": "<string>",
"agent_number": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/memory/reset"
payload = {
"contact_id": "<string>",
"persona_id": "<string>",
"agent_number": "<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({contact_id: '<string>', persona_id: '<string>', agent_number: '<string>'})
};
fetch('https://api.bland.ai/v1/memory/reset', 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/reset",
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([
'contact_id' => '<string>',
'persona_id' => '<string>',
'agent_number' => '<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/reset"
payload := strings.NewReader("{\n \"contact_id\": \"<string>\",\n \"persona_id\": \"<string>\",\n \"agent_number\": \"<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/reset")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"contact_id\": \"<string>\",\n \"persona_id\": \"<string>\",\n \"agent_number\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/reset")
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 \"contact_id\": \"<string>\",\n \"persona_id\": \"<string>\",\n \"agent_number\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"success": true
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "BAD_REQUEST",
"message": "persona_id or agent_number is required"
}
]
}
Memory
Reset Contact Memory
Permanently delete all memory for a contact scoped to a specific persona or agent number. All conversation history, facts, summaries, and entities for that pair are removed. This cannot be undone.
POST
/
v1
/
memory
/
reset
Reset Contact Memory
curl --request POST \
--url https://api.bland.ai/v1/memory/reset \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"contact_id": "<string>",
"persona_id": "<string>",
"agent_number": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/memory/reset"
payload = {
"contact_id": "<string>",
"persona_id": "<string>",
"agent_number": "<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({contact_id: '<string>', persona_id: '<string>', agent_number: '<string>'})
};
fetch('https://api.bland.ai/v1/memory/reset', 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/reset",
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([
'contact_id' => '<string>',
'persona_id' => '<string>',
'agent_number' => '<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/reset"
payload := strings.NewReader("{\n \"contact_id\": \"<string>\",\n \"persona_id\": \"<string>\",\n \"agent_number\": \"<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/reset")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"contact_id\": \"<string>\",\n \"persona_id\": \"<string>\",\n \"agent_number\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/reset")
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 \"contact_id\": \"<string>\",\n \"persona_id\": \"<string>\",\n \"agent_number\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"success": true
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "BAD_REQUEST",
"message": "persona_id or agent_number is required"
}
]
}
This action is irreversible. All memory data (recent messages, summary, facts, entities) for this contact/persona pair will be permanently deleted.
Headers
string
required
Your API key for authentication.
Body Parameters
string
required
The unique identifier of the contact whose memory should be reset.
string
The persona ID for memory scoping. Either
persona_id or agent_number is required.string
The agent phone number for memory scoping. Either
persona_id or agent_number is required.Response
object
Success confirmation.
boolean
Whether the reset was successful.
null
Error array (null on success).
{
"data": {
"success": true
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "BAD_REQUEST",
"message": "persona_id or agent_number is required"
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I