> ## 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.

# Remove User from Memory

> Remove a specific user/phone number and all their associated data from a memory.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**memory\_id** `string` *required*

The unique identifier of the memory to remove the user from.

### Body Parameters

**phone\_number** `string` *required*

The phone number of the user to remove from the memory.

**external\_memory\_key** `string`

Optional external key for additional memory validation or cross-referencing.

### Response

**data** `object`

Response data confirming user removal.

**data.message** `string`

Success message confirming user was removed from memory.

**errors** `null`

Error array (null on success).

```json Response theme={null}
{
  "data": {
    "message": "User +1234567890 removed from memory successfully"
  },
  "errors": null
}
```

```json Missing Phone Number theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "INVALID_REQUEST",
      "message": "Phone number is required."
    }
  ]
}
```

```json Server Error theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "MEMORY_REMOVE_USER_ERROR",
      "message": "Failed to remove user from memory."
    }
  ]
}
```

### ⚠️ Warning

This action will permanently remove:

* The user's entry from the memory
* All associated metadata for this user
* The user's summary and interaction history
* All call associations for this user within this memory

## The actual calls will remain in your account, but their association with this memory will be removed.

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.