Message

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/sitegpt-ai/json-schema/sitegpt-ai-message-schema.json",
  "title": "Message",
  "description": "One stored conversation turn. NORMAL_MESSAGE carries the visitor question plus the AI answer; USER_MESSAGE and AGENT_MESSAGE carry one side of a human conversation; SYSTEM_MESSAGE records events such as escalation.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/sitegpt-ai-openapi.json#/components/schemas/Message",
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "messageId": {
      "type": "string"
    },
    "messageType": {
      "type": "string",
      "description": "NORMAL_MESSAGE, USER_MESSAGE, AGENT_MESSAGE, or SYSTEM_MESSAGE."
    },
    "systemMessageType": {
      "type": [
        "string",
        "null"
      ],
      "description": "Set on SYSTEM_MESSAGE rows; null otherwise."
    },
    "question": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true,
          "properties": {
            "text": {
              "type": "string"
            },
            "timestamp": {
              "type": "string"
            }
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "answer": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true,
          "properties": {
            "text": {
              "type": "string"
            },
            "timestamp": {
              "type": "string"
            }
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "reaction": {
      "type": "string",
      "enum": [
        "POSITIVE",
        "NEGATIVE",
        "NEUTRAL"
      ]
    },
    "gptModel": {
      "type": [
        "string",
        "null"
      ],
      "description": "Public model label for AI answers; null on human turns."
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The page URL of each knowledge passage the AI was given for this answer, in retrieval order (best match first). A page with several passages appears several times. Answers sent through this API keep an empty string for each passage from uploaded files or text; answers from the chat widget leave those out."
    },
    "agentId": {
      "type": [
        "string",
        "null"
      ]
    },
    "agentName": {
      "type": [
        "string",
        "null"
      ]
    },
    "iconUrl": {
      "type": [
        "string",
        "null"
      ]
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time"
    }
  }
}