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

# Update User Memory Data

> Update the metadata and summary information for a specific user within a memory.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

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

The unique identifier of the memory containing the user to update.

### Body Parameters

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

The phone number of the user to update within the memory.

**metadata** `string`

Updated metadata to associate with this user. Can include any key-value pairs relevant to your use case.

**summary** `string`

Updated summary text for this user's interactions.

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

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

### Response

**data** `object`

Response data confirming user update.

**data.message** `string`

Success message confirming user memory data was updated.

**data.user** `object`

The updated user object.

**data.user.id** `string`

Unique identifier for the user entry in the memory.

**data.user.memory\_id** `string`

The memory identifier this user belongs to.

**data.user.phone\_number** `string`

The phone number that was updated.

**data.user.metadata** `string`

The updated metadata text associated with this user.

**data.user.summary** `string`

The updated summary text for this user.

**data.user.created\_at** `string`

ISO timestamp when this user was originally added to the memory.

**data.user.call\_count** `number`

Number of calls associated with this user.

**data.user.last\_call\_at** `string|null`

ISO timestamp of the most recent call, or null if no calls yet.

**errors** `null`

Error array (null on success).

```json Response theme={null}
{
  "data": {
    "message": "User memory data updated successfully",
    "user": {
      "id": "11111111-2222-3333-4444-555566667777",
      "memory_id": "12345678-1234-1234-1234-123456789012",
      "phone_number": "+12345678900",
      "metadata": "Test here with string metadtata",
      "summary": "I'm thinking yeah...",
      "created_at": "2025-07-22T05:32:32.233Z",
      "call_count": 0,
      "last_call_at": null
    }
  },
  "errors": null
}
```

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

***

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.