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."
    }
  ]
}

POST

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

string

required

Your API key for authentication.

Body Parameters

Provide either pathway or persona identifiers (not both).

string

Pathway ID. Use with version_number and memory_enabled.

number

Pathway version number. Required when pathway_id is provided.

string

Persona ID. Use with version_id and memory_enabled.

string

Persona version ID (UUID). Required when persona_id is provided.

boolean

required

Set to true to enable memory, false to disable.

Response

object

Success response data.

string

Success message.

null

Error array (null on success).

{
  "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

⌘I

Basic Tutorials

Calls

Conversational Pathways

Knowledge Bases

Numbers

Blocked Numbers

Widgets

Tools

Contacts

Memory

Node tests

Agent Testing

Evals

Guard Rails

Web Agents

Live Translation

Custom Twilio Accounts

Batches

Prompts

Account

Organizations

Messaging

SIP Trunks

Custom Dialing Pools

Personas

Citation Schemas

Alarms

Triage

Enable or Disable Memory

Headers

Body Parameters

Response

Behavior

​Headers

​Body Parameters

​Response

​Behavior

Headers

Body Parameters

Response

Behavior