From 19e4483204e48ccdd2fe9f27b75b897fb28153ef Mon Sep 17 00:00:00 2001
From: Dennis Winter <DenWin@users.noreply.github.com>
Date: Tue, 17 Jun 2025 15:17:54 +0200
Subject: [PATCH] Update calendar-getschedule.md

Extend the example to get more insight into the representation of the status of an appointment in availabilityView.
* How are overlapping appointments represented.
* How are the single status represented (*1)

*1) Especially in regards to this special case:
Note: Working elsewhere is set to 0 instead of 4 for backward compatibility. For details, see the Q&A and Exchange 2007 and Exchange 2010 do not use the WorkingElsewhere value.
See: https://learn.microsoft.com/en-us/graph/api/resources/scheduleinformation?view=graph-rest-1.0
---
 .../v1.0/api/calendar-getschedule.md          | 57 +++++++++++++++++--
 1 file changed, 53 insertions(+), 4 deletions(-)

diff --git a/api-reference/v1.0/api/calendar-getschedule.md b/api-reference/v1.0/api/calendar-getschedule.md
index b7cc189537a..382a70981b7 100644
--- a/api-reference/v1.0/api/calendar-getschedule.md
+++ b/api-reference/v1.0/api/calendar-getschedule.md
@@ -127,7 +127,7 @@ Content-type: application/json
     "value": [
         {
             "scheduleId": "adelev@contoso.com",
-            "availabilityView": "000220000",
+            "availabilityView": "000220130",
             "scheduleItems": [
                 {
                     "isPrivate": false,
@@ -142,6 +142,54 @@ Content-type: application/json
                         "dateTime": "2019-03-15T14:00:00.0000000",
                         "timeZone": "Pacific Standard Time"
                     }
+                },
+                {
+                    "subject": "free is represented by 0 in availabilityView",
+                    "status": "free",
+                    "start": {
+                        "dateTime": "2019-03-15T10:00:00.0000000",
+                        "timeZone": "Pacific Standard Time"
+                    },
+                    "end": {
+                        "dateTime": "2019-03-15T11:00:00.0000000",
+                        "timeZone": "Pacific Standard Time"
+                    }
+                },
+                {
+                    "subject": "workingElsewhere is also represented by 0 in availabilityView",
+                    "status": "workingElsewhere",
+                    "start": {
+                        "dateTime": "2019-03-15T11:00:00.0000000",
+                        "timeZone": "Pacific Standard Time"
+                    },
+                    "end": {
+                        "dateTime": "2019-03-15T12:00:00.0000000",
+                        "timeZone": "Pacific Standard Time"
+                    }
+                },
+                {
+                    "subject": "tentative is represented by 1 in availabilityView",
+                    "status": "tentative",
+                    "start": {
+                        "dateTime": "2019-03-15T15:00:00.0000000",
+                        "timeZone": "Pacific Standard Time"
+                    },
+                    "end": {
+                        "dateTime": "2019-03-15T16:00:00.0000000",
+                        "timeZone": "Pacific Standard Time"
+                    }
+                },
+                {
+                    "subject": "oof is represented by 3 in availabilityView",
+                    "status": "workingElsewhere",
+                    "start": {
+                        "dateTime": "2019-03-15T16:00:00.0000000",
+                        "timeZone": "Pacific Standard Time"
+                    },
+                    "end": {
+                        "dateTime": "2019-03-15T17:00:00.0000000",
+                        "timeZone": "Pacific Standard Time"
+                    }
                 }
             ],
             "workingHours": {
@@ -161,7 +209,7 @@ Content-type: application/json
         },
         {
             "scheduleId": "meganb@contoso.com",
-            "availabilityView": "200220010",
+            "availabilityView": "200120010",
             "scheduleItems": [
                 {
                     "status": "busy",
@@ -175,7 +223,8 @@ Content-type: application/json
                     }
                 },
                 {
-                    "status": "busy",
+                    "subject": "tentative is represented by 1 and overwritten by the busy-appointment (2) starting from 12 to 13.",
+                    "status": "tentative",
                     "start": {
                         "dateTime": "2019-03-15T12:00:00.0000000",
                         "timeZone": "Pacific Standard Time"
@@ -186,7 +235,7 @@ Content-type: application/json
                     }
                 },
                 {
-                    "status": "tentative",
+                    "status": "busy",
                     "start": {
                         "dateTime": "2019-03-15T12:00:00.0000000",
                         "timeZone": "Pacific Standard Time"