# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Relevance AI Endpoints User Memory API
  version: 1.0.0
extends: openapi/relevance-ai-user-memory-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: 3
- target: $.paths['/user-memory/upsert'].post
  update:
    x-apievangelist-phrasing:
      intent: Save or update a memory about me for an agent
      effect: write
      questions:
      - How do I make an agent remember something about me?
      - Can I set a category and importance on an agent's user memory?
      instructions:
      - text: 'Remember for agent {agent_id}: {text}.'
        slots:
          agent_id: requestBody.agent_id
          text: requestBody.text
      - text: Update memory {memory_id} for agent {agent_id} to say {text}.
        slots:
          memory_id: requestBody.memory_id
          agent_id: requestBody.agent_id
          text: requestBody.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user-memory/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a user memory
      effect: destructive
      questions:
      - How do I make an agent forget something it remembered about me?
      - Can I delete one stored user memory by ID?
      instructions:
      - text: Delete user memory {memory_id}.
        slots:
          memory_id: requestBody.memory_id
      - text: Forget the memory {memory_id}.
        slots:
          memory_id: requestBody.memory_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user-memory/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List what an agent remembers about me
      effect: read
      questions:
      - What does an agent remember about me?
      - Can I page through the user memories an agent has stored?
      instructions:
      - text: List my user memories for agent {agent_id}.
        slots:
          agent_id: requestBody.agent_id
      - text: Show page {page} of memories agent {agent_id} holds about me.
        slots:
          page: requestBody.page
          agent_id: requestBody.agent_id
      method: generated
      generated: '2026-09-26'