Update Memories

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

URI: /api/v1/agentic/memory

Format: application/json

HTTP Method: POST

Authentication: Bearer JWT

Query Parameters 

ParameterTypeRequiredDescription
profile_idStringYesProfile ID of the Individual or User.
profile_typeStringYesType of profile. Values: individual, employee.
categoryStringYesPartition key for the memory entries, such as PROFILE_FACT.

Request Headers 

HeaderRequiredDescription
AuthorizationYesBearer JWT token.
Content-TypeYesapplication/json.

Request Body Schema 

FieldTypeRequiredDescription
memoriesArrayYesMemory entries to update. Minimum one entry.
memories[].memoryIdStringYesIdentifier of the memory entry to update.
memories[].contentStringYesNew memory content.

Example Request 

1{
2  "memories": [{ "memoryId": "mem_abc123", "content": "Prefers PST scheduling" }]
3}

Response Body Schema 

FieldTypeDescription
statusCodeStringOperation status. Value: updated.
memoriesArrayThe updated memory entries.
memories[].memoryIdStringIdentifier of the memory entry.
memories[].contentStringUpdated memory content.

Example Response 

Status: 200 OK

1{
2  "statusCode": "updated",
3  "memories": [{ "memoryId": "mem_abc123", "content": "Prefers PST scheduling" }]
4}

Error Codes 

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