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
{
"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
{
"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. |