# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Anthropic Memory Stores API
  version: 1.0.0
extends: openapi/anthropic-memory-stores-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 14
- target: $.paths['/v1/memory_stores/{memory_store_id}/archive?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive a memory store
      effect: destructive
      questions:
      - How do I retire a memory store without deleting its contents?
      - Can archived memory stores still show up when I list stores?
      instructions:
      - text: Archive memory store {memory_store_id}.
        slots:
          memory_store_id: path.memory_store_id
      - text: Retire the agent memory store {memory_store_id} but keep it on record.
        slots:
          memory_store_id: path.memory_store_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}/memories/{memory_id}?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Read one memory from a store
      effect: read
      questions:
      - How can an app read back a single memory an agent saved?
      - Can I fetch just one memory's content by its ID?
      instructions:
      - text: Read memory {memory_id} from store {memory_store_id}.
        slots:
          memory_id: path.memory_id
          memory_store_id: path.memory_store_id
      - text: Get memory {memory_id} in store {memory_store_id} with view {view}.
        slots:
          memory_id: path.memory_id
          memory_store_id: path.memory_store_id
          view: query.view
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}/memories/{memory_id}?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Edit or rename a memory
      effect: write
      questions:
      - Can I rename a memory's path without changing its content?
      - How do I avoid overwriting a memory someone else just changed?
      instructions:
      - text: Replace the content of memory {memory_id} in store {memory_store_id} with {content}.
        slots:
          memory_id: path.memory_id
          memory_store_id: path.memory_store_id
          content: requestBody.content
      - text: Move memory {memory_id} in store {memory_store_id} to path {path}.
        slots:
          memory_id: path.memory_id
          memory_store_id: path.memory_store_id
          path: requestBody.path
      - text: Update memory {memory_id} in {memory_store_id} only if precondition {precondition} holds.
        slots:
          memory_id: path.memory_id
          memory_store_id: path.memory_store_id
          precondition: requestBody.precondition
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}/memories/{memory_id}?beta=true'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a memory
      effect: destructive
      questions:
      - How do I delete a single memory an agent wrote?
      - Can I make a delete fail if the memory changed since I last read it?
      instructions:
      - text: Delete memory {memory_id} from store {memory_store_id}.
        slots:
          memory_id: path.memory_id
          memory_store_id: path.memory_store_id
      - text: Delete memory {memory_id} in {memory_store_id} only if its SHA-256 is {expected_content_sha256}.
        slots:
          memory_id: path.memory_id
          memory_store_id: path.memory_store_id
          expected_content_sha256: query.expected_content_sha256
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}/memories?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the memories in a store
      effect: read
      questions:
      - What memories has my agent saved in a store?
      - Can I list only the memories under a folder like /notes/?
      - Is there a way to get immediate children only instead of everything below a path?
      instructions:
      - text: List the memories in store {memory_store_id}.
        slots:
          memory_store_id: path.memory_store_id
      - text: List memories under {path_prefix} in store {memory_store_id}.
        slots:
          path_prefix: query.path_prefix
          memory_store_id: path.memory_store_id
      - text: Show the top-level entries of {memory_store_id} at depth {depth}.
        slots:
          memory_store_id: path.memory_store_id
          depth: query.depth
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}/memories?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Write a new memory into a store
      effect: write
      questions:
      - How do I seed a memory store with a file before an agent runs?
      - What's the size limit for a new memory's content?
      instructions:
      - text: Create a memory at {path} in store {memory_store_id} containing {content}.
        slots:
          path: requestBody.path
          memory_store_id: path.memory_store_id
          content: requestBody.content
      - text: Save {content} as a new memory {path} in {memory_store_id}.
        slots:
          content: requestBody.content
          path: requestBody.path
          memory_store_id: path.memory_store_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Redact a past memory version
      effect: destructive
      questions:
      - How do I scrub sensitive content from an old version of a memory?
      - Can I remove what a memory used to say from its history?
      instructions:
      - text: Redact memory version {memory_version_id} in store {memory_store_id}.
        slots:
          memory_version_id: path.memory_version_id
          memory_store_id: path.memory_store_id
      - text: Scrub the content of historical version {memory_version_id} from {memory_store_id}.
        slots:
          memory_version_id: path.memory_version_id
          memory_store_id: path.memory_store_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a past memory version
      effect: read
      questions:
      - What did a memory look like at a specific earlier version?
      - Can I inspect a single change recorded in a memory's history?
      instructions:
      - text: Show memory version {memory_version_id} in store {memory_store_id}.
        slots:
          memory_version_id: path.memory_version_id
          memory_store_id: path.memory_store_id
      - text: Get historical version {memory_version_id} of a memory in {memory_store_id}.
        slots:
          memory_version_id: path.memory_version_id
          memory_store_id: path.memory_store_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}/memory_versions?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: List a store's memory change history
      effect: read
      questions:
      - Which session changed memories in a store, and when?
      - Can I audit memory changes made by one API key or service account?
      - What changes were made to one specific memory over time?
      instructions:
      - text: List memory versions in store {memory_store_id}.
        slots:
          memory_store_id: path.memory_store_id
      - text: List the change history of memory {memory_id} in store {memory_store_id}.
        slots:
          memory_id: query.memory_id
          memory_store_id: path.memory_store_id
      - text: List memory edits in {memory_store_id} made by session {session_id}.
        slots:
          memory_store_id: path.memory_store_id
          session_id: query.session_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a memory store
      effect: read
      questions:
      - What name, description and metadata does a memory store have?
      - Can I look up one memory store by its ID?
      instructions:
      - text: Show memory store {memory_store_id}.
        slots:
          memory_store_id: path.memory_store_id
      - text: Get the settings of memory store {memory_store_id}.
        slots:
          memory_store_id: path.memory_store_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename or retag a memory store
      effect: write
      questions:
      - Does renaming a memory store change its mount path slug?
      - How do I add or remove metadata keys on a store?
      instructions:
      - text: Rename memory store {memory_store_id} to {name}.
        slots:
          memory_store_id: path.memory_store_id
          name: requestBody.name
      - text: Set the description of store {memory_store_id} to {description}.
        slots:
          memory_store_id: path.memory_store_id
          description: requestBody.description
      - text: Patch metadata {metadata} on memory store {memory_store_id}.
        slots:
          metadata: requestBody.metadata
          memory_store_id: path.memory_store_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores/{memory_store_id}?beta=true'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a memory store
      effect: destructive
      questions:
      - How do I permanently delete a memory store?
      - Is deleting a memory store different from archiving it?
      instructions:
      - text: Delete memory store {memory_store_id}.
        slots:
          memory_store_id: path.memory_store_id
      - text: Permanently remove store {memory_store_id} and its memories.
        slots:
          memory_store_id: path.memory_store_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: List memory stores
      effect: read
      questions:
      - Which memory stores exist for my agents?
      - Can I find stores created within a date range?
      instructions:
      - text: List my memory stores.
      - text: List memory stores created after {created_after}.
        slots:
          created_after: query.created_at[gte]
      - text: 'List memory stores including archived ones: {include_archived}.'
        slots:
          include_archived: query.include_archived
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/memory_stores?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a memory store
      effect: write
      questions:
      - How do I give my agent persistent memory across sessions?
      - Can I tag a memory store with the end user it belongs to?
      instructions:
      - text: Create a memory store named {name}.
        slots:
          name: requestBody.name
      - text: Create store {name} described as {description} with metadata {metadata}.
        slots:
          name: requestBody.name
          description: requestBody.description
          metadata: requestBody.metadata
      method: generated
      generated: '2026-09-26'