---
schema_version: "1"
id: abfca6d646ceb1405ae0f79e1dc9448ff6ace4eb167dda0e3d83319ab984ac8d
title: Update Memories
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/agentic-memory-context/references/agentic-memory-context-ref/agentic-memory-api-update-memories.md
canonical_url: https://developer.salesforce.com/docs/data/agentic-memory-context/references/agentic-memory-context-api-ref/agentic-memory-api-update-memories.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 2e4ef3e81f49899ab4c44ec7510a23ada1f809cd3e3dee682ae304d40f329406
products:
  - Agentic Memory & Context
  - Data 360 Developer Documentation
---
# Update Memories

Update the content of one or more existing memory entries. Identify each entry by its memory ID.

> **Note:** Update replaces the memory internally. Data 360 generates a new memory ID and deactivates the previous record.

**URI:** `/api/v1/agentic/memory`

**Format:** `application/json`

**HTTP Method:** `POST`

**Authentication:** Bearer JWT

## Query Parameters

| Parameter    | Type   | Required | Description                                                   |
| ------------ | ------ | -------- | ------------------------------------------------------------- |
| profile_id   | String | Yes      | Profile ID of the Individual or User.                         |
| profile_type | String | Yes      | Type of profile. Values: `individual`, `employee`.            |
| category     | String | Yes      | Partition key for the memory entries, such as `PROFILE_FACT`. |

## Request Headers

| Header        | Required | Description         |
| ------------- | -------- | ------------------- |
| Authorization | Yes      | Bearer JWT token.   |
| Content-Type  | Yes      | `application/json`. |

## Request Body Schema

| Field               | Type   | Required | Description                                  |
| ------------------- | ------ | -------- | -------------------------------------------- |
| memories            | Array  | Yes      | Memory entries to update. Minimum one entry. |
| memories[].memoryId | String | Yes      | Identifier of the memory entry to update.    |
| memories[].content  | String | Yes      | New memory content.                          |

### Example Request

```json
{
  "memories": [{ "memoryId": "mem_abc123", "content": "Prefers PST scheduling" }]
}
```

## Response Body Schema

| Field               | Type   | Description                         |
| ------------------- | ------ | ----------------------------------- |
| statusCode          | String | Operation status. Value: `updated`. |
| memories            | Array  | The updated memory entries.         |
| memories[].memoryId | String | Identifier of the memory entry.     |
| memories[].content  | String | Updated memory content.             |

### Example Response

**Status:** `200 OK`

```json
{
  "statusCode": "updated",
  "memories": [{ "memoryId": "mem_abc123", "content": "Prefers PST scheduling" }]
}
```

## Error Codes

| Status Code | Description                                                     |
| ----------- | --------------------------------------------------------------- |
| 400         | Bad Request. Invalid request format or missing required fields. |
| 401         | Unauthorized. Invalid or missing JWT token.                     |
| 404         | Not Found. The specified memory entry doesn't exist.            |
| 500         | Internal Server Error.                                          |