Redact a memory version
api/beta/memory_stores/memory_versions/redact
History
api/beta/memory_stores/memory_versions/redact Changed · +17 / -3 lines
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ## Returns - `BetaManagedAgentsMemoryVersion object` - A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status. + A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and are not deleted with the memory; each version is retained for at least the version retention period after it was written, unless the store itself is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status. - `id: string`
- `memory_id: string` - ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row. + ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the memory's retained versions, including the `deleted` row while the lineage is retained. - `memory_store_id: string`
api/beta/memory_stores/memory_versions/redact Changed · +30 / -31 lines
# Redact a memory version ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Redact a memory version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
---- -title: Redact a memory version -url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/redact ---- +# Redact a memory version -## Redact a memory version +**POST** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact` -**post** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact` - Redact a memory version -### Path Parameters +## Path parameters - `memory_store_id: string` - `memory_version_id: string` -### Header Parameters +## Headers - `"anthropic-beta": optional array of AnthropicBeta`
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +## Returns -- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }` +- `BetaManagedAgentsMemoryVersion object` A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
A timestamp in RFC 3339 format + format: date-time + - `memory_id: string` ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
- `type: "memory_version"` - - `"memory_version"` - - `content: optional string or null` The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set.
Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise. + format: int32 + - `created_by: optional BetaManagedAgentsActor` Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). - - `BetaManagedAgentsSessionActor object { session_id, type }` + - `BetaManagedAgentsSessionActor object` Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance. + minLength: 1 + - `type: "session_actor"` - - `"session_actor"` + - `BetaManagedAgentsAPIActor object` - - `BetaManagedAgentsAPIActor object { api_key_id, type }` - Attribution for a write made directly via the public API (outside of any session). - `api_key_id: string`
ID of the API key that performed the write. This identifies the key, not the secret. + minLength: 1 + - `type: "api_actor"` - - `"api_actor"` + - `BetaManagedAgentsUserActor object` - - `BetaManagedAgentsUserActor object { type, user_id }` - Attribution for a write made by a human user through the Anthropic Console. - `type: "user_actor"` - - `"user_actor"` - - `user_id: string` ID of the user who performed the write (a `user_...` value). - - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + minLength: 1 + - `BetaManagedAgentsServiceAccountActor object` + Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. - `service_account_id: string`
ID of the service account that performed the write (a `svac_...` value). + minLength: 1 + - `type: "service_account_actor"` - - `"service_account_actor"` - - `path: optional string or null` The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
A timestamp in RFC 3339 format + format: date-time + - `redacted_by: optional BetaManagedAgentsActor` Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve). -### Example +## Example -```http +```bash curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID/redact \ -X POST \ -H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +### Response (200) ```json {
api/beta/memory_stores/memory_versions/redact Changed · +15 / -1 lines
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
- `user_id: string` ID of the user who performed the write (a `user_...` value). + + - `BetaManagedAgentsServiceAccountActor object { service_account_id, type }` + + Attribution for a write made by a workload authenticated as a service account, for example via Workload Identity Federation. + + - `service_account_id: string` + + ID of the service account that performed the write (a `svac_...` value). + + - `type: "service_account_actor"` + + - `"service_account_actor"` - `path: optional string or null`
api/beta/memory_stores/memory_versions/redact First recorded · 228 lines, first recorded
## Redact a memory version ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Redact a memory version
url: https://platform.claude.com/docs/en/api/beta/memory_stores/memory_versions/redact
---
## Redact a memory version
**post** `/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`
Redact a memory version
### Path Parameters
- `memory_store_id: string`
- `memory_version_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Returns
- `BetaManagedAgentsMemoryVersion object { id, created_at, memory_id, 10 more }`
A `memory_version` object: one immutable, attributed row in a memory's append-only history. Every non-no-op mutation to a memory produces a new version. Versions belong to the store (not the individual memory) and persist after the memory is deleted. Retrieving a redacted version returns 200 with `content`, `path`, `content_size_bytes`, and `content_sha256` set to `null`; branch on `redacted_at`, not HTTP status.
- `id: string`
Unique identifier for this version (a `memver_...` value).
- `created_at: string`
A timestamp in RFC 3339 format
- `memory_id: string`
ID of the memory this version snapshots (a `mem_...` value). Remains valid after the memory is deleted; pass it as `memory_id` to [List memory versions](/docs/en/api/beta/memory_stores/memory_versions/list) to retrieve the full lineage including the `deleted` row.
- `memory_store_id: string`
ID of the memory store this version belongs to (a `memstore_...` value).
- `operation: BetaManagedAgentsMemoryVersionOperation`
The kind of mutation a `memory_version` records. Every non-no-op mutation to a memory appends exactly one version row with one of these values.
- `"created"`
- `"modified"`
- `"deleted"`
- `type: "memory_version"`
- `"memory_version"`
- `content: optional string or null`
The memory's UTF-8 text content as of this version. `null` when `view=basic`, when `operation` is `deleted`, or when `redacted_at` is set.
- `content_sha256: optional string or null`
Lowercase hex SHA-256 digest of `content` as of this version (64 characters). `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
- `content_size_bytes: optional number or null`
Size of `content` in bytes as of this version. `null` when `redacted_at` is set or `operation` is `deleted`. Populated regardless of `view` otherwise.
- `created_by: optional BetaManagedAgentsActor`
Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
- `BetaManagedAgentsSessionActor object { session_id, type }`
Attribution for a write made by an agent during a session, through the mounted filesystem at `/mnt/memory/`.
- `session_id: string`
ID of the session that performed the write (a `sesn_...` value). Look up the session via [Retrieve a session](/docs/en/api/sessions-retrieve) for further provenance.
- `type: "session_actor"`
- `"session_actor"`
- `BetaManagedAgentsAPIActor object { api_key_id, type }`
Attribution for a write made directly via the public API (outside of any session).
- `api_key_id: string`
ID of the API key that performed the write. This identifies the key, not the secret.
- `type: "api_actor"`
- `"api_actor"`
- `BetaManagedAgentsUserActor object { type, user_id }`
Attribution for a write made by a human user through the Anthropic Console.
- `type: "user_actor"`
- `"user_actor"`
- `user_id: string`
ID of the user who performed the write (a `user_...` value).
- `path: optional string or null`
The memory's path at the time of this write. `null` if and only if `redacted_at` is set.
- `redacted_at: optional string or null`
A timestamp in RFC 3339 format
- `redacted_by: optional BetaManagedAgentsActor`
Identifies who performed a write or redact operation. Captured at write time on the `memory_version` row. The API key that created a session is not recorded on agent writes; attribution answers who made the write, not who is ultimately responsible. Look up session provenance separately via the [Sessions API](/docs/en/api/sessions-retrieve).
### Example
```http
curl https://api.anthropic.com/v1/memory_stores/$MEMORY_STORE_ID/memory_versions/$MEMORY_VERSION_ID/redact \
-X POST \
-H 'anthropic-version: 2023-06-01' \
-H 'anthropic-beta: agent-memory-2026-07-22' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
#### Response
```json
{
"id": "id",
"created_at": "2019-12-27T18:11:19.117Z",
"memory_id": "memory_id",
"memory_store_id": "memory_store_id",
"operation": "created",
"type": "memory_version",
"content": "content",
"content_sha256": "content_sha256",
"content_size_bytes": 0,
"created_by": {
"session_id": "x",
"type": "session_actor"
},
"path": "path",
"redacted_at": "2019-12-27T18:11:19.117Z",
"redacted_by": {
"session_id": "x",
"type": "session_actor"
}
}
```