Microsoft Copilot · Schema

ChatMessage

AgentsAI AssistantArtificial IntelligenceChatbotCopilotExtensibilityGenerative AIMicrosoft 365Productivity

Properties

Name Type Description
id string The unique identifier for the message.
body object
citations array Sources referenced in the Copilot response.
createdDateTime string The timestamp when the message was created.
View JSON Schema on GitHub

JSON Schema

microsoft-copilot-chatmessage-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/ChatMessage",
  "title": "ChatMessage",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier for the message.",
      "example": "abc123"
    },
    "body": {
      "type": "object",
      "properties": {
        "contentType": {
          "type": "string",
          "description": "The content type of the body (e.g., text, html)."
        },
        "content": {
          "type": "string",
          "description": "The text content of the Copilot response."
        }
      },
      "example": "example_value"
    },
    "citations": {
      "type": "array",
      "description": "Sources referenced in the Copilot response.",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "The title of the cited source."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The URL of the cited source."
          },
          "snippet": {
            "type": "string",
            "description": "A relevant snippet from the cited source."
          }
        }
      },
      "example": []
    },
    "createdDateTime": {
      "type": "string",
      "format": "date-time",
      "description": "The timestamp when the message was created.",
      "example": "2026-01-15T10:30:00Z"
    }
  }
}