Enable or Disable Memory

Enable or disable memory for a pathway or persona version.

POST /v1/memory/enable

Enable or Disable Memory

cURL

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
}
'

Response (pathway)

{
  "data": {
    "message": "Memory enabled successfully for pathway."
  },
  "errors": null
}

Headers

authorization · string · required

Your API key for authentication.

Body Parameters

Provide either pathway or persona identifiers (not both).

pathway_id · string

Pathway ID. Use with version_number and memory_enabled.

version_number · number

Pathway version number. Required when pathway_id is provided.

persona_id · string

Persona ID. Use with version_id and memory_enabled.

version_id · string

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

memory_enabled · boolean · required

Set to true to enable memory, false to disable.

Response

data · object

Success response data.

data.message · string

Success message.

errors · null

Error array (null on success).

Response (pathway)

{
  "data": {
    "message": "Memory enabled successfully for pathway."
  },
  "errors": null
}

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.