microsoft.graph.presence

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-graph/json-schema/microsoft-graph-microsoft-graph-presence-schema.json",
  "title": "microsoft.graph.presence",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-graph-communications-cloudcommunications-actions-api-openapi.yml#/components/schemas/microsoft.graph.presence",
  "allOf": [
    {
      "$ref": "#/$defs/microsoft.graph.entity"
    },
    {
      "title": "presence",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "activity": {
          "type": [
            "string",
            "null"
          ],
          "description": "The supplemental information to a user's availability. Possible values are available, away, beRightBack, busy, doNotDisturb, offline, outOfOffice, presenceUnknown."
        },
        "availability": {
          "type": [
            "string",
            "null"
          ],
          "description": "The base presence information for a user. Possible values are available, away, beRightBack, busy, doNotDisturb, focusing, inACall, inAMeeting, offline, presenting, presenceUnknown."
        },
        "outOfOfficeSettings": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.outOfOfficeSettings"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "The out of office settings for a user."
        },
        "sequenceNumber": {
          "type": [
            "string",
            "null"
          ],
          "description": "The lexicographically sortable String stamp that represents the version of a presence object.",
          "readOnly": true
        },
        "statusMessage": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.presenceStatusMessage"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "The presence status message of a user."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    }
  ],
  "x-ms-discriminator-value": "#microsoft.graph.presence",
  "$defs": {
    "microsoft.graph.bodyType": {
      "title": "bodyType",
      "enum": [
        "text",
        "html"
      ],
      "type": "string"
    },
    "microsoft.graph.dateTimeTimeZone": {
      "title": "dateTimeTimeZone",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000)."
        },
        "timeZone": {
          "type": [
            "string",
            "null"
          ],
          "description": "Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values."
        },
        "@odata.type": {
          "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.outOfOfficeSettings": {
      "title": "outOfOfficeSettings",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "isOutOfOffice": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "If true, either of the following is met:The current time falls within the out-of-office window configured in Outlook or Teams.An event marked as 'Show as Out of Office' appears on the user's calendar.Otherwise, false."
        },
        "message": {
          "type": [
            "string",
            "null"
          ],
          "description": "The out-of-office message configured by the user in the Outlook client (Automatic replies) or the Teams client (Schedule out of office)."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.presenceStatusMessage": {
      "title": "presenceStatusMessage",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "expiryDateTime": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.dateTimeTimeZone"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Time in which the status message expires.If not provided, the status message doesn't expire.expiryDateTime.dateTime shouldn't include time zone.expiryDateTime isn't available when you request the presence of another user."
        },
        "message": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.itemBody"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Status message item. The only supported format currently is message.contentType = 'text'."
        },
        "publishedDateTime": {
          "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": "Time in which the status message was published.Read-only.publishedDateTime isn't available when you request the presence of another user.",
          "format": "date-time"
        },
        "@odata.type": {
          "type": "string"
        }
      }
    }
  }
}