Memory

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/waterr-ai/json-schema/waterr-ai-memory-schema.json",
  "title": "Memory",
  "description": "One remembered fact, held in the container named by its user_memory_tag. Every agent with memory on that runs a call under that tag is told it at the start of the call.",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/waterr-ai-api-openapi.yml#/components/schemas/Memory",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "user_memory_tag": {
      "type": "string"
    },
    "content": {
      "type": "string",
      "description": "One fact, one line."
    },
    "token_estimate": {
      "type": "integer"
    },
    "source": {
      "type": "string",
      "enum": [
        "meeting",
        "import",
        "api"
      ],
      "description": "`meeting` = learned on a call, `import` = added via POST /memories."
    },
    "source_scenario_id": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid",
      "description": "The agent that learned it, or that an import was attributed to."
    },
    "source_meeting_id": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid"
    },
    "external_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "The fact's id in the system it was imported from."
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}