Memory
Enable or Disable Memory
Enable or disable memory for a pathway or persona version.
POST
/
v1
/
memory
/
enable
Enable or Disable Memory
curl --request POST \
--url https://api.bland.ai/v1/memory/enable \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"pathway_id": "<string>",
"version_number": 123,
"persona_id": "<string>",
"version_id": "<string>",
"memory_enabled": true
}
'import requests
url = "https://api.bland.ai/v1/memory/enable"
payload = {
"pathway_id": "<string>",
"version_number": 123,
"persona_id": "<string>",
"version_id": "<string>",
"memory_enabled": True
}
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({
pathway_id: '<string>',
version_number: 123,
persona_id: '<string>',
version_id: '<string>',
memory_enabled: true
})
};
fetch('https://api.bland.ai/v1/memory/enable', 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/enable",
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([
'pathway_id' => '<string>',
'version_number' => 123,
'persona_id' => '<string>',
'version_id' => '<string>',
'memory_enabled' => true
]),
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/enable"
payload := strings.NewReader("{\n \"pathway_id\": \"<string>\",\n \"version_number\": 123,\n \"persona_id\": \"<string>\",\n \"version_id\": \"<string>\",\n \"memory_enabled\": true\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/enable")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"pathway_id\": \"<string>\",\n \"version_number\": 123,\n \"persona_id\": \"<string>\",\n \"version_id\": \"<string>\",\n \"memory_enabled\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/enable")
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 \"pathway_id\": \"<string>\",\n \"version_number\": 123,\n \"persona_id\": \"<string>\",\n \"version_id\": \"<string>\",\n \"memory_enabled\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"message": "Memory enabled successfully for pathway."
},
"errors": null
}
{
"data": {
"message": "Memory enabled successfully for persona."
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "memory_enabled (boolean) is required."
}
]
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "Exactly one of pathway_id or persona_id is required."
}
]
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Pathway not found."
}
]
}
Headers
Body Parameters
Provide either pathway or persona identifiers (not both).Response
{
"data": {
"message": "Memory enabled successfully for pathway."
},
"errors": null
}
{
"data": {
"message": "Memory enabled successfully for persona."
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "memory_enabled (boolean) is required."
}
]
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "Exactly one of pathway_id or persona_id is required."
}
]
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Pathway not found."
}
]
}
Behavior
When memory is enabled, the system automatically refreshes entity schemas in the background — no additional action required. From that point on, memory is populated automatically on every call or SMS conversation that runs through the pathway or persona version. When memory is disabled, no new memory is written. Existing memory data is preserved.Docs for agents: llms.txt
Was this page helpful?
⌘I
Enable or Disable Memory
curl --request POST \
--url https://api.bland.ai/v1/memory/enable \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"pathway_id": "<string>",
"version_number": 123,
"persona_id": "<string>",
"version_id": "<string>",
"memory_enabled": true
}
'import requests
url = "https://api.bland.ai/v1/memory/enable"
payload = {
"pathway_id": "<string>",
"version_number": 123,
"persona_id": "<string>",
"version_id": "<string>",
"memory_enabled": True
}
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({
pathway_id: '<string>',
version_number: 123,
persona_id: '<string>',
version_id: '<string>',
memory_enabled: true
})
};
fetch('https://api.bland.ai/v1/memory/enable', 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/enable",
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([
'pathway_id' => '<string>',
'version_number' => 123,
'persona_id' => '<string>',
'version_id' => '<string>',
'memory_enabled' => true
]),
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/enable"
payload := strings.NewReader("{\n \"pathway_id\": \"<string>\",\n \"version_number\": 123,\n \"persona_id\": \"<string>\",\n \"version_id\": \"<string>\",\n \"memory_enabled\": true\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/enable")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"pathway_id\": \"<string>\",\n \"version_number\": 123,\n \"persona_id\": \"<string>\",\n \"version_id\": \"<string>\",\n \"memory_enabled\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/memory/enable")
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 \"pathway_id\": \"<string>\",\n \"version_number\": 123,\n \"persona_id\": \"<string>\",\n \"version_id\": \"<string>\",\n \"memory_enabled\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"message": "Memory enabled successfully for pathway."
},
"errors": null
}
{
"data": {
"message": "Memory enabled successfully for persona."
},
"errors": null
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "memory_enabled (boolean) is required."
}
]
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "Exactly one of pathway_id or persona_id is required."
}
]
}
{
"data": null,
"errors": [
{
"error": "NOT_FOUND",
"message": "Pathway not found."
}
]
}