> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable or Disable Memory

> Enable or disable memory for a pathway or persona version.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Body Parameters

Provide **either** pathway **or** persona identifiers (not both).

<ParamField body="pathway_id" type="string">
  Pathway ID. Use with `version_number` and `memory_enabled`.
</ParamField>

<ParamField body="version_number" type="number">
  Pathway version number. Required when `pathway_id` is provided.
</ParamField>

<ParamField body="persona_id" type="string">
  Persona ID. Use with `version_id` and `memory_enabled`.
</ParamField>

<ParamField body="version_id" type="string">
  Persona version ID (UUID). Required when `persona_id` is provided.
</ParamField>

<ParamField body="memory_enabled" type="boolean" required>
  Set to `true` to enable memory, `false` to disable.
</ParamField>

### Response

<ResponseField name="data" type="object">
  Success response data.
</ResponseField>

<ResponseField name="data.message" type="string">
  Success message.
</ResponseField>

<ResponseField name="errors" type="null">
  Error array (null on success).
</ResponseField>

<ResponseExample>
  ```json Response (pathway) theme={null}
  {
    "data": {
      "message": "Memory enabled successfully for pathway."
    },
    "errors": null
  }
  ```

  ```json Response (persona) theme={null}
  {
    "data": {
      "message": "Memory enabled successfully for persona."
    },
    "errors": null
  }
  ```

  ```json Missing or invalid body theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "INVALID_REQUEST",
        "message": "memory_enabled (boolean) is required."
      }
    ]
  }
  ```

  ```json Neither or both pathway/persona theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "INVALID_REQUEST",
        "message": "Exactly one of pathway_id or persona_id is required."
      }
    ]
  }
  ```

  ```json Not found / Forbidden theme={null}
  {
    "data": null,
    "errors": [
      {
        "error": "NOT_FOUND",
        "message": "Pathway not found."
      }
    ]
  }
  ```
</ResponseExample>

### 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](/llms.txt)