Claude Platform Docs

Create a Memory

BetaManagedAgentsMemory beta().memoryStores().memories().create(params, requestOptions = RequestOptions.none())
POST/v1/memory_stores/{memory_store_id}/memories
Requires anthropic-beta: agent-memory-2026-07-22 or anthropic-beta: managed-agents-2026-04-01. Learn how to send beta headers.

Create a Memory

Parameters
MemoryCreateParams params
Optional<String> memoryStoreId⁠Path parameter

The ID of the memory store to create the memory in (memstore_...).

Optional<BetaManagedAgentsMemoryView> view⁠Query parameter

Whether a memory or memory_version in the response includes its content. Defaults to full on retrieve operations and to basic on list, create, and update operations.

With full, list operations return at most 20 items per page.

Optional<List<AnthropicBeta>> betas⁠Header parameter

This endpoint is in beta: requests must send agent-memory-2026-07-22 or managed-agents-2026-04-01 in this header.

COMPUTER_USE_2024_10_22("computer-use-2024-10-22")
COMPUTER_USE_2025_01_24("computer-use-2025-01-24")
OUTPUT_128K_2025_02_19("output-128k-2025-02-19")
MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")
MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")
DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")
INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")
CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")
CONTEXT_1M_2025_08_07("context-1m-2025-08-07")
CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")
MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")
FAST_MODE_2026_02_01("fast-mode-2026-02-01")
OUTPUT_300K_2026_03_24("output-300k-2026-03-24")
USER_PROFILES_2026_03_24("user-profiles-2026-03-24")
USER_PROFILES_2026_08_18("user-profiles-2026-08-18")
USER_PROFILES_2026_09_04("user-profiles-2026-09-04")
ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")
MANAGED_AGENTS_2026_04_01("managed-agents-2026-04-01")
DREAMING_2026_04_21("dreaming-2026-04-21")
THINKING_TOKEN_COUNT_2026_05_13("thinking-token-count-2026-05-13")
SERVER_SIDE_FALLBACK_2026_06_01("server-side-fallback-2026-06-01")
SERVER_SIDE_FALLBACK_2026_07_01("server-side-fallback-2026-07-01")
FALLBACK_CREDIT_2026_06_01("fallback-credit-2026-06-01")
FALLBACK_CREDIT_2026_07_01("fallback-credit-2026-07-01")
AGENT_MEMORY_2026_07_22("agent-memory-2026-07-22")
MID_CONVERSATION_TOOL_CHANGES_2026_07_01("mid-conversation-tool-changes-2026-07-01")
COMPACT_2026_01_12("compact-2026-01-12")
COMPUTER_USE_2025_11_24("computer-use-2025-11-24")
MCP_TUNNELS_2026_06_22("mcp-tunnels-2026-06-22")
STRUCTURED_OUTPUTS_2025_11_13("structured-outputs-2025-11-13")
TASK_BUDGETS_2026_03_13("task-budgets-2026-03-13")
THINKING_DISPLAY_UPDATES_2026_08_18("thinking-display-updates-2026-08-18")
MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01("mid-conversation-output-config-2026-07-01")
THINKING_BINDING_CONTROLS_2026_08_01("thinking-binding-controls-2026-08-01")
MID_CONVERSATION_SYSTEM_CLEAR_AT_2026_08_21("mid-conversation-system-clear-at-2026-08-21")
COMPACT_2026_09_04("compact-2026-09-04")
INLINE_TOOLS_2026_09_15("inline-tools-2026-09-15")
MCP_CLIENT_2026_09_15("mcp-client-2026-09-15")
CE_PLUGINS_2026_09_01("ce-plugins-2026-09-01")
SPEND_LIMIT_READS_2026_09_26("spend-limit-reads-2026-09-26")
TELEMETRY_DESTINATIONS_2026_08_11("telemetry-destinations-2026-08-11")
WEBHOOKS_2026_10_07("webhooks-2026-10-07")
ADMIN_USER_SIGN_OUT_2026_10_08("admin-user-sign-out-2026-10-08")
MESSAGE_THREADS_2026_08_12("message-threads-2026-08-12")
ANALYTICS_USAGE_COST_2026_08_24("analytics-usage-cost-2026-08-24")
EXPERIMENTAL_CLAUDE_TAG_2026_10_21("experimental-claude-tag-2026-10-21")
CE_CLAUDE_CODE_MANAGED_SETTINGS_2026_10_06("ce-claude-code-managed-settings-2026-10-06")
USER_PROFILES_BILLING_2026_10_01("user-profiles-billing-2026-10-01")
MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")⁠Deprecated
This value is no longer needed. Remove it from your requests.
PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")⁠Deprecated
This value is no longer needed. Remove it from your requests.
PDFS_2024_09_25("pdfs-2024-09-25")⁠Deprecated
This value is no longer needed. Remove it from your requests.
TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")⁠Deprecated
This value is no longer needed. Remove it from your requests.
TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")⁠Deprecated
This value is no longer needed. Remove it from your requests.
FILES_API_2025_04_14("files-api-2025-04-14")⁠Deprecated
Sending this value selects the beta response shapes. Removing it moves you to the current shapes, so follow the migration steps: https://platform.claude.com/docs/en/build-with-claude/files#migrate-from-files-api-2025-04-14
EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")⁠Deprecated
This value is no longer needed. Remove it from your requests.
SKILLS_2025_10_02("skills-2025-10-02")⁠Deprecated
Sending this value selects the beta response shapes. Removing it moves you to the current shapes, so follow the migration steps: https://platform.claude.com/docs/en/build-with-claude/skills-guide#migrate-from-skills-2025-10-02
CACHE_DIAGNOSIS_2026_04_07("cache-diagnosis-2026-04-07")⁠Deprecated
This value is no longer needed. Remove it from your requests.
CE_USER_MANAGEMENT_2026_07_13("ce-user-management-2026-07-13")⁠Deprecated
This value is no longer needed. Remove it from your requests.
Optional<String> workspaceId⁠Header parameter

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Optional<String> content

