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
Your API key for authentication.
Body Parameters
The unique identifier of the contact whose memory should be reset.
The persona ID for memory scoping. Either
persona_id or agent_number is required.The agent phone number for memory scoping. Either
persona_id or agent_number is required.Response
Success confirmation.
Whether the reset was successful.
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