[all hosts] Get latest (#2099)

Author: ElizabethSamuel-MSFT

docs/docs-ref-autogen/outlook/outlook/office.appointmentcompose.yml

@@ -2618,15 +2618,12 @@ methods:
     package: outlook!
     fullName: 'getItemIdAsync(options, callback)'
     summary: >-
-      Asynchronously gets the ID of a saved item.
+      Asynchronously gets the [Exchange Web Services (EWS) item
+      identifier](https://learn.microsoft.com/exchange/client-developer/exchange-web-services/ews-identifiers-in-exchange)
+      of a saved item.
 
 
       When invoked, this method returns the item ID via the callback function.
-
-
-      **Note**: If your add-in calls `getItemIdAsync` on an item in compose mode (e.g., to get an `itemId` to use
-      with EWS or the REST API), be aware that when Outlook is in cached mode, it may take some time before the item is
-      synced to the server. Until the item is synced, the `itemId` is not recognized and using it returns an error.
     remarks: >-
       \[ [API set: Mailbox 1.8](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -2641,6 +2638,19 @@ methods:
       -->**: Appointment Organizer
 
 
+      **Important**:
+
+
+      - The item ID returned isn't identical to the Outlook Entry ID or the ID used by the Outlook REST API. Before
+      making REST API calls using this value, it should be converted using `Office.context.mailbox.convertToRestId`<!--
+      -->.
+
+
+      - If your add-in calls `getItemIdAsync` (for example, to get an item ID to use with EWS or the REST API), be aware
+      that when Outlook is in cached mode, it may take some time before the item is synced to the server. Until the item
+      is synced, the item ID isn't recognized and using it returns an error.
+
+
       **Errors**:
 
 
@@ -2660,7 +2670,8 @@ methods:
         - id: callback
           description: >-
             When the method completes, the function passed in the `callback` parameter is called with a single parameter
-            of type `Office.AsyncResult`<!-- -->.
+            of type `Office.AsyncResult`<!-- -->. The EWS item ID of the item is returned in the `asyncResult.value`
+            property.
           type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;string&gt;) =&gt; void'
       return:
         type: void
@@ -2670,15 +2681,12 @@ methods:
     package: outlook!
     fullName: getItemIdAsync(callback)
     summary: >-
-      Asynchronously gets the ID of a saved item.
+      Asynchronously gets the [Exchange Web Services (EWS) item
+      identifier](https://learn.microsoft.com/exchange/client-developer/exchange-web-services/ews-identifiers-in-exchange)
+      of a saved item.
 
 
       When invoked, this method returns the item ID via the callback function.
-
-
-      **Note**: If your add-in calls `getItemIdAsync` on an item in compose mode (e.g., to get an `itemId` to use
-      with EWS or the REST API), be aware that when Outlook is in cached mode, it may take some time before the item is
-      synced to the server. Until the item is synced, the `itemId` is not recognized and using it returns an error.
     remarks: >-
       \[ [API set: Mailbox 1.8](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -2693,6 +2701,19 @@ methods:
       -->**: Appointment Organizer
 
 
+      **Important**:
+
+
+      - The item ID returned isn't identical to the Outlook Entry ID or the ID used by the Outlook REST API. Before
+      making REST API calls using this value, it should be converted using `Office.context.mailbox.convertToRestId`<!--
+      -->.
+
+
+      - If your add-in calls `getItemIdAsync` (for example, to get an item ID to use with EWS or the REST API), be aware
+      that when Outlook is in cached mode, it may take some time before the item is synced to the server. Until the item
+      is synced, the item ID isn't recognized and using it returns an error.
+
+
       **Errors**:
 
 
@@ -2705,15 +2726,16 @@ methods:
       ```TypeScript
 
       // Link to full sample:
-      https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/85-tokens-and-service-calls/item-id-compose.yaml
+      https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/item-id-compose.yaml
 
 
-      Office.context.mailbox.item.getItemIdAsync(function (result) {
-          if (result.status !== Office.AsyncResultStatus.Succeeded) {
+      Office.context.mailbox.item.getItemIdAsync((result) => {
+          if (result.status === Office.AsyncResultStatus.Failed) {
               console.error(`getItemIdAsync failed with message: ${result.error.message}`);
-          } else {
-              console.log(result.value);
+              return;
           }
+
+          console.log(result.value);
       });
 
       ```
@@ -2725,7 +2747,8 @@ methods:
         - id: callback
           description: >-
             When the method completes, the function passed in the `callback` parameter is called with a single parameter
-            of type `Office.AsyncResult`<!-- -->.
+            of type `Office.AsyncResult`<!-- -->. The EWS item ID of the item is returned in the `asyncResult.value`
+            property.
           type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;string&gt;) =&gt; void'
       return:
         type: void
@@ -3449,9 +3472,16 @@ methods:
       `saveAsync` may not result in the same content.
 
 
-      - If your add-in calls `saveAsync` on an item in compose mode in order to get an item ID to use with EWS or the
-      REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced
-      to the server. Until the item is synced, using the item ID will return an error.
+      - The identifier returned is the same as the [Exchange Web Services (EWS) item
+      identifier](https://learn.microsoft.com/exchange/client-developer/exchange-web-services/ews-identifiers-in-exchange)<!--
+      -->. The item ID returned isn't identical to the Outlook Entry ID or the ID used by the Outlook REST API. Before
+      making REST API calls using this value, it should be converted using `Office.context.mailbox.convertToRestId`<!--
+      -->.
+
+
+      - If your add-in calls `saveAsync` to get an item ID to use with EWS or the REST API, be aware that when Outlook
+      is in cached mode, it may take some time before the item is actually synced to the server. Until the item is
+      synced, using the item ID will return an error.
 
 
       - In Outlook on Mac, only Version 16.35 (20030802) and later supports saving a meeting. Otherwise, the `saveAsync`
@@ -3501,8 +3531,8 @@ methods:
         - id: callback
           description: >-
             When the method completes, the function passed in the `callback` parameter is called with a single
-            parameter, `asyncResult`<!-- -->, which is an `Office.AsyncResult` object. The appointment ID is returned in
-            the `asyncResult.value` property.
+            parameter, `asyncResult`<!-- -->, which is an `Office.AsyncResult` object. The EWS appointment ID is
+            returned in the `asyncResult.value` property.
           type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;string&gt;) =&gt; void'
       return:
         type: void
@@ -3546,9 +3576,16 @@ methods:
       `saveAsync` may not result in the same content.
 
 
-      - If your add-in calls `saveAsync` on an item in compose mode in order to get an item ID to use with EWS or the
-      REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced
-      to the server. Until the item is synced, using the item ID will return an error.
+      - The identifier returned is the same as the [Exchange Web Services (EWS) item
+      identifier](https://learn.microsoft.com/exchange/client-developer/exchange-web-services/ews-identifiers-in-exchange)<!--
+      -->. The item ID returned isn't identical to the Outlook Entry ID or the ID used by the Outlook REST API. Before
+      making REST API calls using this value, it should be converted using `Office.context.mailbox.convertToRestId`<!--
+      -->.
+
+
+      - If your add-in calls `saveAsync` to get an item ID to use with EWS or the REST API, be aware that when Outlook
+      is in cached mode, it may take some time before the item is actually synced to the server. Until the item is
+      synced, using the item ID will return an error.
 
 
       - In Outlook on Mac, only Version 16.35 (20030802) and later supports saving a meeting. Otherwise, the `saveAsync`
@@ -3598,8 +3635,8 @@ methods:
         - id: callback
           description: >-
             When the method completes, the function passed in the `callback` parameter is called with a single
-            parameter, `asyncResult`<!-- -->, which is an `Office.AsyncResult` object. The appointment ID is returned in
-            the `asyncResult.value` property.
+            parameter, `asyncResult`<!-- -->, which is an `Office.AsyncResult` object. The EWS appointment ID is
+            returned in the `asyncResult.value` property.
           type: '(asyncResult: <xref uid="office!Office.AsyncResult:interface" />&lt;string&gt;) =&gt; void'
       return:
         type: void

docs/docs-ref-autogen/outlook/outlook/office.appointmentread.yml

@@ -508,22 +508,9 @@ properties:
     package: outlook!
     fullName: itemId
     summary: >-
-      Gets the [Exchange Web Services item
+      Gets the [Exchange Web Services (EWS) item
       identifier](https://learn.microsoft.com/exchange/client-developer/exchange-web-services/ews-identifiers-in-exchange)
-      for the current item.
-
-
-      The `itemId` property is not available in compose mode. If an item identifier is required, the `saveAsync` method
-      can be used to save the item to the store, which will return the item identifier in the `asyncResult.value`
-      parameter in the callback function.
-
-
-      **Note**: The identifier returned by the `itemId` property is the same as the [Exchange Web Services item
-      identifier](https://learn.microsoft.com/exchange/client-developer/exchange-web-services/ews-identifiers-in-exchange)<!--
-      -->. The `itemId` property is not identical to the Outlook Entry ID or the ID used by the Outlook REST API. Before
-      making REST API calls using this value, it should be converted using `Office.context.mailbox.convertToRestId`<!--
-      -->. For more details, see [Use the Outlook REST APIs from an Outlook
-      add-in](https://learn.microsoft.com/office/dev/add-ins/outlook/use-rest-api#get-the-item-id)<!-- -->.
+      of the current item.
     remarks: >-
       **[Minimum permission
       level](https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!--
@@ -535,6 +522,20 @@ properties:
       -->**: Appointment Attendee
 
 
+      **Important**:
+
+
+      - The `itemId` property isn't available in compose mode. If an item identifier is required, the
+      `Office.context.mailbox.item.saveAsync` method can be used to save the item to the store, which will return the
+      item identifier in the `asyncResult.value` parameter in the callback function. If the item is already saved, you
+      can call the `Office.context.mailbox.item.getItemIdAsync` method instead.
+
+
+      - The item ID returned isn't identical to the Outlook Entry ID or the ID used by the Outlook REST API. Before
+      making REST API calls using this value, it should be converted using `Office.context.mailbox.convertToRestId`<!--
+      -->.
+
+
       #### Examples