The UTF-8 text content of the new memory. Pass "" to create an empty memory.

The maximum size is 100 kB (102,400 bytes).

String path

The path of the new memory, such as /projects/foo/notes.md. Paths are case-sensitive.

A path starts with / and has 1 to 20 segments. A segment can't be empty and can't be . or ... A path can't contain control characters, format characters, or the line and paragraph separators U+2028 and U+2029. It must be in Unicode Normalization Form C and at most 1,024 bytes long.

minLength2
maxLength1024
pattern^(/[^/]+)+$
Returns
class BetaManagedAgentsMemory { type = "memory"; id; contentSha256; /* 7 more */ }

A text document at a path inside a memory store.

content is null when the response uses view=basic. content_size_bytes and content_sha256 are always set, so you can detect changes without fetching the content. To retrieve, update, or delete a memory, pass its ID, which stays the same when its path changes.

See the memory guide to learn more about working with memories.

JsonValue type = "memory"
String id

The unique ID of the memory (mem_...). It stays the same when the memory's path changes.

To retrieve, update, or delete the memory, pass this ID.

String contentSha256

Lowercase hex SHA-256 digest of the UTF-8 content bytes (64 characters). The server applies no normalization, so clients can compute the same hash locally for staleness checks and as the value for a content_sha256 precondition on update. Always populated, regardless of view.

int contentSizeBytes

The size of the memory's content in UTF-8 bytes. It is set regardless of view.

formatint32
OffsetDateTime createdAt

When this memory was created, in RFC 3339 format.

formatdate-time
String memoryStoreId

ID of the memory store this memory belongs to (a memstore_... value).

String memoryVersionId

The ID of the memory version that holds the memory's current content (memver_...).

Memory versions don't have a flag that marks the latest one. Compare their IDs with this field instead.

See the memory guide to learn more about memory versions.

String path

Hierarchical path of the memory within the store, e.g. /projects/foo/notes.md. Always starts with /. Paths are case-sensitive and unique within a store. Maximum 1,024 bytes.

OffsetDateTime updatedAt

When the memory was last changed, in RFC 3339.

To find out who made the change, look at created_by on the memory version that memory_version_id references.

formatdate-time
Optional<String> content

The memory's UTF-8 text content, or null when the response uses view=basic.

The maximum size is 100 kB (102,400 bytes).

Create a Memory
package com.anthropic.example;

import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.memorystores.memories.BetaManagedAgentsMemory;
import com.anthropic.models.beta.memorystores.memories.MemoryCreateParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        AnthropicClient client = AnthropicOkHttpClient.fromEnv();

        MemoryCreateParams params = MemoryCreateParams.builder()
            .memoryStoreId("memory_store_id")
            .content("content")
            .path("/P")
            .build();
        BetaManagedAgentsMemory betaManagedAgentsMemory = client.beta().memoryStores().memories().create(params);
    }
}
Returns Examples
Response 200
{
  "id": "id",
  "content_sha256": "content_sha256",
  "content_size_bytes": 0,
  "created_at": "2019-12-27T18:11:19.117Z",
  "memory_store_id": "memory_store_id",
  "memory_version_id": "memory_version_id",
  "path": "path",
  "type": "memory",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "content": "content"
}