Sign in

List memories

get/v1/memory_stores/{memory_store_id}/memories?beta=true

Path parameters

memory_store_idstring required

Path parameter memory_store_id

Query parameters

path_prefixstring

Optional path prefix filter. Must end with / (segment-aligned), e.g., /notes/. This value appears in request URLs. Do not include secrets or personally identifiable information.

depthinteger

0 (or omitted) returns all descendants below path_prefix (recursive). 1 returns immediate children only; deeper entries roll up as memory_prefix items. depth=1 behaves like ls; omitting depth behaves like find.

limitinteger

Maximum number of items to return per page. Must be between 1 and 100. Defaults to 20 when omitted. Capped at 20 when view=full. Both memory and memory_prefix items count toward the limit.

pagestring

Opaque pagination cursor (a page_... value). Pass the next_page value from a previous response to fetch the next page; omit for the first page.

view'basic' | 'full'

Selects which projection of a memory or memory_version the server returns. basic returns the object with content set to null; full populates content. When omitted, the default is endpoint-specific: retrieve operations default to full; list, create, and update operations default to basic. Listing with view=full caps limit at 20.

Which projection of each memory to return. Defaults to basic (content omitted). full populates content on each item and caps limit at 20; use this as the bulk-read path for export and sync.

Headers

x-api-keystring
anthropic-versionstring
anthropic-betastring

Response

Successful response (OK)

next_pagestring nullable

Opaque cursor for the next page (a page_... value), or null if there are no more results. Pass as page on the next request.

Changes

Changed in 4 of the 67 revisions of this API.423

  • d2b230555b7f2See the full diff
    • ▲

      response property data/items/oneOf[BetaManagedAgentsMemory]/content list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • ▲

      response property next_page list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

  • 83476c2e0dcd2See the full diff
    • ●

      deleted the query request parameter order

      request-parameter-removed

    • ●

      deleted the query request parameter order_by

      request-parameter-removed

  • 6edc6519fd3222See the full diff
    • ▲

      the data/items/oneOf[BetaManagedAgentsMemory]/created_at response's property type/format changed from string/date-time to / for status 200

      response-property-type-changed

    • ▲

      the data/items/oneOf[BetaManagedAgentsMemory]/updated_at response's property type/format changed from string/date-time to / for status 200

      response-property-type-changed

    • ○

      added BetaTimestamp to the data/items/oneOf[BetaManagedAgentsMemory]/created_at response property allOf list for the response status 200

      response-property-all-of-added

    • ○

      added BetaTimestamp to the data/items/oneOf[BetaManagedAgentsMemory]/updated_at response property allOf list for the response status 200

      response-property-all-of-added

  • 6811827071191See the full diff
    • ○

      endpoint added

      endpoint-added