microsoft.graph.engagementConversationMessage

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-graph/json-schema/microsoft-graph-microsoft-graph-engagement-conversation-message-schema.json",
  "title": "microsoft.graph.engagementConversationMessage",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-graph-communications-cloudcommunications-functions-api-openapi.yml#/components/schemas/microsoft.graph.engagementConversationMessage",
  "allOf": [
    {
      "$ref": "#/$defs/microsoft.graph.entity"
    },
    {
      "title": "engagementConversationMessage",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "body": {
          "$ref": "#/$defs/microsoft.graph.itemBody"
        },
        "createdDateTime": {
          "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
          "type": "string",
          "description": "The date and time when the message was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.",
          "format": "date-time",
          "readOnly": true
        },
        "creationMode": {
          "$ref": "#/$defs/microsoft.graph.engagementCreationMode"
        },
        "from": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.engagementIdentitySet"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Identity of the sender of the message."
        },
        "lastModifiedDateTime": {
          "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
          "type": "string",
          "description": "The date and time when message was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.",
          "format": "date-time",
          "readOnly": true
        },
        "replyToId": {
          "type": [
            "string",
            "null"
          ],
          "description": "The ID of the parent message to which this message is a reply, if applicable."
        },
        "conversation": {
          "$ref": "#/$defs/microsoft.graph.engagementConversation"
        },
        "reactions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.engagementConversationMessageReaction"
          },
          "description": "A collection of reactions (such as like and smile) that users have applied to this message.",
          "x-ms-navigationProperty": true
        },
        "replies": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.engagementConversationMessage"
          },
          "description": "A collection of messages that are replies to this message and form a threaded discussion.",
          "x-ms-navigationProperty": true
        },
        "replyTo": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.engagementConversationMessage"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "The parent message to which this message is a reply, if it is part of a reply chain.",
          "x-ms-navigationProperty": true
        },
        "@odata.type": {
          "type": "string"
        }
      },
      "description": "A Viva Engage conversation message."
    }
  ],
  "$defs": {
    "microsoft.graph.bodyType": {
      "title": "bodyType",
      "enum": [
        "text",
        "html"
      ],
      "type": "string"
    },
    "microsoft.graph.engagementConversation": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "engagementConversation",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "creationMode": {
              "$ref": "#/$defs/microsoft.graph.engagementCreationMode"
            },
            "starterId": {
              "type": "string",
              "description": "The unique ID of the first message in a Viva Engage conversation."
            },
            "messages": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.engagementConversationMessage"
              },
              "description": "The messages in a Viva Engage conversation.",
              "x-ms-navigationProperty": true
            },
            "starter": {
              "$ref": "#/$defs/microsoft.graph.engagementConversationMessage"
            },
            "@odata.type": {
              "type": "string"
            }
          },
          "description": "Represents a conversation in Viva Engage."
        }
      ]
    },
    "microsoft.graph.engagementConversationMessage": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "engagementConversationMessage",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "body": {
              "$ref": "#/$defs/microsoft.graph.itemBody"
            },
            "createdDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": "string",
              "description": "The date and time when the message was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.",
              "format": "date-time",
              "readOnly": true
            },
            "creationMode": {
              "$ref": "#/$defs/microsoft.graph.engagementCreationMode"
            },
            "from": {
              "anyOf": [
                {
                  "$ref": "#/$defs/microsoft.graph.engagementIdentitySet"
                },
                {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              ],
              "description": "Identity of the sender of the message."
            },
            "lastModifiedDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": "string",
              "description": "The date and time when message was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.",
              "format": "date-time",
              "readOnly": true
            },
            "replyToId": {
              "type": [
                "string",
                "null"
              ],
              "description": "The ID of the parent message to which this message is a reply, if applicable."
            },
            "conversation": {
              "$ref": "#/$defs/microsoft.graph.engagementConversation"
            },
            "reactions": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.engagementConversationMessageReaction"
              },
              "description": "A collection of reactions (such as like and smile) that users have applied to this message.",
              "x-ms-navigationProperty": true
            },
            "replies": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.engagementConversationMessage"
              },
              "description": "A collection of messages that are replies to this message and form a threaded discussion.",
              "x-ms-navigationProperty": true
            },
            "replyTo": {
              "anyOf": [
                {
                  "$ref": "#/$defs/microsoft.graph.engagementConversationMessage"
                },
                {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              ],
              "description": "The parent message to which this message is a reply, if it is part of a reply chain.",
              "x-ms-navigationProperty": true
            },
            "@odata.type": {
              "type": "string"
            }
          },
          "description": "A Viva Engage conversation message."
        }
      ]
    },
    "microsoft.graph.engagementConversationMessageReaction": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "engagementConversationMessageReaction",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "createdDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": "string",
              "description": "Date and time when the reaction was added. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.",
              "format": "date-time",
              "readOnly": true
            },
            "reactionBy": {
              "$ref": "#/$defs/microsoft.graph.engagementIdentitySet"
            },
            "reactionType": {
              "$ref": "#/$defs/microsoft.graph.engagementConversationMessageReactionType"
            },
            "@odata.type": {
              "type": "string"
            }
          },
          "description": "A reaction to a conversation message."
        }
      ],
      "x-ms-discriminator-value": "#microsoft.graph.engagementConversationMessageReaction"
    },
    "microsoft.graph.engagementConversationMessageReactionType": {
      "title": "engagementConversationMessageReactionType",
      "enum": [
        "like",
        "love",
        "celebrate",
        "thank",
        "laugh",
        "sad",
        "happy",
        "excited",
        "smile",
        "silly",
        "intenseLaugh",
        "starStruck",
        "goofy",
        "thinking",
        "surprised",
        "mindBlown",
        "scared",
        "crying",
        "shocked",
        "angry",
        "agree",
        "praise",
        "takingNotes",
        "heartBroken",
        "support",
        "confirmed",
        "watching",
        "brain",
        "medal",
        "bullseye",
        "unknownFutureValue"
      ],
      "type": "string",
      "description": "Types of reactions to conversation messages.",
      "x-ms-enum": {
        "name": "engagementConversationMessageReactionType",
        "modelAsString": false,
        "values": [
          {
            "value": "like",
            "description": "Like reaction, represented as a thumbs-up hand. A positive sentiment.",
            "name": "like"
          },
          {
            "value": "love",
            "description": "Love reaction, represented as a solid heart shape. A very positive sentiment.",
            "name": "love"
          },
          {
            "value": "celebrate",
            "description": "Celebrate reaction, represented as a party hat. A positive sentiment.",
            "name": "celebrate"
          },
          {
            "value": "thank",
            "description": "Thank reaction, represented as applauding hands. A positive sentiment.",
            "name": "thank"
          },
          {
            "value": "laugh",
            "description": "Laugh reaction, represented as a grinning face. A positive sentiment.",
            "name": "laugh"
          },
          {
            "value": "sad",
            "description": "Sad reaction, represented as a frowning face. A sympathetic sentiment.",
            "name": "sad"
          },
          {
            "value": "happy",
            "description": "Happy reaction, represented as an open mouth smile face. A very positive sentiment.",
            "name": "happy"
          },
          {
            "value": "excited",
            "description": "Excited reaction, represented as a face with closed eyes and a big smile. A very positive sentiment.",
            "name": "excited"
          },
          {
            "value": "smile",
            "description": "Smiling reaction, represented as a face with a small smile. A positive sentiment.",
            "name": "smile"
          },
          {
            "value": "silly",
            "description": "Silly reaction, represented as an upside down smiling face. A positive sentiment.",
            "name": "silly"
          },
          {
            "value": "intenseLaugh",
            "description": "Intense laughter reaction, represented as a crying laughing face. A very positive sentiment.",
            "name": "intenseLaugh"
          },
          {
            "value": "starStruck",
            "description": "Star struck reaction, represented as a face with stars for eyes. A very positive sentiment.",
            "name": "starStruck"
          },
          {
            "value": "goofy",
            "description": "Goofy reaction, represented as a face with tongue sticking out of mouth. A positive sentiment.",
            "name": "goofy"
          },
          {
            "value": "thinking",
            "description": "Thinking reaction, represented as a face with a hand on the chin. A neutral sentiment.",
            "name": "thinking"
          },
          {
            "value": "surprised",
            "description": "Surprised reaction, represented as a face with its mouth open. A neutral sentiment.",
            "name": "surprised"
          },
          {
            "value": "mindBlown",
            "description": "Mind blown reaction, represented as a face with its head covered in an exploding cloud. A positive sentiment.",
            "name": "mindBlown"
          },
          {
            "value": "scared",
            "description": "Scared reaction, represented as a face with fearful look. A negative sentiment.",
            "name": "scared"
          },
          {
            "value": "crying",
            "description": "Crying reaction, represented as a face with tears streaming down. A negative sentiment.",
            "name": "crying"
          },
          {
            "value": "shocked",
            "description": "Shocked reaction, represented as a face with two hands against cheeks and mouth open. A negative sentiment.",
            "name": "shocked"
          },
          {
            "value": "angry",
            "description": "Angry reaction, represented as a face with furrowed eyebrows and sad mouth. A very negative sentiment.",
            "name": "angry"
          },
          {
            "value": "agree",
            "description": "Agree reaction, represented as a hand pointing upward. A positive sentiment.",
            "name": "agree"
          },
          {
            "value": "praise",
            "description": "Praise reaction, represented as two hands facing outward. A positive sentiment.",
            "name": "praise"
          },
          {
            "value": "takingNotes",
            "description": "Taking notes reaction, represented as a hand holding a pen. A neutral sentiment.",
            "name": "takingNotes"
          },
          {
            "value": "heartBroken",
            "description": "Heart broken reaction, represented as a broken heart. A negative sentiment.",
            "name": "heartBroken"
          },
          {
            "value": "support",
            "description": "Support reaction, represented as red numbers showing 100. A positive sentiment.",
            "name": "support"
          },
          {
            "value": "confirmed",
            "description": "Confirmed reaction, represented as a green check mark. A neutral sentiment.",
            "name": "confirmed"
          },
          {
            "value": "watching",
            "description": "Watching reaction, represented as two eyeballs. A neutral sentiment.",
            "name": "watching"
          },
          {
            "value": "brain",
            "description": "Brain reaction, represented as a brain. A neutral sentiment.",
            "name": "brain"
          },
          {
            "value": "medal",
            "description": "Medal reaction, represented as a medal hanging from a sash. A positive sentiment.",
            "name": "medal"
          },
          {
            "value": "bullseye",
            "description": "Bullseye reaction, represented as a target with an arrow in the middle. A positive sentiment.",
            "name": "bullseye"
          },
          {
            "value": "unknownFutureValue",
            "description": "A marker value for members added after the release of this API.",
            "name": "unknownFutureValue"
          }
        ]
      }
    },
    "microsoft.graph.engagementCreationMode": {
      "title": "engagementCreationMode",
      "enum": [
        "none",
        "migration",
        "unknownFutureValue"
      ],
      "type": "string",
      "description": "Indicates that the resource is in migration state and is currently being used for migration purposes.",
      "x-ms-enum": {
        "name": "engagementCreationMode",
        "modelAsString": false,
        "values": [
          {
            "value": "none",
            "description": "Unspecified creation mode.",
            "name": "none"
          },
          {
            "value": "migration",
            "description": "Creation is a migration.",
            "name": "migration"
          },
          {
            "value": "unknownFutureValue",
            "description": "A marker value for members added after the release of this API.",
            "name": "unknownFutureValue"
          }
        ]
      }
    },
    "microsoft.graph.engagementIdentitySet": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.identitySet"
        },
        {
          "title": "engagementIdentitySet",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "audience": {
              "anyOf": [
                {
                  "$ref": "#/$defs/microsoft.graph.identity"
                },
                {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              ],
              "description": "Optional. The audience associated with this action."
            },
            "group": {
              "anyOf": [
                {
                  "$ref": "#/$defs/microsoft.graph.identity"
                },
                {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              ],
              "description": "Optional. The group associated with this action."
            },
            "@odata.type": {
              "type": "string",
              "default": "#microsoft.graph.engagementIdentitySet"
            }
          },
          "description": "The Viva Engage identities."
        }
      ],
      "x-ms-discriminator-value": "#microsoft.graph.engagementIdentitySet"
    },
    "microsoft.graph.entity": {
      "title": "entity",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The unique identifier for an entity. Read-only."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.identity": {
      "title": "identity",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "displayName": {
          "type": [
            "string",
            "null"
          ],
          "description": "The display name of the identity.For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta."
        },
        "id": {
          "type": [
            "string",
            "null"
          ],
          "description": "Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.identitySet": {
      "title": "identitySet",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "application": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.identity"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Optional. The application associated with this action."
        },
        "device": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.identity"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Optional. The device associated with this action."
        },
        "user": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.identity"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Optional. The user associated with this action."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.itemBody": {
      "title": "itemBody",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "content": {
          "type": [
            "string",
            "null"
          ],
          "description": "The content of the item."
        },
        "contentType": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.bodyType"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "The type of the content. Possible values are text and html."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    }
  }
}