Microsoft Graph · Schema

microsoft.graph.serviceUpdateMessage

Microsoft GraphAzure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task

Properties

Name	Type	Description
id	string	The unique identifier for an entity. Read-only.
@odata.type	string
details	array	More details about service event. This property doesn't support filters.
endDateTime	stringnull	The end time of the service event.
lastModifiedDateTime	string	The last modified time of the service event.
startDateTime	string	The start time of the service event.
title	string	The title of the service event.
actionRequiredByDateTime	stringnull	The expected deadline of the action for the message.
attachmentsArchive	stringnull	The zip file that contains all attachments for a message.
body	object
category	object
hasAttachments	boolean	Indicates whether the message has any attachment.
isMajorChange	booleannull	Indicates whether the message describes a major update for the service.
services	array	The affected services by the service message.
severity	object
tags	array	A collection of tags for the service message. Tags are provided by the service team/support team who post the message to tell whether this message contains privacy data, or whether this message is for
viewPoint	object	Represents user viewpoints data of the service message. This data includes message status such as whether the user has archived, read, or marked the message as favorite. This property is null when acc
attachments	array	A collection of serviceAnnouncementAttachments.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-graph/json-schema/microsoft-graph-microsoft-graph-service-update-message-schema.json",
  "title": "microsoft.graph.serviceUpdateMessage",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-graph-admin-serviceannouncement-api-openapi.yml#/components/schemas/microsoft.graph.serviceUpdateMessage",
  "allOf": [
    {
      "$ref": "#/$defs/microsoft.graph.serviceAnnouncementBase"
    },
    {
      "title": "serviceUpdateMessage",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "actionRequiredByDateTime": {
          "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",
            "null"
          ],
          "description": "The expected deadline of the action for the message.",
          "format": "date-time"
        },
        "attachmentsArchive": {
          "type": [
            "string",
            "null"
          ],
          "description": "The zip file that contains all attachments for a message.",
          "format": "base64url"
        },
        "body": {
          "$ref": "#/$defs/microsoft.graph.itemBody"
        },
        "category": {
          "$ref": "#/$defs/microsoft.graph.serviceUpdateCategory"
        },
        "hasAttachments": {
          "type": "boolean",
          "description": "Indicates whether the message has any attachment."
        },
        "isMajorChange": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indicates whether the message describes a major update for the service."
        },
        "services": {
          "type": "array",
          "items": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": "The affected services by the service message."
        },
        "severity": {
          "$ref": "#/$defs/microsoft.graph.serviceUpdateSeverity"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": "A collection of tags for the service message. Tags are provided by the service team/support team who post the message to tell whether this message contains privacy data, or whether this message is for a service new feature update, and so on."
        },
        "viewPoint": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.serviceUpdateMessageViewpoint"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Represents user viewpoints data of the service message. This data includes message status such as whether the user has archived, read, or marked the message as favorite. This property is null when accessed with application permissions."
        },
        "attachments": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.serviceAnnouncementAttachment"
          },
          "description": "A collection of serviceAnnouncementAttachments.",
          "x-ms-navigationProperty": true
        },
        "@odata.type": {
          "type": "string",
          "default": "#microsoft.graph.serviceUpdateMessage"
        }
      }
    }
  ],
  "x-ms-discriminator-value": "#microsoft.graph.serviceUpdateMessage",
  "$defs": {
    "microsoft.graph.bodyType": {
      "title": "bodyType",
      "enum": [
        "text",
        "html"
      ],
      "type": "string"
    },
    "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.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"
        }
      }
    },
    "microsoft.graph.keyValuePair": {
      "title": "keyValuePair",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name for this key-value pair"
        },
        "value": {
          "type": [
            "string",
            "null"
          ],
          "description": "Value for this key-value pair"
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.serviceAnnouncementAttachment": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "serviceAnnouncementAttachment",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "content": {
              "type": [
                "string",
                "null"
              ],
              "description": "The attachment content.",
              "format": "base64url"
            },
            "contentType": {
              "type": [
                "string",
                "null"
              ]
            },
            "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",
                "null"
              ],
              "format": "date-time"
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "size": {
              "maximum": 2147483647,
              "minimum": -2147483648,
              "type": "number",
              "format": "int32"
            },
            "@odata.type": {
              "type": "string"
            }
          }
        }
      ],
      "x-ms-discriminator-value": "#microsoft.graph.serviceAnnouncementAttachment"
    },
    "microsoft.graph.serviceAnnouncementBase": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "serviceAnnouncementBase",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "details": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.keyValuePair"
              },
              "description": "More details about service event. This property doesn't support filters."
            },
            "endDateTime": {
              "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",
                "null"
              ],
              "description": "The end time of the service event.",
              "format": "date-time"
            },
            "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 last modified time of the service event.",
              "format": "date-time"
            },
            "startDateTime": {
              "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 start time of the service event.",
              "format": "date-time"
            },
            "title": {
              "type": "string",
              "description": "The title of the service event."
            },
            "@odata.type": {
              "type": "string"
            }
          }
        }
      ]
    },
    "microsoft.graph.serviceUpdateCategory": {
      "title": "serviceUpdateCategory",
      "enum": [
        "preventOrFixIssue",
        "planForChange",
        "stayInformed",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.serviceUpdateMessageViewpoint": {
      "title": "serviceUpdateMessageViewpoint",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "isArchived": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indicates whether the user archived the message."
        },
        "isFavorited": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indicates whether the user marked the message as favorite."
        },
        "isRead": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indicates whether the user read the message."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.serviceUpdateSeverity": {
      "title": "serviceUpdateSeverity",
      "enum": [
        "normal",
        "high",
        "critical",
        "unknownFutureValue"
      ],
      "type": "string"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/microsoft-graph-microsoft-graph-service-update-message"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.