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
| Parameter | Required | Type | Description |
|---|---|---|---|
memory_store_id | Yes | string | Memory store ID |
memory_version_id | Yes | string | Version 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
| Field | Type | Description |
|---|---|---|
id | string | Version ID, in the format memver_xxx |
type | string | Always memory_version |
memory_store_id | string | ID of the memory store it belongs to |
memory_id | string | ID of the corresponding memory |
operation | created / modified / deleted | Type of the operation that produced this version |
path | string | Path in this version's snapshot |
redacted_at | string | null | Time when the body was redacted; omitted or null if not redacted |
created_at | string | Time when the version was created, ISO 8601 UTC |
Error codes
| HTTP status | Error code | Description |
|---|---|---|
| 401 | InvalidApiKey | API key missing, incorrect, or expired |
| 403 | permission_error | Insufficient identity or resource access permissions |
| 404 | not_found_error | Resource does not exist or does not belong to the current workspace |
Is this page helpful?