Redact Memory Version

Updated at:

Erases the body of the specified version. Irreversible and idempotent. Does not affect the current memory.

Prerequisites

Endpoint and authentication have been configured. For details, see API overview and authentication.

Endpoint

POST /memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact

Path parameters

ParameterRequiredTypeDescription
memory_store_idYesstringMemory store ID
memory_version_idYesstringVersion ID

Request example

curl -X POST "$AGENTSTUDIO_URL/memory_stores/memstore_xxx/memory_versions/memver_xxx/redact" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response

{
  "id": "memver_xxx",
  "type": "memory_version",
  "memory_store_id": "memstore_xxx",
  "memory_id": "mem_xxx",
  "operation": "modified",
  "path": "/notes/project.md",
  "created_at": "2026-09-17T08:30:00Z",
  "redacted_at": "2026-09-17T09:30:00Z"
}

Response fields

FieldTypeDescription
idstringVersion ID, in the format memver_xxx
typestringAlways memory_version
memory_store_idstringID of the memory store it belongs to
memory_idstringID of the corresponding memory
operationcreated / modified / deletedType of the operation that produced this version
pathstringPath in this version's snapshot
redacted_atstring | nullTime when the body was redacted; omitted or null if not redacted
created_atstringTime when the version was created, ISO 8601 UTC

Error codes

HTTP statusError codeDescription
401InvalidApiKeyAPI key missing, incorrect, or expired
403permission_errorInsufficient identity or resource access permissions
404not_found_errorResource does not exist or does not belong to the current workspace