Class: Anthropic::Resources::Beta::MemoryStores::Memories

Inherits:
Object
  • Object
show all
Defined in:
lib/anthropic/resources/beta/memory_stores/memories.rb,
sig/anthropic/resources/beta/memory_stores/memories.rbs

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ Memories

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Memories.

Parameters:



231
232
233
 
# File 'lib/anthropic/resources/beta/memory_stores/memories.rb', line 231

def initialize(client:)
  @client = client
end

Instance Method Details

#create(memory_store_id, content:, path:, view: nil, betas: nil, workspace_id: nil, request_options: {}) ⇒ Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsMemory

Create a memory

Some parameter documentations has been truncated, see Models::Beta::MemoryStores::MemoryCreateParams for more details.

Parameters:

  • memory_store_id (String) —

    Path param: Path parameter memory_store_id

  • content (String, nil) —

    Body param: UTF-8 text content for the new memory. Maximum 100 kB (102,400 bytes

  • path (String) —

    Body param: Hierarchical path for the new memory, e.g. /projects/foo/notes.md.

  • view (Symbol, Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsMemoryView) —

    Query param: Query parameter for view

  • betas (Array<String, Symbol, Anthropic::Models::AnthropicBeta>) —

    Header param: Optional header to specify the beta version(s) you want to use.

  • workspace_id (String) —

    Header param: Optional header to select the Workspace for this request. The valu

  • request_options (Anthropic::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
 
# File 'lib/anthropic/resources/beta/memory_stores/memories.rb', line 32

def create(memory_store_id, params)
  query_params = [:view]
  header_params = {betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"}
  parsed, options = Anthropic::Beta::MemoryStores::MemoryCreateParams.dump_request(params)
  query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
  @client.request(
    method: :post,
    path: ["v1/memory_stores/%1$s/memories?beta=true", memory_store_id],
    query: query,
    headers: parsed.slice(*header_params.keys).transform_keys(header_params),
    body: parsed.except(*query_params, *header_params.keys),
    model: Anthropic::Beta::MemoryStores::BetaManagedAgentsMemory,
    options: {extra_headers: {"anthropic-beta" => "agent-memory-2026-07-22"}, **options}
  )
end

#delete(memory_id, memory_store_id:, expected_content_sha256: nil, betas: nil, workspace_id: nil, request_options: {}) ⇒ Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsDeletedMemory

Delete a memory

Some parameter documentations has been truncated, see Models::Beta::MemoryStores::MemoryDeleteParams for more details.

Parameters:

  • memory_id (String) —

    Path param: Path parameter memory_id

  • memory_store_id (String) —

    Path param: Path parameter memory_store_id

  • expected_content_sha256 (String) —

    Query param: Query parameter for expected_content_sha256

  • betas (Array<String, Symbol, Anthropic::Models::AnthropicBeta>) —

    Header param: Optional header to specify the beta version(s) you want to use.

  • workspace_id (String) —

    Header param: Optional header to select the Workspace for this request. The valu

  • request_options (Anthropic::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
 
# File 'lib/anthropic/resources/beta/memory_stores/memories.rb', line 207

def delete(memory_id, params)
  query_params = [:expected_content_sha256]
  parsed, options = Anthropic::Beta::MemoryStores::MemoryDeleteParams.dump_request(params)
  query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
  memory_store_id =
    parsed.delete(:memory_store_id) do
      raise ArgumentError.new("missing required path argument #{_1}")
    end
  @client.request(
    method: :delete,
    path: ["v1/memory_stores/%1$s/memories/%2$s?beta=true", memory_store_id, memory_id],
    query: query,
    headers: parsed.except(*query_params).transform_keys(
      betas: "anthropic-beta",
      workspace_id: "anthropic-workspace-id"
    ),
    model: Anthropic::Beta::MemoryStores::BetaManagedAgentsDeletedMemory,
    options: {extra_headers: {"anthropic-beta" => "agent-memory-2026-07-22"}, **options}
  )
end

#list(memory_store_id, depth: nil, limit: nil, page: nil, path_prefix: nil, view: nil, betas: nil, workspace_id: nil, request_options: {}) ⇒ Anthropic::Internal::PageCursor<Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsMemory, Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsMemoryPrefix>

List memories

Some parameter documentations has been truncated, see Models::Beta::MemoryStores::MemoryListParams for more details.

Parameters:

  • memory_store_id (String) —

    Path param: Path parameter memory_store_id

  • depth (Integer) —

    Query param: 0 (or omitted) returns all descendants below path_prefix (recur

  • limit (Integer) —

    Query param: Maximum number of items to return per page. Must be between 1 and 1

  • page (String) —

    Query param: Opaque pagination cursor (a page_... value). Pass the next_page

  • path_prefix (String) —

    Query param: Optional path prefix filter. Must end with / (segment-aligned), e

  • view (Symbol, Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsMemoryView) —

    Query param: Which projection of each memory to return. Defaults to basic (c

  • betas (Array<String, Symbol, Anthropic::Models::AnthropicBeta>) —

    Header param: Optional header to specify the beta version(s) you want to use.

  • workspace_id (String) —

    Header param: Optional header to select the Workspace for this request. The valu

  • request_options (Anthropic::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
 
# File 'lib/anthropic/resources/beta/memory_stores/memories.rb', line 167

def list(memory_store_id, params = {})
  query_params = [:depth, :limit, :page, :path_prefix, :view]
  parsed, options = Anthropic::Beta::MemoryStores::MemoryListParams.dump_request(params)
  query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
  @client.request(
    method: :get,
    path: ["v1/memory_stores/%1$s/memories?beta=true", memory_store_id],
    query: query,
    headers: parsed.except(*query_params).transform_keys(
      betas: "anthropic-beta",
      workspace_id: "anthropic-workspace-id"
    ),
    page: Anthropic::Internal::PageCursor,
    model: Anthropic::Beta::MemoryStores::BetaManagedAgentsMemoryListItem,
    options: {extra_headers: {"anthropic-beta" => "agent-memory-2026-07-22"}, **options}
  )
end

#retrieve(memory_id, memory_store_id:, view: nil, betas: nil, workspace_id: nil, request_options: {}) ⇒ Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsMemory

Retrieve a memory

Some parameter documentations has been truncated, see Models::Beta::MemoryStores::MemoryRetrieveParams for more details.

Parameters:

Returns:

See Also:



70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/anthropic/resources/beta/memory_stores/memories.rb', line 70

def retrieve(memory_id, params)
  query_params = [:view]
  parsed, options = Anthropic::Beta::MemoryStores::MemoryRetrieveParams.dump_request(params)
  query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
  memory_store_id =
    parsed.delete(:memory_store_id) do
      raise ArgumentError.new("missing required path argument #{_1}")
    end
  @client.request(
    method: :get,
    path: ["v1/memory_stores/%1$s/memories/%2$s?beta=true", memory_store_id, memory_id],
    query: query,
    headers: parsed.except(*query_params).transform_keys(
      betas: "anthropic-beta",
      workspace_id: "anthropic-workspace-id"
    ),
    model: Anthropic::Beta::MemoryStores::BetaManagedAgentsMemory,
    options: {extra_headers: {"anthropic-beta" => "agent-memory-2026-07-22"}, **options}
  )
end

#update(memory_id, memory_store_id:, view: nil, content: nil, path: nil, precondition: nil, betas: nil, workspace_id: nil, request_options: {}) ⇒ Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsMemory

Update a memory

Some parameter documentations has been truncated, see Models::Beta::MemoryStores::MemoryUpdateParams for more details.

Parameters:

  • memory_id (String) —

    Path param: Path parameter memory_id

  • memory_store_id (String) —

    Path param: Path parameter memory_store_id

  • view (Symbol, Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsMemoryView) —

    Query param: Query parameter for view

  • content (String, nil) —

    Body param: New UTF-8 text content for the memory. Maximum 100 kB (102,400 bytes

  • path (String, nil) —

    Body param: New path for the memory (a rename). Must start with /, contain at

  • precondition (Anthropic::Models::Beta::MemoryStores::BetaManagedAgentsPrecondition) —

    Body param: Optimistic-concurrency precondition: the update applies only if the

  • betas (Array<String, Symbol, Anthropic::Models::AnthropicBeta>) —

    Header param: Optional header to specify the beta version(s) you want to use.

  • workspace_id (String) —

    Header param: Optional header to select the Workspace for this request. The valu

  • request_options (Anthropic::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
 
# File 'lib/anthropic/resources/beta/memory_stores/memories.rb', line 119

def update(memory_id, params)
  query_params = [:view]
  header_params = {betas: "anthropic-beta", workspace_id: "anthropic-workspace-id"}
  parsed, options = Anthropic::Beta::MemoryStores::MemoryUpdateParams.dump_request(params)
  query = Anthropic::Internal::Util.encode_query_params(parsed.slice(*query_params))
  memory_store_id =
    parsed.delete(:memory_store_id) do
      raise ArgumentError.new("missing required path argument #{_1}")
    end
  @client.request(
    method: :post,
    path: ["v1/memory_stores/%1$s/memories/%2$s?beta=true", memory_store_id, memory_id],
    query: query,
    headers: parsed.slice(*header_params.keys).transform_keys(header_params),
    body: parsed.except(*query_params, *header_params.keys),
    model: Anthropic::Beta::MemoryStores::BetaManagedAgentsMemory,
    options: {extra_headers: {"anthropic-beta" => "agent-memory-2026-07-22"}, **options}
  )
end