@types/office-js-preview 1.0.488 → 1.0.490

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -517,7 +517,7 @@ declare namespace Office {
517
517
  * - Word on the web
518
518
  *
519
519
  * It's also supported in
520
- * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows (preview)}.
520
+ * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}.
521
521
  *
522
522
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/device-permission-service-requirement-sets | DevicePermission 1.1}
523
523
  */
@@ -529,7 +529,7 @@ declare namespace Office {
529
529
  /**
530
530
  * The add-in is requesting access to the user's geolocation.
531
531
  *
532
- * **Important**: Access to a user's geolocation is only supported in Outlook on the web and new Outlook on Windows (preview).
532
+ * **Important**: Access to a user's geolocation is only supported in Outlook on the web and new Outlook on Windows.
533
533
  */
534
534
  geolocation,
535
535
  /**
@@ -908,7 +908,7 @@ declare namespace Office {
908
908
  * The platform is Office on the web (in a browser).
909
909
  *
910
910
  * **Important**: In Outlook, `OfficeOnline` is returned if an add-is is running in Outlook on the web or in
911
- * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows (preview)}.
911
+ * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}.
912
912
  */
913
913
  OfficeOnline,
914
914
  /**
@@ -3580,7 +3580,7 @@ declare namespace Office {
3580
3580
  *
3581
3581
  * - In Outlook on the web, this API isn't supported if you use the Safari browser. This results in error 13001 ("The user is not signed into Office").
3582
3582
  *
3583
- * - In Outlook on the web, if you use the
3583
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, if you use the
3584
3584
  * {@link https://learn.microsoft.com/javascript/api/office/office.ui#office-office-ui-displaydialogasync-member(1) | displayDialogAsync}
3585
3585
  * method to open a dialog, you must close the dialog before you can call `getAccessToken`.
3586
3586
  *
@@ -4661,7 +4661,7 @@ declare namespace Office {
4661
4661
  * property to get similar information.
4662
4662
  *
4663
4663
  * - In Outlook, `OfficeOnline` is returned if an add-is is running in Outlook on the web or in
4664
- * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows (preview)}.
4664
+ * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}.
4665
4665
  */
4666
4666
  platform: PlatformType;
4667
4667
  /**
@@ -4717,7 +4717,7 @@ declare namespace Office {
4717
4717
  *
4718
4718
  * @remarks
4719
4719
  *
4720
- * **Applications**: Outlook on the web and on Windows (classic and new clients)
4720
+ * **Applications**: Outlook on the web and on Windows ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic clients)
4721
4721
  *
4722
4722
  * [Api set: Mailbox 1.14]
4723
4723
  *
@@ -4727,8 +4727,8 @@ declare namespace Office {
4727
4727
  *
4728
4728
  * **Important**:
4729
4729
  *
4730
- * - In Outlook on the web and new Outlook on Windows, this API isn't supported in add-ins that implement a task pane. On these clients,
4731
- * the API is only supported in add-ins that implement event-based activation or integrated spam reporting.
4730
+ * - In Outlook on the web and new Outlook on Windows, this API isn't supported in add-ins that implement a task pane.
4731
+ * On these clients, the API is only supported in add-ins that implement event-based activation or integrated spam reporting.
4732
4732
  *
4733
4733
  * - In classic Outlook on Windows, this API is supported in add-ins that implement a task pane, event-based activation, or integrated spam reporting.
4734
4734
  */
@@ -4753,7 +4753,7 @@ declare namespace Office {
4753
4753
  *
4754
4754
  * @remarks
4755
4755
  * **Important**: In Outlook, `OfficeOnline` is returned if an add-is is running in Outlook on the web or in
4756
- * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows (preview)}.
4756
+ * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}.
4757
4757
  */
4758
4758
  platform: Office.PlatformType;
4759
4759
  /**
@@ -5318,7 +5318,7 @@ declare namespace Office {
5318
5318
  * - Word on the web
5319
5319
  *
5320
5320
  * It's also supported in
5321
- * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows (preview)}.
5321
+ * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}.
5322
5322
  *
5323
5323
  * **Requirement set**: {@link https://learn.microsoft.com/javascript/api/requirement-sets/common/device-permission-service-requirement-sets | DevicePermission 1.1}
5324
5324
  */
@@ -5391,7 +5391,8 @@ declare namespace Office {
5391
5391
  * browser permissions to device capabilities aren't inherited and the `requestPermissionsAsync` method isn't supported.
5392
5392
  *
5393
5393
  * @param permissions An array of device capabilities to which an add-in is requesting access.
5394
- * In Outlook on the web, an add-in can request access to a user's camera, geolocation, and microphone.
5394
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, an add-in can request access to a
5395
+ * user's camera, geolocation, and microphone.
5395
5396
  * @param options An object literal that contains the `asyncContext` property. Assign any object you wish to access in the callback function to the `asyncContext` property.
5396
5397
  * @param callback When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`, which is an `Office.AsyncResult` object.
5397
5398
  * If the user grants permission to access the requested device capabilities, `true` is returned in the `asyncResult.value` property. You must then reload the add-in before you can
@@ -5431,7 +5432,8 @@ declare namespace Office {
5431
5432
  * browser permissions to device capabilities aren't inherited and the `requestPermissionsAsync` method isn't supported.
5432
5433
  *
5433
5434
  * @param permissions An array of device capabilities to which an add-in is requesting access.
5434
- * In Outlook on the web, an add-in can request access to a user's camera, geolocation, and microphone.
5435
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, an add-in can request access to a
5436
+ * user's camera, geolocation, and microphone.
5435
5437
  * @param callback When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`, which is an `Office.AsyncResult` object.
5436
5438
  * If the user grants permission to access the requested device capabilities, `true` is returned in the `asyncResult.value` property. You must then reload the add-in before you can
5437
5439
  * run code that uses the device capabilities. For example, you can call `window.location.reload()` to reload your add-in.
@@ -8716,8 +8718,9 @@ declare namespace Office {
8716
8718
  * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/autolaunch | Configure your Outlook add-in for event-based activation} and
8717
8719
  * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/spam-reporting | Implement an integrated spam-reporting add-in}.
8718
8720
  *
8719
- * - In Outlook on the web and new Outlook on Windows, this API isn't supported in add-ins that implement a task pane. On these clients,
8720
- * the API is only supported in add-ins that implement event-based activation or integrated spam reporting.
8721
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
8722
+ * this API isn't supported in add-ins that implement a task pane. On these clients, the API is only supported in add-ins that implement event-based activation
8723
+ * or integrated spam reporting.
8721
8724
  *
8722
8725
  * - If your add-in uses the XML manifest, the URL returned matches the `resid` value of the **RuntimeOverride** element of type `javascript`.
8723
8726
  * To learn more, see {@link https://learn.microsoft.com/javascript/api/manifest/override#override-element-for-runtime | Override element for Runtime}.
@@ -8874,7 +8877,7 @@ declare namespace Office {
8874
8877
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
8875
8878
  *
8876
8879
  * **Important**: The actual color depends on how the Outlook client renders it.
8877
- * In this case, the colors noted on each preset apply to Outlook on the web, on Windows,
8880
+ * In this case, the colors noted on each preset apply to Outlook on the web, on Windows ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic),
8878
8881
  * and on Mac (starting in Version 16.78).
8879
8882
  *
8880
8883
  * Earlier versions of Outlook on Mac had a bug that displayed incorrect preset colors.
@@ -9404,9 +9407,9 @@ declare namespace Office {
9404
9407
  /**
9405
9408
  * Specifies the recipient is an SMTP email address that isn't on the Exchange server. It also refers to a recipient added from a personal Outlook address book.
9406
9409
  *
9407
- * **Important**: In Outlook on the web, on Windows (starting with Version 2210 (Build 15813.20002)), and on Mac, Global Address Book (GAL) recipients saved to a personal address book return
9408
- * the `ExternalUser` value, even if their SMTP email address appears on the Exchange server. Recipients return a `User` value only if they're directly
9409
- * added or resolved against the GAL.
9410
+ * **Important**: In Outlook on the web, on Windows ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic
9411
+ * (starting with Version 2210, Build 15813.20002)), and on Mac, Global Address Book (GAL) recipients saved to a personal address book return the `ExternalUser` value,
9412
+ * even if their SMTP email address appears on the Exchange server. Recipients return a `User` value only if they're directly added or resolved against the GAL.
9410
9413
  */
9411
9414
  ExternalUser = "externalUser",
9412
9415
  /**
@@ -10331,7 +10334,8 @@ declare namespace Office {
10331
10334
  *
10332
10335
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Organizer
10333
10336
  *
10334
- * **Important**: Outlook on the web, new Outlook on Windows (preview), and Outlook on Mac only support Normal and Private sensitivity levels.
10337
+ * **Important**: Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, and Outlook on Mac
10338
+ * only support Normal and Private sensitivity levels.
10335
10339
  */
10336
10340
  sensitivity: Sensitivity;
10337
10341
  /**
@@ -10630,8 +10634,8 @@ declare namespace Office {
10630
10634
  *
10631
10635
  * You can subsequently use the identifier with the `removeAttachmentAsync` method to remove the attachment in the same session.
10632
10636
  *
10633
- * If your Office Add-in is running in Outlook on the web, the `addItemAttachmentAsync` method can attach items to items other than the item that
10634
- * you are editing; however, this is not supported and is not recommended.
10637
+ * If your Office Add-in is running in Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
10638
+ * the `addItemAttachmentAsync` method can attach items to items other than the item that you're editing. However, this isn't supported and isn't recommended.
10635
10639
  *
10636
10640
  * @remarks
10637
10641
  * [Api set: Mailbox 1.1]
@@ -10665,8 +10669,8 @@ declare namespace Office {
10665
10669
  *
10666
10670
  * You can subsequently use the identifier with the `removeAttachmentAsync` method to remove the attachment in the same session.
10667
10671
  *
10668
- * If your Office Add-in is running in Outlook on the web, the `addItemAttachmentAsync` method can attach items to items other than the item that
10669
- * you are editing; however, this is not supported and is not recommended.
10672
+ * If your Office Add-in is running in Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
10673
+ * the `addItemAttachmentAsync` method can attach items to items other than the item that you're editing. However, this isn't supported and isn't recommended.
10670
10674
  *
10671
10675
  * @remarks
10672
10676
  * [Api set: Mailbox 1.1]
@@ -10703,17 +10707,18 @@ declare namespace Office {
10703
10707
  *
10704
10708
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Organizer
10705
10709
  *
10706
- * **Important**: In Outlook on the web, if the item is an appointment and it has previously been saved using `saveAsync`, the user is prompted to save,
10707
- * discard, or cancel even if no changes have occurred since the item was last saved.
10710
+ * **Important**: In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
10711
+ * if the item is an appointment and it has previously been saved using `saveAsync`, the user is prompted to save, discard, or cancel even if no changes have occurred
10712
+ * since the item was last saved.
10708
10713
  */
10709
10714
  close(): void;
10710
10715
  /**
10711
10716
  * Disables the Outlook client signature.
10712
10717
  *
10713
- * For Windows and Mac rich clients, this API sets the signature under the "New Message" and "Replies/Forwards" sections
10718
+ * In Outlook on Windows (classic) and on Mac, this API sets the signature under the "New Message" and "Replies/Forwards" sections
10714
10719
  * for the sending account to "(none)", effectively disabling the signature.
10715
- * For Outlook on the web, the API should disable the signature option for new mails, replies, and forwards.
10716
- * If the signature is selected, this API call should disable it.
10720
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, the API disables the signature
10721
+ * option for new mails, replies, and forwards. If the signature is selected, this API call disables it.
10717
10722
  *
10718
10723
  * @remarks
10719
10724
  * [Api set: Mailbox 1.10]
@@ -10731,10 +10736,10 @@ declare namespace Office {
10731
10736
  /**
10732
10737
  * Disables the Outlook client signature.
10733
10738
  *
10734
- * For Windows and Mac rich clients, this API sets the signature under the "New Message" and "Replies/Forwards" sections
10739
+ * In Outlook on Windows (classic) and on Mac, this API sets the signature under the "New Message" and "Replies/Forwards" sections
10735
10740
  * for the sending account to "(none)", effectively disabling the signature.
10736
- * For Outlook on the web, the API should disable the signature option for new mails, replies, and forwards.
10737
- * If the signature is selected, this API call should disable it.
10741
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, the API disables the signature
10742
+ * option for new mails, replies, and forwards. If the signature is selected, this API call disables it.
10738
10743
  *
10739
10744
  * @remarks
10740
10745
  * [Api set: Mailbox 1.10]
@@ -10752,7 +10757,8 @@ declare namespace Office {
10752
10757
  *
10753
10758
  * The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best practice, you should get
10754
10759
  * the attachment's identifier from a `getAttachmentsAsync` call, then in the same session, use that identifier to retrieve the attachment.
10755
- * In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
10760
+ * In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
10761
+ * the attachment identifier is valid only within the same session.
10756
10762
  * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
10757
10763
  * continue in a separate window.
10758
10764
  *
@@ -10783,7 +10789,8 @@ declare namespace Office {
10783
10789
  *
10784
10790
  * The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best practice, you should get
10785
10791
  * the attachment's identifier from a `getAttachmentsAsync` call, then in the same session, use that identifier to retrieve the attachment.
10786
- * In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
10792
+ * In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
10793
+ * the attachment identifier is valid only within the same session.
10787
10794
  * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
10788
10795
  * continue in a separate window.
10789
10796
  *
@@ -11018,10 +11025,10 @@ declare namespace Office {
11018
11025
  /**
11019
11026
  * Gets if the client signature is enabled.
11020
11027
  *
11021
- * For Windows and Mac rich clients, the API call should return `true` if the default signature for new messages, replies, or forwards is set
11022
- * to a template for the sending Outlook account.
11023
- * For Outlook on the web, the API call should return `true` if the signature is enabled for compose types `newMail`, `reply`, or `forward`.
11024
- * If the settings are set to "(none)" in Mac or Windows rich clients or disabled in Outlook on the web, the API call should return `false`.
11028
+ * For Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, the API call
11029
+ * should return `true` if the signature is enabled for compose types `newMail`, `reply`, or `forward`.
11030
+ * If the settings are set to "(none)" in Windows (classic) or Mac desktop clients or disabled in Outlook on the web or new Outlook on Windows,
11031
+ * the API call should return `false`.
11025
11032
  *
11026
11033
  * @remarks
11027
11034
  * [Api set: Mailbox 1.10]
@@ -11039,10 +11046,10 @@ declare namespace Office {
11039
11046
  /**
11040
11047
  * Gets if the client signature is enabled.
11041
11048
  *
11042
- * For Windows and Mac rich clients, the API call should return `true` if the default signature for new messages, replies, or forwards is set
11043
- * to a template for the sending Outlook account.
11044
- * For Outlook on the web, the API call should return `true` if the signature is enabled for compose types `newMail`, `reply`, or `forward`.
11045
- * If the settings are set to "(none)" in Mac or Windows rich clients or disabled in Outlook on the web, the API call should return `false`.
11049
+ * For Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, the API call
11050
+ * should return `true` if the signature is enabled for compose types `newMail`, `reply`, or `forward`.
11051
+ * If the settings are set to "(none)" in Windows (classic) or Mac desktop clients or disabled in Outlook on the web or new Outlook on Windows,
11052
+ * the API call should return `false`.
11046
11053
  *
11047
11054
  * @remarks
11048
11055
  * [Api set: Mailbox 1.10]
@@ -11086,7 +11093,8 @@ declare namespace Office {
11086
11093
  *
11087
11094
  * The `removeAttachmentAsync` method removes the attachment with the specified identifier from the item.
11088
11095
  * As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment
11089
- * in the same session. In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
11096
+ * in the same session. In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
11097
+ * the attachment identifier is valid only within the same session.
11090
11098
  * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
11091
11099
  * continue in a separate window.
11092
11100
  *
@@ -11106,7 +11114,7 @@ declare namespace Office {
11106
11114
  * - `InvalidAttachmentId`: The attachment identifier does not exist.
11107
11115
  *
11108
11116
  * @param attachmentId - The identifier of the attachment to remove. The maximum string length of the `attachmentId`
11109
- * is 200 characters in Outlook on the web and on Windows.
11117
+ * is 200 characters in Outlook on the web and on Windows (new and classic).
11110
11118
  * @param options - An object literal that contains one or more of the following properties:-
11111
11119
  * `asyncContext`: Developers can provide any object they wish to access in the callback function.
11112
11120
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter of
@@ -11119,7 +11127,8 @@ declare namespace Office {
11119
11127
  *
11120
11128
  * The `removeAttachmentAsync` method removes the attachment with the specified identifier from the item.
11121
11129
  * As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment
11122
- * in the same session. In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
11130
+ * in the same session. In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
11131
+ * the attachment identifier is valid only within the same session.
11123
11132
  * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
11124
11133
  * continue in a separate window.
11125
11134
  *
@@ -11139,7 +11148,7 @@ declare namespace Office {
11139
11148
  * - `InvalidAttachmentId`: The attachment identifier does not exist.
11140
11149
  *
11141
11150
  * @param attachmentId - The identifier of the attachment to remove. The maximum string length of the `attachmentId`
11142
- * is 200 characters in Outlook on the web and on Windows.
11151
+ * is 200 characters in Outlook on the web and on Windows (new and classic).
11143
11152
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter of
11144
11153
  * type `Office.AsyncResult`.
11145
11154
  * If removing the attachment fails, the `asyncResult.error` property will contain an error code with the reason for the failure.
@@ -11199,7 +11208,8 @@ declare namespace Office {
11199
11208
  *
11200
11209
  * **Important**:
11201
11210
  *
11202
- * - In Outlook on the web or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
11211
+ * - In Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, or classic Outlook on Windows
11212
+ * in online mode (non-cached mode), the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
11203
11213
  *
11204
11214
  * - When working with HTML-formatted content, it's important to note that the Outlook client may modify the content. This means that
11205
11215
  * subsequent calls to methods like `Body.getAsync`, `Body.setAsync`, and even `saveAsync` may not result in the same content.
@@ -11238,7 +11248,8 @@ declare namespace Office {
11238
11248
  *
11239
11249
  * **Important**:
11240
11250
  *
11241
- * - In Outlook on the web or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
11251
+ * - In Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, or classic Outlook on Windows
11252
+ * in online mode (non-cached mode), the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
11242
11253
  *
11243
11254
  * - When working with HTML-formatted content, it's important to note that the Outlook client may modify the content. This means that
11244
11255
  * subsequent calls to methods like `Body.getAsync`, `Body.setAsync`, and even `saveAsync` may not result in the same content.
@@ -11281,13 +11292,14 @@ declare namespace Office {
11281
11292
  * If more than 1,000,000 characters are passed in, an `ArgumentOutOfRange` exception is thrown.
11282
11293
  * @param options - An object literal that contains one or more of the following properties:-
11283
11294
  * `asyncContext`: Developers can provide any object they wish to access in the callback function.
11284
- * `coercionType`: If text, the current style is applied in Outlook on the web and on Windows.
11285
- * If the field is an HTML editor, only the text data is inserted, even if the data is HTML.
11286
- * If html and the field supports HTML (the subject doesn't), the current style is applied in Outlook on the web and the
11287
- * default style is applied in Outlook on desktop clients.
11288
- * If the field is a text field, an `InvalidDataFormat` error is returned.
11289
- * If `coercionType` is not set, the result depends on the field: if the field is HTML then HTML is used;
11290
- * if the field is text, then plain text is used.
11295
+ * `coercionType`: If text, the current style is applied in Outlook on the web, on Windows
11296
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), and on Mac.
11297
+ * If the field is an HTML editor, only the text data is inserted, even if the data is HTML.
11298
+ * If the data is HTML and the field supports HTML (the subject doesn't), the current style is applied in
11299
+ * Outlook on the web and new Outlook on Windows. The default style is applied in Outlook on Windows (classic) and on Mac.
11300
+ * If the field is a text field, an `InvalidDataFormat` error is returned.
11301
+ * If `coercionType` is not set, the result depends on the field:
11302
+ * if the field is HTML then HTML is used; if the field is text, then plain text is used.
11291
11303
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter of
11292
11304
  * type `Office.AsyncResult`.
11293
11305
  */
@@ -11815,7 +11827,8 @@ declare namespace Office {
11815
11827
  *
11816
11828
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Attendee
11817
11829
  *
11818
- * **Important**: Outlook on the web, new Outlook on Windows (preview), and Outlook on Mac only support Normal and Private sensitivity levels.
11830
+ * **Important**: Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, and Outlook on Mac
11831
+ * only support Normal and Private sensitivity levels.
11819
11832
  */
11820
11833
  sensitivity: MailboxEnums.AppointmentSensitivityType;
11821
11834
  /**
@@ -11873,9 +11886,10 @@ declare namespace Office {
11873
11886
  *
11874
11887
  * **Important**:
11875
11888
  *
11876
- * - In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
11889
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
11890
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
11877
11891
  *
11878
- * - If any of the string parameters exceed their limits, `displayReplyForm` throws an exception.
11892
+ * - If any of the string parameters exceed their limits, `displayReplyAllForm` throws an exception.
11879
11893
  *
11880
11894
  * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
11881
11895
  * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
@@ -11891,15 +11905,6 @@ declare namespace Office {
11891
11905
  * Displays a reply form that includes either the sender and all recipients of the selected message or the organizer and all attendees of the
11892
11906
  * selected appointment.
11893
11907
  *
11894
- * In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
11895
- *
11896
- * If any of the string parameters exceed their limits, `displayReplyAllFormAsync` throws an exception.
11897
- *
11898
- * When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
11899
- * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
11900
- *
11901
- * **Note**: This method isn't supported in Outlook on iOS or on Android.
11902
- *
11903
11908
  * @remarks
11904
11909
  * [Api set: Mailbox 1.9]
11905
11910
  *
@@ -11907,6 +11912,19 @@ declare namespace Office {
11907
11912
  *
11908
11913
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Attendee
11909
11914
  *
11915
+ * **Important**:
11916
+ *
11917
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
11918
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
11919
+ *
11920
+ * - If any of the string parameters exceed their limits, `displayReplyAllFormAsync` throws an exception.
11921
+ *
11922
+ * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
11923
+ * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
11924
+ *
11925
+ * - This method isn't supported in Outlook on Android or on iOS. For more information on supported APIs in Outlook mobile, see
11926
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
11927
+ *
11910
11928
  * @param formData - A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
11911
11929
  * OR a {@link Office.ReplyFormData | ReplyFormData} object that contains body or attachment data and a callback function.
11912
11930
  * @param options - An object literal that contains one or more of the following properties:-
@@ -11919,15 +11937,6 @@ declare namespace Office {
11919
11937
  * Displays a reply form that includes either the sender and all recipients of the selected message or the organizer and all attendees of the
11920
11938
  * selected appointment.
11921
11939
  *
11922
- * In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
11923
- *
11924
- * If any of the string parameters exceed their limits, `displayReplyAllFormAsync` throws an exception.
11925
- *
11926
- * When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
11927
- * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
11928
- *
11929
- * **Note**: This method isn't supported in Outlook on iOS or on Android.
11930
- *
11931
11940
  * @remarks
11932
11941
  * [Api set: Mailbox 1.9]
11933
11942
  *
@@ -11935,6 +11944,19 @@ declare namespace Office {
11935
11944
  *
11936
11945
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Attendee
11937
11946
  *
11947
+ * **Important**:
11948
+ *
11949
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
11950
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
11951
+ *
11952
+ * - If any of the string parameters exceed their limits, `displayReplyAllFormAsync` throws an exception.
11953
+ *
11954
+ * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
11955
+ * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
11956
+ *
11957
+ * - This method isn't supported in Outlook on Android or on iOS. For more information on supported APIs in Outlook mobile, see
11958
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
11959
+ *
11938
11960
  * @param formData - A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
11939
11961
  * OR a {@link Office.ReplyFormData | ReplyFormData} object that contains body or attachment data and a callback function.
11940
11962
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
@@ -11953,7 +11975,8 @@ declare namespace Office {
11953
11975
  *
11954
11976
  * **Important**:
11955
11977
  *
11956
- * - In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
11978
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
11979
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
11957
11980
  *
11958
11981
  * - If any of the string parameters exceed their limits, `displayReplyForm` throws an exception.
11959
11982
  *
@@ -11970,15 +11993,6 @@ declare namespace Office {
11970
11993
  /**
11971
11994
  * Displays a reply form that includes only the sender of the selected message or the organizer of the selected appointment.
11972
11995
  *
11973
- * In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
11974
- *
11975
- * If any of the string parameters exceed their limits, `displayReplyFormAsync` throws an exception.
11976
- *
11977
- * When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
11978
- * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
11979
- *
11980
- * **Note**: This method isn't supported in Outlook on iOS or on Android.
11981
- *
11982
11996
  * @remarks
11983
11997
  * [Api set: Mailbox 1.9]
11984
11998
  *
@@ -11986,6 +12000,19 @@ declare namespace Office {
11986
12000
  *
11987
12001
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Attendee
11988
12002
  *
12003
+ * **Important**:
12004
+ *
12005
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
12006
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
12007
+ *
12008
+ * - If any of the string parameters exceed their limits, `displayReplyFormAsync` throws an exception.
12009
+ *
12010
+ * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
12011
+ * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
12012
+ *
12013
+ * - This method isn't supported in Outlook on Android or on iOS. For more information on supported APIs in Outlook mobile, see
12014
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
12015
+ *
11989
12016
  * @param formData - A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
11990
12017
  * OR a {@link Office.ReplyFormData | ReplyFormData} object that contains body or attachment data and a callback function.
11991
12018
  * @param options - An object literal that contains one or more of the following properties:-
@@ -11997,15 +12024,6 @@ declare namespace Office {
11997
12024
  /**
11998
12025
  * Displays a reply form that includes only the sender of the selected message or the organizer of the selected appointment.
11999
12026
  *
12000
- * In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
12001
- *
12002
- * If any of the string parameters exceed their limits, `displayReplyFormAsync` throws an exception.
12003
- *
12004
- * When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
12005
- * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
12006
- *
12007
- * **Note**: This method isn't supported in Outlook on iOS or on Android.
12008
- *
12009
12027
  * @remarks
12010
12028
  * [Api set: Mailbox 1.9]
12011
12029
  *
@@ -12013,6 +12031,19 @@ declare namespace Office {
12013
12031
  *
12014
12032
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Attendee
12015
12033
  *
12034
+ * **Important**:
12035
+ *
12036
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
12037
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
12038
+ *
12039
+ * - If any of the string parameters exceed their limits, `displayReplyFormAsync` throws an exception.
12040
+ *
12041
+ * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
12042
+ * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
12043
+ *
12044
+ * - This method isn't supported in Outlook on Android or on iOS. For more information on supported APIs in Outlook mobile, see
12045
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
12046
+ *
12016
12047
  * @param formData - A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
12017
12048
  * OR a {@link Office.ReplyFormData | ReplyFormData} object that contains body or attachment data and a callback function.
12018
12049
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
@@ -12024,9 +12055,9 @@ declare namespace Office {
12024
12055
  *
12025
12056
  * The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best practice, you should get
12026
12057
  * the attachment's identifier from an {@link Office.AppointmentRead.attachments | item.attachments} call, then in the same session, use that identifier
12027
- * to retrieve the attachment. In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
12028
- * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
12029
- * continue in a separate window.
12058
+ * to retrieve the attachment. In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
12059
+ * the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing an
12060
+ * inline form then subsequently pops out the form to continue in a separate window.
12030
12061
  *
12031
12062
  * @remarks
12032
12063
  * [Api set: Mailbox 1.8]
@@ -12055,9 +12086,9 @@ declare namespace Office {
12055
12086
  *
12056
12087
  * The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best practice, you should get
12057
12088
  * the attachment's identifier from an {@link Office.AppointmentRead.attachments | item.attachments} call, then in the same session, use that identifier
12058
- * to retrieve the attachment. In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
12059
- * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
12060
- * continue in a separate window.
12089
+ * to retrieve the attachment. In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
12090
+ * the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing an
12091
+ * inline form then subsequently pops out the form to continue in a separate window.
12061
12092
  *
12062
12093
  * @remarks
12063
12094
  * [Api set: Mailbox 1.8]
@@ -12461,11 +12492,13 @@ declare namespace Office {
12461
12492
  *
12462
12493
  * For item attachments that represent messages and were attached by drag-and-drop or "Attach Item",
12463
12494
  * the formatting is a string representing an .eml formatted file.
12464
- * **Important**: If a message item was attached by drag-and-drop in Outlook on the web, then `getAttachmentContentAsync` throws an error.
12465
12495
  *
12466
12496
  * For item attachments that represent calendar items and were attached by drag-and-drop or "Attach Item",
12467
12497
  * the formatting is a string representing an .icalendar file.
12468
- * **Important**: If a calendar item was attached by drag-and-drop in Outlook on the web, then `getAttachmentContentAsync` throws an error.
12498
+ *
12499
+ * **Important**: If a message or calendar item was attached by drag-and-drop in Outlook on the web or
12500
+ * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
12501
+ * then `getAttachmentContentAsync` throws an error.
12469
12502
  *
12470
12503
  * For cloud attachments, the formatting is a URL string.
12471
12504
  */
@@ -12784,10 +12817,11 @@ declare namespace Office {
12784
12817
  *
12785
12818
  * **Important**:
12786
12819
  *
12787
- * - After the content is prepended, the position of the cursor depends on which client the add-in is running. In Outlook on the web and on Windows, the cursor
12788
- * position remains the same in the pre-existing content of the body. For example, if the cursor was positioned at the beginning of the body prior to the
12789
- * `prependAsync` call, it will appear between the prepended content and the pre-existing content of the body after the call. In Outlook on Mac, the cursor
12790
- * position isn't preserved. The cursor disappears after the `prependAsync` call and only reappears when the user selects something in the body of the mail item.
12820
+ * - After the content is prepended, the position of the cursor depends on which client the add-in is running. In Outlook on the web and on Windows
12821
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), the cursor position remains the same in the preexisting content of the body.
12822
+ * For example, if the cursor was positioned at the beginning of the body prior to the `prependAsync` call, it will appear between the prepended content and the preexisting
12823
+ * content of the body after the call. In Outlook on Mac, the cursor position isn't preserved. The cursor disappears after the `prependAsync` call and only reappears when the
12824
+ * user selects something in the body of the mail item.
12791
12825
  *
12792
12826
  * - When working with HTML-formatted bodies, it's important to note that the client may modify the value passed to `prependAsync` to
12793
12827
  * make it render efficiently with its rendering engine. This means that the value returned from a subsequent call to the `Body.getAsync` method
@@ -12826,10 +12860,11 @@ declare namespace Office {
12826
12860
  *
12827
12861
  * **Important**:
12828
12862
  *
12829
- * - After the content is prepended, the position of the cursor depends on which client the add-in is running. In Outlook on the web and on Windows, the cursor
12830
- * position remains the same in the pre-existing content of the body. For example, if the cursor was positioned at the beginning of the body prior to the
12831
- * `prependAsync` call, it will appear between the prepended content and the pre-existing content of the body after the call. In Outlook on Mac, the cursor
12832
- * position isn't preserved. The cursor disappears after the `prependAsync` call and only reappears when the user selects something in the body of the mail item.
12863
+ * - After the content is prepended, the position of the cursor depends on which client the add-in is running. In Outlook on the web and on Windows
12864
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), the cursor position remains the same in the preexisting content of the body.
12865
+ * For example, if the cursor was positioned at the beginning of the body prior to the `prependAsync` call, it will appear between the prepended content and the preexisting
12866
+ * content of the body after the call. In Outlook on Mac, the cursor position isn't preserved. The cursor disappears after the `prependAsync` call and only reappears when the
12867
+ * user selects something in the body of the mail item.
12833
12868
  *
12834
12869
  * - When working with HTML-formatted bodies, it's important to note that the client may modify the value passed to `prependAsync` to
12835
12870
  * make it render efficiently with its rendering engine. This means that the value returned from a subsequent call to the `Body.getAsync` method
@@ -12944,10 +12979,11 @@ declare namespace Office {
12944
12979
  *
12945
12980
  * **Important**:
12946
12981
  *
12947
- * - After the body is replaced with the specified content, the position of the cursor depends on which client the add-in is running. In Outlook on Windows,
12948
- * the cursor appears at the beginning of the body of the mail item, while in Outlook on the web, the cursor appears at the end of the body of the mail item.
12949
- * In Outlook on Mac, the cursor position isn't preserved. The cursor disappears after the `prependAsync` call and only reappears when the user selects
12950
- * something in the body of the mail item.
12982
+ * - After the body is replaced with the specified content, the position of the cursor depends on which client the add-in is running.
12983
+ * In classic Outlook on Windows, the cursor appears at the beginning of the body of the mail item.
12984
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
12985
+ * the cursor appears at the end of the body of the mail item. In Outlook on Mac, the cursor position isn't preserved.
12986
+ * The cursor disappears after the `prependAsync` call and only reappears when the user selects something in the body of the mail item.
12951
12987
  *
12952
12988
  * - When working with HTML-formatted bodies, it's important to note that the value returned by the `Body.getAsync` method won't necessarily
12953
12989
  * be the exact same value that was previously passed in the `Body.setAsync` method. The client may modify the value passed to `setAsync` to make it
@@ -12990,10 +13026,11 @@ declare namespace Office {
12990
13026
  *
12991
13027
  * **Important**:
12992
13028
  *
12993
- * - After the body is replaced with the specified content, the position of the cursor depends on which client the add-in is running. In Outlook on Windows,
12994
- * the cursor appears at the beginning of the body of the mail item, while in Outlook on the web, the cursor appears at the end of the body of the mail item.
12995
- * In Outlook on Mac, the cursor position isn't preserved. The cursor disappears after the `prependAsync` call and only reappears when the user selects
12996
- * something in the body of the mail item.
13029
+ * - After the body is replaced with the specified content, the position of the cursor depends on which client the add-in is running.
13030
+ * In classic Outlook on Windows, the cursor appears at the beginning of the body of the mail item.
13031
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13032
+ * the cursor appears at the end of the body of the mail item. In Outlook on Mac, the cursor position isn't preserved.
13033
+ * The cursor disappears after the `prependAsync` call and only reappears when the user selects something in the body of the mail item.
12997
13034
  *
12998
13035
  * - When working with HTML-formatted bodies, it's important to note that the value returned by the `Body.getAsync` method won't necessarily
12999
13036
  * be the exact same value that was previously passed in the `Body.setAsync` method. The client may modify the value passed to `setAsync` to make it
@@ -13096,7 +13133,8 @@ declare namespace Office {
13096
13133
  *
13097
13134
  * **Important**:
13098
13135
  *
13099
- * - In Outlook on the web, `setSignatureAsync` only works on messages.
13136
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13137
+ * `setSignatureAsync` only works on messages.
13100
13138
  *
13101
13139
  * - This method is supported in Message Compose on Outlook on Android and on iOS starting in Version 4.2352.0. For a sample scenario, see
13102
13140
  * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/mobile-event-based | Implement event-based activation in Outlook mobile add-ins}.
@@ -13135,7 +13173,8 @@ declare namespace Office {
13135
13173
  *
13136
13174
  * **Important**:
13137
13175
  *
13138
- * - In Outlook on the web, `setSignatureAsync` only works on messages.
13176
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13177
+ * `setSignatureAsync` only works on messages.
13139
13178
  *
13140
13179
  * - This method is supported in Message Compose on Outlook on Android and on iOS starting in Version 4.2352.0. For a sample scenario, see
13141
13180
  * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/mobile-event-based | Implement event-based activation in Outlook mobile add-ins}.
@@ -13166,7 +13205,8 @@ declare namespace Office {
13166
13205
  * The user defines {@link Office.MasterCategories | categories in a master list} on their mailbox.
13167
13206
  * They can then apply one or more categories to an item.
13168
13207
  *
13169
- * **Important**: In Outlook on the web, you can't use the API to manage categories applied to a message in Compose mode.
13208
+ * **Important**: In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13209
+ * you can't use the API to manage categories applied to a message in Compose mode.
13170
13210
  *
13171
13211
  * @remarks
13172
13212
  * [Api set: Mailbox 1.8]
@@ -13180,7 +13220,8 @@ declare namespace Office {
13180
13220
  * Adds categories to an item. Each category must be in the categories master list on that mailbox and so must have a unique name
13181
13221
  * but multiple categories can use the same color.
13182
13222
  *
13183
- * **Important**: In Outlook on the web, you can't use the API to manage categories applied to a message or appointment item in Compose mode.
13223
+ * **Important**: In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13224
+ * you can't use the API to manage categories applied to a message or appointment item in Compose mode.
13184
13225
  *
13185
13226
  * @remarks
13186
13227
  * [Api set: Mailbox 1.8]
@@ -13204,7 +13245,8 @@ declare namespace Office {
13204
13245
  * Adds categories to an item. Each category must be in the categories master list on that mailbox and so must have a unique name
13205
13246
  * but multiple categories can use the same color.
13206
13247
  *
13207
- * **Important**: In Outlook on the web, you can't use the API to manage categories applied to a message or appointment item in Compose mode.
13248
+ * **Important**: In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13249
+ * you can't use the API to manage categories applied to a message or appointment item in Compose mode.
13208
13250
  *
13209
13251
  * @remarks
13210
13252
  * [Api set: Mailbox 1.8]
@@ -13230,7 +13272,8 @@ declare namespace Office {
13230
13272
  * - If there are no categories on the item, `null` or an empty array will be returned depending on the Outlook version
13231
13273
  * so make sure to handle both cases.
13232
13274
  *
13233
- * - In Outlook on the web, you can't use the API to manage categories applied to a message in Compose mode.
13275
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13276
+ * you can't use the API to manage categories applied to a message in Compose mode.
13234
13277
  *
13235
13278
  * @remarks
13236
13279
  * [Api set: Mailbox 1.8]
@@ -13253,7 +13296,8 @@ declare namespace Office {
13253
13296
  * - If there are no categories on the item, `null` or an empty array will be returned depending on the Outlook version
13254
13297
  * so make sure to handle both cases.
13255
13298
  *
13256
- * - In Outlook on the web, you can't use the API to manage categories applied to a message in Compose mode.
13299
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13300
+ * you can't use the API to manage categories applied to a message in Compose mode.
13257
13301
  *
13258
13302
  * @remarks
13259
13303
  * [Api set: Mailbox 1.8]
@@ -13269,7 +13313,8 @@ declare namespace Office {
13269
13313
  /**
13270
13314
  * Removes categories from an item.
13271
13315
  *
13272
- * **Important**: In Outlook on the web, you can't use the API to manage categories applied to a message in Compose mode.
13316
+ * **Important**: In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13317
+ * you can't use the API to manage categories applied to a message in Compose mode.
13273
13318
  *
13274
13319
  * @remarks
13275
13320
  * [Api set: Mailbox 1.8]
@@ -13288,7 +13333,8 @@ declare namespace Office {
13288
13333
  /**
13289
13334
  * Removes categories from an item.
13290
13335
  *
13291
- * **Important**: In Outlook on the web, you can't use the API to manage categories applied to a message in Compose mode.
13336
+ * **Important**: In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13337
+ * you can't use the API to manage categories applied to a message in Compose mode.
13292
13338
  *
13293
13339
  * @remarks
13294
13340
  * [Api set: Mailbox 1.8]
@@ -13683,15 +13729,15 @@ declare namespace Office {
13683
13729
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
13684
13730
  *
13685
13731
  * **Important**: The `Outlook` value is returned for Outlook desktop clients on Windows and on Mac. `newOutlookWindows` is returned for the
13686
- * {@link https://insider.microsoft365.com/blog/new-outlook-for-windows-available-to-all-office-insiders | new Outlook on Windows desktop client}
13687
- * currently in preview.
13732
+ * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows desktop client}.
13688
13733
  */
13689
13734
  hostName: string;
13690
13735
  /**
13691
13736
  * Gets a string that represents the version of either the Outlook client or the Exchange Server (for example, "15.0.468.0").
13692
13737
  *
13693
- * If the mail add-in is running in Outlook on a desktop or mobile client, the `hostVersion` property returns the version of the
13694
- * Outlook client. In Outlook on the web, the property returns the version of the Exchange Server.
13738
+ * If the mail add-in is running in Outlook on Windows (classic), on Mac, or on mobile devices, the `hostVersion` property returns the version of the
13739
+ * Outlook client. In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
13740
+ * the property returns the version of the Exchange Server.
13695
13741
  *
13696
13742
  * @remarks
13697
13743
  *
@@ -13962,10 +14008,6 @@ declare namespace Office {
13962
14008
  /**
13963
14009
  * Represents an email account on an Exchange Server.
13964
14010
  *
13965
- * `EmailUser` objects are primarily received in {@link Office.MeetingSuggestion | MeetingSuggestion} and
13966
- * {@link Office.TaskSuggestion | TaskSuggestion} entities extracted from an Outlook item. To learn more about this scenario, refer to
13967
- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/extract-entity-strings-from-an-item | Extract entity strings from an Outlook item}.
13968
- *
13969
14011
  * @remarks
13970
14012
  *
13971
14013
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read item**
@@ -14828,8 +14870,9 @@ declare namespace Office {
14828
14870
  * **Note**: The "Outlook" value is returned for Outlook on desktop clients (i.e., Windows and Mac).
14829
14871
  *
14830
14872
  * - `hostVersion` (string): A string that represents the version of either the Office application or the Exchange Server (e.g., "15.0.468.0").
14831
- * If the mail add-in is running in Outlook on desktop or on mobile clients, the `hostVersion` property returns the version of the
14832
- * application, Outlook. In Outlook on the web, the property returns the version of the Exchange Server.
14873
+ * If the mail add-in is running in Outlook on Windows (classic), on Mac, or on mobile devices, the `hostVersion` property returns the version of the
14874
+ * Outlook client. In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
14875
+ * the property returns the version of the Exchange Server.
14833
14876
  *
14834
14877
  * - `OWAView` (`MailboxEnums.OWAView` or string): An enum (or string literal) that represents the current view of Outlook on the web.
14835
14878
  * If the application is not Outlook on the web, then accessing this property results in undefined.
@@ -14992,14 +15035,13 @@ declare namespace Office {
14992
15035
  /**
14993
15036
  * Gets a dictionary containing time information in local client time.
14994
15037
  *
14995
- * The dates and times used by a mail app for Outlook on the web or on desktop clients can use different time zones.
14996
- * Outlook uses the client computer time zone; Outlook on the web uses the time zone set on the Exchange Admin Center (EAC).
14997
- * You should handle date and time values so that the values you display on the user interface are always consistent with the time zone that
14998
- * the user expects.
15038
+ * The time zone used by the Outlook client varies by platform.
15039
+ * Outlook on Windows (classic) and on Mac use the client computer time zone.
15040
+ * Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows} use the time zone set on the Exchange Admin Center (EAC).
15041
+ * You should handle date and time values so that the values you display on the user interface are always consistent with the time zone that the user expects.
14999
15042
  *
15000
- * If the mail app is running in Outlook on desktop clients, the `convertToLocalClientTime` method will return a dictionary object
15001
- * with the values set to the client computer time zone.
15002
- * If the mail app is running in Outlook on the web, the `convertToLocalClientTime` method will return a dictionary object
15043
+ * In Outlook on Windows (classic) and on Mac, the `convertToLocalClientTime` method returns a dictionary object with the values set to the client computer time zone.
15044
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, the `convertToLocalClientTime` method returns a dictionary object
15003
15045
  * with the values set to the time zone specified in the EAC.
15004
15046
  *
15005
15047
  * @remarks
@@ -15063,7 +15105,8 @@ declare namespace Office {
15063
15105
  * of a recurring series. However, you can't display an instance of the series because you can't access the properties
15064
15106
  * (including the item ID) of instances of a recurring series.
15065
15107
  *
15066
- * In Outlook on the web, this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15108
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
15109
+ * this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15067
15110
  *
15068
15111
  * If the specified item identifier does not identify an existing appointment, a blank pane opens on the client computer or device, and
15069
15112
  * no error message is returned.
@@ -15091,7 +15134,8 @@ declare namespace Office {
15091
15134
  * of a recurring series. However, you can't display an instance of the series because you can't access the properties
15092
15135
  * (including the item ID) of instances of a recurring series.
15093
15136
  *
15094
- * In Outlook on the web, this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15137
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
15138
+ * this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15095
15139
  *
15096
15140
  * If the specified item identifier does not identify an existing appointment, a blank pane opens on the client computer or device, and
15097
15141
  * no error message is returned.
@@ -15122,7 +15166,8 @@ declare namespace Office {
15122
15166
  * of a recurring series. However, you can't display an instance of the series because you can't access the properties
15123
15167
  * (including the item ID) of instances of a recurring series.
15124
15168
  *
15125
- * In Outlook on the web, this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15169
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
15170
+ * this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15126
15171
  *
15127
15172
  * If the specified item identifier does not identify an existing appointment, a blank pane opens on the client computer or device, and
15128
15173
  * no error message is returned.
@@ -15146,7 +15191,8 @@ declare namespace Office {
15146
15191
  *
15147
15192
  * The `displayMessageForm` method opens an existing message in a new window on the desktop.
15148
15193
  *
15149
- * In Outlook on the web, this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15194
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
15195
+ * this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15150
15196
  *
15151
15197
  * If the specified item identifier doesn't identify an existing message, no message will be displayed on the client computer, and
15152
15198
  * no error message is returned.
@@ -15174,7 +15220,8 @@ declare namespace Office {
15174
15220
  *
15175
15221
  * The `displayMessageFormAsync` method opens an existing message in a new window on the desktop or in a dialog box on mobile devices.
15176
15222
  *
15177
- * In Outlook on the web, this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15223
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
15224
+ * this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15178
15225
  *
15179
15226
  * If the specified item identifier does not identify an existing message, no message will be displayed on the client computer, and
15180
15227
  * no error message is returned.
@@ -15204,7 +15251,8 @@ declare namespace Office {
15204
15251
  *
15205
15252
  * The `displayMessageFormAsync` method opens an existing message in a new window on the desktop or in a dialog box on mobile devices.
15206
15253
  *
15207
- * In Outlook on the web, this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15254
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
15255
+ * this method opens the specified form only if the body of the form is less than or equal to 32K characters.
15208
15256
  *
15209
15257
  * If the specified item identifier does not identify an existing message, no message will be displayed on the client computer, and
15210
15258
  * no error message is returned.
@@ -15233,7 +15281,8 @@ declare namespace Office {
15233
15281
  * The `displayNewAppointmentForm` method opens a form that enables the user to create a new appointment or meeting.
15234
15282
  * If parameters are specified, the appointment form fields are automatically populated with the contents of the parameters.
15235
15283
  *
15236
- * In Outlook on the web, this method always displays a form with an attendees field.
15284
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
15285
+ * this method always displays a form with an attendees field.
15237
15286
  * If you don't specify any attendees as input arguments, the method displays a form with a **Save** button.
15238
15287
  * If you have specified attendees, the form would include the attendees and a **Send** button.
15239
15288
  *
@@ -15262,7 +15311,8 @@ declare namespace Office {
15262
15311
  * The `displayNewAppointmentFormAsync` method opens a form that enables the user to create a new appointment or meeting.
15263
15312
  * If parameters are specified, the appointment form fields are automatically populated with the contents of the parameters.
15264
15313
  *
15265
- * In Outlook on the web, this method always displays a form with an attendees field.
15314
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
15315
+ * this method always displays a form with an attendees field.
15266
15316
  * If you do not specify any attendees as input arguments, the method displays a form with a **Save** button.
15267
15317
  * If you have specified attendees, the form would include the attendees and a **Send** button.
15268
15318
  *
@@ -15294,7 +15344,8 @@ declare namespace Office {
15294
15344
  * The `displayNewAppointmentFormAsync` method opens a form that enables the user to create a new appointment or meeting.
15295
15345
  * If parameters are specified, the appointment form fields are automatically populated with the contents of the parameters.
15296
15346
  *
15297
- * In Outlook on the web, this method always displays a form with an attendees field.
15347
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
15348
+ * this method always displays a form with an attendees field.
15298
15349
  * If you do not specify any attendees as input arguments, the method displays a form with a **Save** button.
15299
15350
  * If you have specified attendees, the form would include the attendees and a **Send** button.
15300
15351
  *
@@ -15736,16 +15787,17 @@ declare namespace Office {
15736
15787
  *
15737
15788
  * - When you use the `makeEwsRequestAsync` method in add-ins that run in Outlook versions earlier than Version 15.0.4535.1004, you must set
15738
15789
  * the encoding value to ISO-8859-1 (`<?xml version="1.0" encoding="iso-8859-1"?>`). To determine the version of an Outlook client, use the
15739
- * `mailbox.diagnostics.hostVersion` property. You don't need to set the encoding value when your add-in is running in Outlook on the web.
15790
+ * `mailbox.diagnostics.hostVersion` property. You don't need to set the encoding value when your add-in is running in Outlook on the web and
15791
+ * {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}.
15740
15792
  * To determine the Outlook client in which your add-in is running, use the `mailbox.diagnostics.hostName` property.
15741
15793
  *
15742
15794
  * @param data - The EWS request.
15743
15795
  * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter,
15744
15796
  * `asyncResult`, which is an `Office.AsyncResult` object. The XML response of the EWS request is provided as a string
15745
- * in the `asyncResult.value` property. In Outlook on the web, on Windows (starting in Version 2303 (Build 16225.10000)),
15746
- * and on Mac (starting in Version 16.73 (23042601)), if the response exceeds 5 MB in size, an error message is returned
15747
- * in the `asyncResult.error` property. In earlier versions of the Outlook desktop client, an error message is returned if
15748
- * the response exceeds 1 MB in size.
15797
+ * in the `asyncResult.value` property. In Outlook on the web, on Windows
15798
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic (starting in Version 2303, Build 16225.10000)),
15799
+ * and on Mac (starting in Version 16.73 (23042601)), if the response exceeds 5 MB in size, an error message is returned in the `asyncResult.error` property.
15800
+ * In earlier versions of Outlook on Windows (classic) and on Mac, an error message is returned if the response exceeds 1 MB in size.
15749
15801
  * @param userContext - Optional. Any state data that is passed to the asynchronous method.
15750
15802
  */
15751
15803
  makeEwsRequestAsync(data: any, callback: (asyncResult: Office.AsyncResult<string>) => void, userContext?: any): void;
@@ -16102,7 +16154,8 @@ declare namespace Office {
16102
16154
  /**
16103
16155
  * Gets an object that provides methods for managing the item's categories.
16104
16156
  *
16105
- * **Important**: In Outlook on the web, you can't use the API to manage categories on a message in Compose mode.
16157
+ * **Important**: In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
16158
+ * you can't use the API to manage categories on a message in Compose mode.
16106
16159
  *
16107
16160
  * @remarks
16108
16161
  * [Api set: Mailbox 1.8]
@@ -16253,8 +16306,9 @@ declare namespace Office {
16253
16306
  /**
16254
16307
  * Gets the ID of the series that an instance belongs to.
16255
16308
  *
16256
- * In Outlook on the web and on desktop clients, the `seriesId` returns the Exchange Web Services (EWS) ID of the parent (series) item
16257
- * that this item belongs to. However, on iOS and Android, the seriesId returns the REST ID of the parent item.
16309
+ * In Outlook on the web, on Windows ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), and on Mac,
16310
+ * the `seriesId` returns the Exchange Web Services (EWS) ID of the parent (series) item that this item belongs to.
16311
+ * However, on iOS and Android, the seriesId returns the REST ID of the parent item.
16258
16312
  *
16259
16313
  * **Note**: The identifier returned by the `seriesId` property is the same as the Exchange Web Services item identifier.
16260
16314
  * The `seriesId` property is not identical to the Outlook IDs used by the Outlook REST API.
@@ -16528,8 +16582,8 @@ declare namespace Office {
16528
16582
  *
16529
16583
  * You can subsequently use the identifier with the `removeAttachmentAsync` method to remove the attachment in the same session.
16530
16584
  *
16531
- * If your Office Add-in is running in Outlook on the web, the `addItemAttachmentAsync` method can attach items to items other than the item that
16532
- * you are editing; however, this is not supported and is not recommended.
16585
+ * If your Office Add-in is running in Outlook on the web or {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
16586
+ * the `addItemAttachmentAsync` method can attach items to items other than the item that you are editing. However, this isn't supported and isn't recommended.
16533
16587
  *
16534
16588
  * @remarks
16535
16589
  * [Api set: Mailbox 1.1]
@@ -16562,8 +16616,8 @@ declare namespace Office {
16562
16616
  *
16563
16617
  * You can subsequently use the identifier with the `removeAttachmentAsync` method to remove the attachment in the same session.
16564
16618
  *
16565
- * If your Office Add-in is running in Outlook on the web, the `addItemAttachmentAsync` method can attach items to items other than the item that
16566
- * you are editing; however, this is not supported and is not recommended.
16619
+ * If your Office Add-in is running in Outlook on the web or {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
16620
+ * the `addItemAttachmentAsync` method can attach items to items other than the item that you are editing. However, this isn't supported and isn't recommended.
16567
16621
  *
16568
16622
  * @remarks
16569
16623
  * [Api set: Mailbox 1.1]
@@ -16599,8 +16653,9 @@ declare namespace Office {
16599
16653
  *
16600
16654
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Compose
16601
16655
  *
16602
- * **Important**: In Outlook on the web, if the item is an appointment and it has previously been saved using `saveAsync`, the user is prompted to save,
16603
- * discard, or cancel even if no changes have occurred since the item was last saved.
16656
+ * **Important**: In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
16657
+ * if the item is an appointment and it has previously been saved using `saveAsync`, the user is prompted to save, discard, or cancel even if no changes
16658
+ * have occurred since the item was last saved.
16604
16659
  *
16605
16660
  * **Tip**: Use the
16606
16661
  * {@link https://learn.microsoft.com/javascript/api/outlook/office.messagecompose#outlook-office-messagecompose-closeasync-member(1) | closeAsync}
@@ -16671,10 +16726,11 @@ declare namespace Office {
16671
16726
  *
16672
16727
  * The behavior of this method depends on which client the add-in is running.
16673
16728
  *
16674
- * - In Outlook on the web, the signature option for new mails, replies, and forwards is disabled.
16729
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
16730
+ * the signature option for new mails, replies, and forwards is disabled.
16675
16731
  * A signature that's selected is also disabled by the method.
16676
16732
  *
16677
- * - In Outlook on Windows and on Mac, the signature under the **New messages** and **Replies/forwards** sections
16733
+ * - In Outlook on Windows (classic) and on Mac, the signature under the **New messages** and **Replies/forwards** sections
16678
16734
  * of the sending account is set to **(none)**.
16679
16735
  *
16680
16736
  * - In Outlook on Android and on iOS, the signature saved on the mobile device is cleared.
@@ -16701,10 +16757,11 @@ declare namespace Office {
16701
16757
  *
16702
16758
  * The behavior of this method depends on which client the add-in is running.
16703
16759
  *
16704
- * - In Outlook on the web, the signature option for new mails, replies, and forwards is disabled.
16760
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
16761
+ * the signature option for new mails, replies, and forwards is disabled.
16705
16762
  * A signature that's selected is also disabled by the method.
16706
16763
  *
16707
- * - In Outlook on Windows and on Mac, the signature under the **New messages** and **Replies/forwards** sections
16764
+ * - In Outlook on Windows (classic) and on Mac, the signature under the **New messages** and **Replies/forwards** sections
16708
16765
  * of the sending account is set to **(none)**.
16709
16766
  *
16710
16767
  * - In Outlook on Android and on iOS, the signature saved on the mobile device is cleared.
@@ -16729,9 +16786,9 @@ declare namespace Office {
16729
16786
  *
16730
16787
  * The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best practice, you should get
16731
16788
  * the attachment's identifier from a `getAttachmentsAsync` call, then in the same session, use that identifier to retrieve the attachment.
16732
- * In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
16733
- * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
16734
- * continue in a separate window.
16789
+ * In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
16790
+ * the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing an inline form
16791
+ * then subsequently pops out the form to continue in a separate window.
16735
16792
  *
16736
16793
  * @remarks
16737
16794
  * [Api set: Mailbox 1.8]
@@ -16760,9 +16817,9 @@ declare namespace Office {
16760
16817
  *
16761
16818
  * The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best practice, you should get
16762
16819
  * the attachment's identifier from a `getAttachmentsAsync` call, then in the same session, use that identifier to retrieve the attachment.
16763
- * In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
16764
- * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
16765
- * continue in a separate window.
16820
+ * In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
16821
+ * the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing an inline form
16822
+ * then subsequently pops out the form to continue in a separate window.
16766
16823
  *
16767
16824
  * @remarks
16768
16825
  * [Api set: Mailbox 1.8]
@@ -17153,7 +17210,8 @@ declare namespace Office {
17153
17210
  *
17154
17211
  * **Note**: This method isn't supported in Outlook on iOS or on Android.
17155
17212
  *
17156
- * **Important**: In Message Compose mode, this API isn't supported in Outlook on the web or on Windows unless the following conditions are met.
17213
+ * **Important**: In Message Compose mode, this API isn't supported in Outlook on the web or on Windows
17214
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic) unless the following conditions are met.
17157
17215
  *
17158
17216
  * a. **Delegate access/Shared folders**
17159
17217
  *
@@ -17195,7 +17253,8 @@ declare namespace Office {
17195
17253
  *
17196
17254
  * **Note**: This method isn't supported in Outlook on iOS or on Android.
17197
17255
  *
17198
- * **Important**: In Message Compose mode, this API isn't supported in Outlook on the web or on Windows unless the following conditions are met.
17256
+ * **Important**: In Message Compose mode, this API isn't supported in Outlook on the web or on Windows
17257
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic) unless the following conditions are met.
17199
17258
  *
17200
17259
  * a. **Delegate access/Shared folders**
17201
17260
  *
@@ -17223,10 +17282,12 @@ declare namespace Office {
17223
17282
  /**
17224
17283
  * Gets if the client signature is enabled.
17225
17284
  *
17226
- * For Windows and Mac rich clients, the API call should return `true` if the default signature for new messages, replies, or forwards is set
17285
+ * In Outlook on Windows (classic) and on Mac, the API call returns `true` if the default signature for new messages, replies, or forwards is set
17227
17286
  * to a template for the sending Outlook account.
17228
- * For Outlook on the web, the API call should return `true` if the signature is enabled for compose types `newMail`, `reply`, or `forward`.
17229
- * If the settings are set to "(none)" in Mac or Windows rich clients or disabled in Outlook on the web, the API call should return `false`.
17287
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
17288
+ * the API call returns `true` if the signature is enabled for compose types `newMail`, `reply`, or `forward`.
17289
+ * If the settings are set to "(none)" in Outlook on Windows (classic) or on Mac, or disabled in Outlook on the web or new Outlook on Windows,
17290
+ * the API call returns `false`.
17230
17291
  *
17231
17292
  * @remarks
17232
17293
  * [Api set: Mailbox 1.10]
@@ -17244,10 +17305,12 @@ declare namespace Office {
17244
17305
  /**
17245
17306
  * Gets if the client signature is enabled.
17246
17307
  *
17247
- * For Windows and Mac rich clients, the API call should return `true` if the default signature for new messages, replies, or forwards is set
17308
+ * In Outlook on Windows (classic) and on Mac, the API call returns `true` if the default signature for new messages, replies, or forwards is set
17248
17309
  * to a template for the sending Outlook account.
17249
- * For Outlook on the web, the API call should return `true` if the signature is enabled for compose types `newMail`, `reply`, or `forward`.
17250
- * If the settings are set to "(none)" in Mac or Windows rich clients or disabled in Outlook on the web, the API call should return `false`.
17310
+ * In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
17311
+ * the API call returns `true` if the signature is enabled for compose types `newMail`, `reply`, or `forward`.
17312
+ * If the settings are set to "(none)" in Outlook on Windows (classic) or on Mac, or disabled in Outlook on the web or new Outlook on Windows,
17313
+ * the API call returns `false`.
17251
17314
  *
17252
17315
  * @remarks
17253
17316
  * [Api set: Mailbox 1.10]
@@ -17291,7 +17354,8 @@ declare namespace Office {
17291
17354
  *
17292
17355
  * The `removeAttachmentAsync` method removes the attachment with the specified identifier from the item.
17293
17356
  * As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment
17294
- * in the same session. In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
17357
+ * in the same session. In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
17358
+ * the attachment identifier is valid only within the same session.
17295
17359
  * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
17296
17360
  * continue in a separate window.
17297
17361
  *
@@ -17311,7 +17375,7 @@ declare namespace Office {
17311
17375
  * - `InvalidAttachmentId`: The attachment identifier does not exist.
17312
17376
  *
17313
17377
  * @param attachmentId - The identifier of the attachment to remove. The maximum string length of the `attachmentId`
17314
- * is 200 characters in Outlook on the web and on Windows.
17378
+ * is 200 characters in Outlook on the web and on Windows (new and classic).
17315
17379
  * @param options - An object literal that contains one or more of the following properties:-
17316
17380
  * `asyncContext`: Developers can provide any object they wish to access in the callback function.
17317
17381
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter of
@@ -17324,7 +17388,8 @@ declare namespace Office {
17324
17388
  *
17325
17389
  * The `removeAttachmentAsync` method removes the attachment with the specified identifier from the item.
17326
17390
  * As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment
17327
- * in the same session. In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
17391
+ * in the same session. In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
17392
+ * the attachment identifier is valid only within the same session.
17328
17393
  * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
17329
17394
  * continue in a separate window.
17330
17395
  *
@@ -17344,7 +17409,7 @@ declare namespace Office {
17344
17409
  * - `InvalidAttachmentId`: The attachment identifier does not exist.
17345
17410
  *
17346
17411
  * @param attachmentId - The identifier of the attachment to remove. The maximum string length of the `attachmentId`
17347
- * is 200 characters in Outlook on the web and on Windows.
17412
+ * is 200 characters in Outlook on the web and on Windows (new and classic).
17348
17413
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter of
17349
17414
  * type `Office.AsyncResult`. If removing the attachment fails, the `asyncResult.error` property will contain an error code
17350
17415
  * with the reason for the failure.
@@ -17400,7 +17465,8 @@ declare namespace Office {
17400
17465
  *
17401
17466
  * **Important**:
17402
17467
  *
17403
- * - In Outlook on the web or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
17468
+ * - In Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, or classic Outlook on Windows
17469
+ * in online mode (non-cached mode), the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
17404
17470
  *
17405
17471
  * - When working with HTML-formatted content, it's important to note that the Outlook client may modify the content. This means that
17406
17472
  * subsequent calls to methods like `Body.getAsync`, `Body.setAsync`, and even `saveAsync` may not result in the same content.
@@ -17409,7 +17475,7 @@ declare namespace Office {
17409
17475
  * when Outlook is in cached mode, it may take some time before the item is actually synced to the server.
17410
17476
  * Until the item is synced, using the item ID will return an error.
17411
17477
  *
17412
- * - In Outlook on the web, the mailbox account to which a draft is saved varies when `saveAsync` is called on a message that will be sent
17478
+ * - In Outlook on the web and new Outlook on Windows, the mailbox account to which a draft is saved varies when `saveAsync` is called on a message that will be sent
17413
17479
  * from a shared mailbox account. If the sender creates a new message from their personal mailbox and selects the shared mailbox account
17414
17480
  * in the **From** field, `saveAsync` saves the draft to the **Drafts** folder of the user's personal mailbox. If the sender opens the
17415
17481
  * shared mailbox account in a separate browser tab (through the **Open another mailbox** option, for example) and creates a new message
@@ -17437,7 +17503,8 @@ declare namespace Office {
17437
17503
  *
17438
17504
  * **Important**:
17439
17505
  *
17440
- * - In Outlook on the web or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
17506
+ * - In Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, or classic Outlook on Windows
17507
+ * in online mode (non-cached mode), the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
17441
17508
  *
17442
17509
  * - When working with HTML-formatted content, it's important to note that the Outlook client may modify the content. This means that
17443
17510
  * subsequent calls to methods like `Body.getAsync`, `Body.setAsync`, and even `saveAsync` may not result in the same content.
@@ -17446,7 +17513,7 @@ declare namespace Office {
17446
17513
  * when Outlook is in cached mode, it may take some time before the item is actually synced to the server.
17447
17514
  * Until the item is synced, using the item ID will return an error.
17448
17515
  *
17449
- * - In Outlook on the web, the mailbox account to which a draft is saved varies when `saveAsync` is called on a message that will be sent
17516
+ * - In Outlook on the web and new Outlook on Windows, the mailbox account to which a draft is saved varies when `saveAsync` is called on a message that will be sent
17450
17517
  * from a shared mailbox account. If the sender creates a new message from their personal mailbox and selects the shared mailbox account
17451
17518
  * in the **From** field, `saveAsync` saves the draft to the **Drafts** folder of the user's personal mailbox. If the sender opens the
17452
17519
  * shared mailbox account in a separate browser tab (through the **Open another mailbox** option, for example) and creates a new message
@@ -17482,10 +17549,12 @@ declare namespace Office {
17482
17549
  * If more than 1,000,000 characters are passed in, an `ArgumentOutOfRange` exception is thrown.
17483
17550
  * @param options - An object literal that contains one or more of the following properties:-
17484
17551
  * `asyncContext`: Developers can provide any object they wish to access in the callback function.
17485
- * `coercionType`: If text, the current style is applied in Outlook on the web and on desktop clients.
17552
+ * `coercionType`: If text, the current style is applied in Outlook on the web, on Windows
17553
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), and on Mac.
17486
17554
  * If the field is an HTML editor, only the text data is inserted, even if the data is HTML.
17487
- * If html and the field supports HTML (the subject doesn't), the current style is applied in Outlook on the web and the default style is
17488
- * applied in Outlook on desktop clients. If the field is a text field, an `InvalidDataFormat` error is returned.
17555
+ * If the data is HTML and the field supports HTML (the subject doesn't), the current style is applied in
17556
+ * Outlook on the web and new Outlook on Windows. The default style is applied in Outlook on Windows (classic) and on Mac.
17557
+ * If the field is a text field, an `InvalidDataFormat` error is returned.
17489
17558
  * If `coercionType` is not set, the result depends on the field:
17490
17559
  * if the field is HTML then HTML is used; if the field is text, then plain text is used.
17491
17560
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter of
@@ -17832,8 +17901,9 @@ declare namespace Office {
17832
17901
  /**
17833
17902
  * Gets the ID of the series that an instance belongs to.
17834
17903
  *
17835
- * In Outlook on the web and on desktop clients, the `seriesId` returns the Exchange Web Services (EWS) ID of the parent (series) item
17836
- * that this item belongs to. However, on iOS and Android, the `seriesId` returns the REST ID of the parent item.
17904
+ * In Outlook on the web, on Windows ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), and on Mac,
17905
+ * the `seriesId` returns the Exchange Web Services (EWS) ID of the parent (series) item that this item belongs to.
17906
+ * However, in Outlook on Android and on iOS, the `seriesId` returns the REST ID of the parent item.
17837
17907
  *
17838
17908
  * **Note**: The identifier returned by the `seriesId` property is the same as the Exchange Web Services item identifier.
17839
17909
  * The `seriesId` property is not identical to the Outlook IDs used by the Outlook REST API.
@@ -17970,9 +18040,10 @@ declare namespace Office {
17970
18040
  *
17971
18041
  * **Important**:
17972
18042
  *
17973
- * - In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18043
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18044
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
17974
18045
  *
17975
- * - If any of the string parameters exceed their limits, `displayReplyForm` throws an exception.
18046
+ * - If any of the string parameters exceed their limits, `displayReplyAllForm` throws an exception.
17976
18047
  *
17977
18048
  * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
17978
18049
  * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
@@ -17988,15 +18059,6 @@ declare namespace Office {
17988
18059
  * Displays a reply form that includes either the sender and all recipients of the selected message or the organizer and all attendees of the
17989
18060
  * selected appointment.
17990
18061
  *
17991
- * In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
17992
- *
17993
- * If any of the string parameters exceed their limits, `displayReplyAllFormAsync` throws an exception.
17994
- *
17995
- * When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
17996
- * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
17997
- *
17998
- * **Note**: This method isn't supported in Outlook on iOS or on Android.
17999
- *
18000
18062
  * @remarks
18001
18063
  * [Api set: Mailbox 1.9]
18002
18064
  *
@@ -18004,6 +18066,19 @@ declare namespace Office {
18004
18066
  *
18005
18067
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Read
18006
18068
  *
18069
+ * **Important**:
18070
+ *
18071
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18072
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18073
+ *
18074
+ * - If any of the string parameters exceed their limits, `displayReplyAllFormAsync` throws an exception.
18075
+ *
18076
+ * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
18077
+ * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
18078
+ *
18079
+ * - This method isn't supported in Outlook on Android or on iOS. For more information on supported APIs in Outlook mobile, see
18080
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
18081
+ *
18007
18082
  * @param formData - A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
18008
18083
  * OR a {@link Office.ReplyFormData | ReplyFormData} object that contains body or attachment data and a callback function.
18009
18084
  * @param options - An object literal that contains one or more of the following properties:-
@@ -18016,15 +18091,6 @@ declare namespace Office {
18016
18091
  * Displays a reply form that includes either the sender and all recipients of the selected message or the organizer and all attendees of the
18017
18092
  * selected appointment.
18018
18093
  *
18019
- * In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18020
- *
18021
- * If any of the string parameters exceed their limits, `displayReplyAllFormAsync` throws an exception.
18022
- *
18023
- * When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
18024
- * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
18025
- *
18026
- * **Note**: This method isn't supported in Outlook on iOS or on Android.
18027
- *
18028
18094
  * @remarks
18029
18095
  * [Api set: Mailbox 1.9]
18030
18096
  *
@@ -18032,6 +18098,19 @@ declare namespace Office {
18032
18098
  *
18033
18099
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Read
18034
18100
  *
18101
+ * **Important**:
18102
+ *
18103
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18104
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18105
+ *
18106
+ * - If any of the string parameters exceed their limits, `displayReplyAllFormAsync` throws an exception.
18107
+ *
18108
+ * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
18109
+ * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
18110
+ *
18111
+ * - This method isn't supported in Outlook on Android or on iOS. For more information on supported APIs in Outlook mobile, see
18112
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
18113
+ *
18035
18114
  * @param formData - A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
18036
18115
  * OR a {@link Office.ReplyFormData | ReplyFormData} object that contains body or attachment data and a callback function.
18037
18116
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
@@ -18050,7 +18129,8 @@ declare namespace Office {
18050
18129
  *
18051
18130
  * **Important**:
18052
18131
  *
18053
- * - In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18132
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18133
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18054
18134
  *
18055
18135
  * - If any of the string parameters exceed their limits, `displayReplyForm` throws an exception.
18056
18136
  *
@@ -18067,15 +18147,6 @@ declare namespace Office {
18067
18147
  /**
18068
18148
  * Displays a reply form that includes only the sender of the selected message or the organizer of the selected appointment.
18069
18149
  *
18070
- * In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18071
- *
18072
- * If any of the string parameters exceed their limits, `displayReplyFormAsync` throws an exception.
18073
- *
18074
- * When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
18075
- * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
18076
- *
18077
- * **Note**: This method isn't supported in Outlook on iOS or on Android.
18078
- *
18079
18150
  * @remarks
18080
18151
  * [Api set: Mailbox 1.9]
18081
18152
  *
@@ -18083,6 +18154,19 @@ declare namespace Office {
18083
18154
  *
18084
18155
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Read
18085
18156
  *
18157
+ * **Important**:
18158
+ *
18159
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18160
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18161
+ *
18162
+ * - If any of the string parameters exceed their limits, `displayReplyFormAsync` throws an exception.
18163
+ *
18164
+ * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
18165
+ * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
18166
+ *
18167
+ * - This method isn't supported in Outlook on Android or on iOS. For more information on supported APIs in Outlook mobile, see
18168
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
18169
+ *
18086
18170
  * @param formData - A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
18087
18171
  * OR a {@link Office.ReplyFormData | ReplyFormData} object that contains body or attachment data and a callback function.
18088
18172
  * @param options - An object literal that contains one or more of the following properties:-
@@ -18094,15 +18178,6 @@ declare namespace Office {
18094
18178
  /**
18095
18179
  * Displays a reply form that includes only the sender of the selected message or the organizer of the selected appointment.
18096
18180
  *
18097
- * In Outlook on the web, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18098
- *
18099
- * If any of the string parameters exceed their limits, `displayReplyFormAsync` throws an exception.
18100
- *
18101
- * When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
18102
- * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
18103
- *
18104
- * **Note**: This method isn't supported in Outlook on iOS or on Android.
18105
- *
18106
18181
  * @remarks
18107
18182
  * [Api set: Mailbox 1.9]
18108
18183
  *
@@ -18110,6 +18185,19 @@ declare namespace Office {
18110
18185
  *
18111
18186
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Read
18112
18187
  *
18188
+ * **Important**:
18189
+ *
18190
+ * - In Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18191
+ * the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2-column or 1-column view.
18192
+ *
18193
+ * - If any of the string parameters exceed their limits, `displayReplyFormAsync` throws an exception.
18194
+ *
18195
+ * - When attachments are specified in the `formData.attachments` parameter, Outlook attempts to download all attachments and attach them to the
18196
+ * reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
18197
+ *
18198
+ * - This method isn't supported in Outlook on Android or on iOS. For more information on supported APIs in Outlook mobile, see
18199
+ * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
18200
+ *
18113
18201
  * @param formData - A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
18114
18202
  * OR a {@link Office.ReplyFormData | ReplyFormData} object that contains body or attachment data and a callback function.
18115
18203
  * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
@@ -18195,9 +18283,9 @@ declare namespace Office {
18195
18283
  *
18196
18284
  * The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best practice, you should get
18197
18285
  * the attachment's identifier from an {@link Office.MessageRead.attachments | item.attachments} call, then in the same session, use that identifier
18198
- * to retrieve the attachment. In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
18199
- * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
18200
- * continue in a separate window.
18286
+ * to retrieve the attachment. In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18287
+ * the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing an
18288
+ * inline form then subsequently pops out the form to continue in a separate window.
18201
18289
  *
18202
18290
  * @remarks
18203
18291
  * [Api set: Mailbox 1.8]
@@ -18226,9 +18314,9 @@ declare namespace Office {
18226
18314
  *
18227
18315
  * The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best practice, you should get
18228
18316
  * the attachment's identifier from an {@link Office.MessageRead.attachments | item.attachments} call, then in the same session, use that identifier
18229
- * to retrieve the attachment. In Outlook on the web and on mobile devices, the attachment identifier is valid only within the same session.
18230
- * A session is over when the user closes the app, or if the user starts composing an inline form then subsequently pops out the form to
18231
- * continue in a separate window.
18317
+ * to retrieve the attachment. In Outlook on the web, on mobile devices, and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18318
+ * the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing an
18319
+ * inline form then subsequently pops out the form to continue in a separate window.
18232
18320
  *
18233
18321
  * @remarks
18234
18322
  * [Api set: Mailbox 1.8]
@@ -18681,7 +18769,8 @@ declare namespace Office {
18681
18769
  *
18682
18770
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
18683
18771
  *
18684
- * **Important**: In modern Outlook on the web, the `NotificationMessageAction` object is available in Compose mode only.
18772
+ * **Important**: In modern Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18773
+ * the `NotificationMessageAction` object is available in Compose mode only.
18685
18774
  */
18686
18775
  interface NotificationMessageAction {
18687
18776
  /**
@@ -18765,7 +18854,8 @@ declare namespace Office {
18765
18854
  * Only applicable when the type is `InsightMessage`.
18766
18855
  * Specifying this property for an unsupported type or including too many actions throws an error.
18767
18856
  *
18768
- * **Important**: In modern Outlook on the web, the `actions` property is available in Compose mode only.
18857
+ * **Important**: In modern Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18858
+ * the `actions` property is available in Compose mode only.
18769
18859
  *
18770
18860
  * @remarks
18771
18861
  * [Api set: Mailbox 1.10]
@@ -18802,7 +18892,8 @@ declare namespace Office {
18802
18892
  * - Only one notification of type {@link https://learn.microsoft.com/javascript/api/outlook/office.mailboxenums.itemnotificationmessagetype#fields | InsightMessage}
18803
18893
  * is allowed per add-in. Attempting to add more will throw an error.
18804
18894
  *
18805
- * - In modern Outlook on the web, you can add an `InsightMessage` notification only in Compose mode.
18895
+ * - In modern Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18896
+ * you can add an `InsightMessage` notification only in Compose mode.
18806
18897
  *
18807
18898
  * - Only the `InformationalMessage` type is supported in Outlook on Android and on iOS.
18808
18899
  *
@@ -18833,7 +18924,8 @@ declare namespace Office {
18833
18924
  * - Only one notification of type {@link https://learn.microsoft.com/javascript/api/outlook/office.mailboxenums.itemnotificationmessagetype#fields | InsightMessage}
18834
18925
  * is allowed per add-in. Attempting to add more will throw an error.
18835
18926
  *
18836
- * - In modern Outlook on the web, you can add an `InsightMessage` notification only in Compose mode.
18927
+ * - In modern Outlook on the web and {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows},
18928
+ * you can add an `InsightMessage` notification only in Compose mode.
18837
18929
  *
18838
18930
  * - Only the `InformationalMessage` type is supported in Outlook on Android and on iOS.
18839
18931
  *
@@ -19099,10 +19191,11 @@ declare namespace Office {
19099
19191
  *
19100
19192
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
19101
19193
  *
19102
- * **Important**: With the `addAsync` method, you can add a maximum of 100 recipients to a mail item in Outlook on the web, on Windows,
19103
- * on Mac (classic UI), on Android, and on iOS. However, take note of the following:
19194
+ * **Important**: With the `addAsync` method, you can add a maximum of 100 recipients to a mail item in Outlook on the web, on Windows
19195
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), on Mac (classic UI), on Android, and on iOS.
19196
+ * However, take note of the following:
19104
19197
  *
19105
- * - In Outlook on the web, on Windows, and on Mac (classic UI), you can have a maximum of 500 recipients in a target field.
19198
+ * - In Outlook on the web, on Windows (new and classic), and on Mac (classic UI), you can have a maximum of 500 recipients in a target field.
19106
19199
  * If you need to add more than 100 recipients to a mail item, you can call `addAsync` repeatedly, but be mindful of the recipient limit of the field.
19107
19200
  *
19108
19201
  * - In Outlook on Android and on iOS, the `addAsync` method isn't supported in Message Compose mode. Only the Appointment Organizer mode is
@@ -19169,7 +19262,7 @@ declare namespace Office {
19169
19262
  *
19170
19263
  * The maximum number of recipients returned by this method varies per Outlook client.
19171
19264
  *
19172
- * - Windows, web browser, Mac (classic UI): 500 recipients
19265
+ * - Windows ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), web browser, Mac (classic UI): 500 recipients
19173
19266
  *
19174
19267
  * - Android, iOS: 100 recipients
19175
19268
  *
@@ -19188,10 +19281,10 @@ declare namespace Office {
19188
19281
  * To resolve an email address once it's added to a mail item, the sender must use the **Tab** key or select a suggested contact or email address from
19189
19282
  * the auto-complete list.
19190
19283
  *
19191
- * In Outlook on the web and on Windows, if a user creates a new message by activating a contact's email address link from their contact
19284
+ * In Outlook on the web and on Windows (new and classic), if a user creates a new message by activating a contact's email address link from their contact
19192
19285
  * or profile card, your add-in's `Recipients.getAsync` call returns the contact's email address in the `displayName` property of the associated
19193
- * {@link Office.EmailAddressDetails | EmailAddressDetails} object instead of the contact's saved name. For more details, see
19194
- * {@link https://github.com/OfficeDev/office-js/issues/2201 | related GitHub issue}.
19286
+ * {@link Office.EmailAddressDetails | EmailAddressDetails} object instead of the contact's saved name.
19287
+ * For more details, see {@link https://github.com/OfficeDev/office-js/issues/2201 | related GitHub issue}.
19195
19288
  *
19196
19289
  * @param options - An object literal that contains one or more of the following properties:-
19197
19290
  * `asyncContext`: Developers can provide any object they wish to access in the callback function.
@@ -19214,7 +19307,7 @@ declare namespace Office {
19214
19307
  *
19215
19308
  * The maximum number of recipients returned by this method varies per Outlook client.
19216
19309
  *
19217
- * - Windows, web browser, Mac (classic UI): 500 recipients
19310
+ * - Windows ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), web browser, Mac (classic UI): 500 recipients
19218
19311
  *
19219
19312
  * - Android, iOS: 100 recipients
19220
19313
  *
@@ -19233,10 +19326,10 @@ declare namespace Office {
19233
19326
  * To resolve an email address once it's added to a mail item, the sender must use the **Tab** key or select a suggested contact or email address from
19234
19327
  * the auto-complete list.
19235
19328
  *
19236
- * In Outlook on the web and on Windows, if a user creates a new message by activating a contact's email address link from their contact
19329
+ * In Outlook on the web and on Windows (new and classic), if a user creates a new message by activating a contact's email address link from their contact
19237
19330
  * or profile card, your add-in's `Recipients.getAsync` call returns the contact's email address in the `displayName` property of the associated
19238
- * {@link Office.EmailAddressDetails | EmailAddressDetails} object instead of the contact's saved name. For more details, see
19239
- * {@link https://github.com/OfficeDev/office-js/issues/2201 | related GitHub issue}.
19331
+ * {@link Office.EmailAddressDetails | EmailAddressDetails} object instead of the contact's saved name.
19332
+ * For more details, see {@link https://github.com/OfficeDev/office-js/issues/2201 | related GitHub issue}.
19240
19333
  *
19241
19334
  * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
19242
19335
  * of type `Office.AsyncResult`. The `asyncResult.value` property of the result is an array of
@@ -19255,10 +19348,11 @@ declare namespace Office {
19255
19348
  *
19256
19349
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
19257
19350
  *
19258
- * **Important**: With the `setAsync` method, you can set a maximum of 100 recipients in Outlook on the web, on Windows,
19259
- * on Mac (classic UI), on Android, and on iOS. However, take note of the following:
19351
+ * **Important**: With the `setAsync` method, you can set a maximum of 100 recipients in Outlook on the web, on Windows
19352
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), on Mac (classic UI), on Android, and on iOS.
19353
+ * However, take note of the following:
19260
19354
  *
19261
- * - In Outlook on the web, on Windows, and on Mac (classic UI), you can have a maximum of 500 recipients in a target field.
19355
+ * - In Outlook on the web, on Windows (new and classic), and on Mac (classic UI), you can have a maximum of 500 recipients in a target field.
19262
19356
  * If you need to set more than 100 recipients, you can call `setAsync` repeatedly, but be mindful of the recipient limit of the field.
19263
19357
  *
19264
19358
  * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
@@ -19292,10 +19386,11 @@ declare namespace Office {
19292
19386
  *
19293
19387
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
19294
19388
  *
19295
- * **Important**: With the `setAsync` method, you can set a maximum of 100 recipients in Outlook on the web, on Windows,
19296
- * on Mac (classic UI), on Android, and on iOS. However, take note of the following:
19389
+ * **Important**: With the `setAsync` method, you can set a maximum of 100 recipients in Outlook on the web, on Windows
19390
+ * ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} and classic), on Mac (classic UI), on Android, and on iOS.
19391
+ * However, take note of the following:
19297
19392
  *
19298
- * - In Outlook on the web, on Windows, and on Mac (classic UI), you can have a maximum of 500 recipients in a target field.
19393
+ * - In Outlook on the web, on Windows (new and classic), and on Mac (classic UI), you can have a maximum of 500 recipients in a target field.
19299
19394
  * If you need to set more than 100 recipients, you can call `setAsync` repeatedly, but be mindful of the recipient limit of the field.
19300
19395
  *
19301
19396
  * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
@@ -19729,7 +19824,8 @@ declare namespace Office {
19729
19824
  * your add-in has persisted changes.
19730
19825
  * The persisted changes will not be available until the task pane (or item in the case of UI-less add-ins) is closed and reopened.
19731
19826
  *
19732
- * - When set and saved through Outlook on Windows or on Mac, these settings are reflected in Outlook on the web only after a browser refresh.
19827
+ * - When set and saved through Outlook on Windows ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new} or classic) or on Mac,
19828
+ * these settings are reflected in Outlook on the web only after a browser refresh.
19733
19829
  *
19734
19830
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **restricted**
19735
19831
  *
@@ -19915,9 +20011,9 @@ declare namespace Office {
19915
20011
  *
19916
20012
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
19917
20013
  *
19918
- * **Important**: Outlook on the web, new Outlook on Windows (preview), and Outlook on Mac only support Normal and Private sensitivity levels.
19919
- * If you call `getAsync` on an appointment that has a Confidential or Personal sensitivity level from these clients, the Normal sensitivity level
19920
- * is returned in the `asyncResult.value` property.
20014
+ * **Important**: Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, and
20015
+ * Outlook on Mac only support Normal and Private sensitivity levels. If you call `getAsync` on an appointment that has a Confidential or Personal sensitivity
20016
+ * level from these clients, the Normal sensitivity level is returned in the `asyncResult.value` property.
19921
20017
  *
19922
20018
  * @param options - An object literal that contains one or more of the following properties:-
19923
20019
  * `asyncContext`: Developers can provide any object they wish to access in the callback function.
@@ -19935,9 +20031,9 @@ declare namespace Office {
19935
20031
  *
19936
20032
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
19937
20033
  *
19938
- * **Important**: Outlook on the web, new Outlook on Windows (preview), and Outlook on Mac only support Normal and Private sensitivity levels.
19939
- * If you call `getAsync` on an appointment that has a Confidential or Personal sensitivity level from these clients, the Normal sensitivity level
19940
- * is returned in the `asyncResult.value` property.
20034
+ * **Important**: Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, and
20035
+ * Outlook on Mac only support Normal and Private sensitivity levels. If you call `getAsync` on an appointment that has a Confidential or Personal sensitivity
20036
+ * level from these clients, the Normal sensitivity level is returned in the `asyncResult.value` property.
19941
20037
  *
19942
20038
  * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
19943
20039
  * which is an `Office.AsyncResult` object. The sensitivity level of the appointment is returned in the `asyncResult.value` property.
@@ -19953,7 +20049,8 @@ declare namespace Office {
19953
20049
  *
19954
20050
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
19955
20051
  *
19956
- * **Important**: Outlook on the web, new Outlook on Windows (preview), and Outlook on Mac only support Normal and Private sensitivity levels.
20052
+ * **Important**: Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, and Outlook on Mac
20053
+ * only support Normal and Private sensitivity levels.
19957
20054
  *
19958
20055
  * **Errors**:
19959
20056
  *
@@ -19976,7 +20073,8 @@ declare namespace Office {
19976
20073
  *
19977
20074
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
19978
20075
  *
19979
- * **Important**: Outlook on the web, new Outlook on Windows (preview), and Outlook on Mac only support Normal and Private sensitivity levels.
20076
+ * **Important**: Outlook on the web, {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}, and Outlook on Mac
20077
+ * only support Normal and Private sensitivity levels.
19980
20078
  *
19981
20079
  * **Errors**:
19982
20080
  *
@@ -20872,9 +20970,9 @@ declare namespace Office {
20872
20970
  *
20873
20971
  * **Important**:
20874
20972
  *
20875
- * - You can only use this property in a spam-reporting add-in in Outlook on the web, on Windows (starting in Version 2308 (Build 16724.10000)), on Mac,
20876
- * and in new Outlook on Windows (preview). If you're using an earlier build in Outlook on Windows that supports the integrated spam-reporting feature, use the
20877
- * `postProcessingAction` property instead.
20973
+ * - You can only use this property in a spam-reporting add-in in Outlook on the web, on Windows ({@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new}
20974
+ * and classic (starting in Version 2308, Build 16724.10000)), and on Mac. If you're using an earlier build of classic Outlook on Windows that supports the
20975
+ * integrated spam-reporting feature, use the `postProcessingAction` property instead.
20878
20976
  *
20879
20977
  * - If the property is set to `Office.MailboxEnums.MoveSpamItemTo.CustomFolder`, you must specify the name of the folder to which
20880
20978
  * the message will be moved in the `folderName` property of the `event.completed` call. Otherwise, the `moveItemTo` property will default to
@@ -20920,7 +21018,8 @@ declare namespace Office {
20920
21018
  * - In Outlook on Windows, you can only use this property in earlier builds that support the integrated spam-reporting feature.
20921
21019
  * If you're on Version 2308 (Build 16724.10000) or later, use the `moveItemTo` property instead.
20922
21020
  *
20923
- * - This property isn't supported in Outlook on the web, on Mac, or in new Outlook on Windows (preview). Use the `moveItemTo` property instead.
21021
+ * - This property isn't supported in Outlook on the web, on Mac, or in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}.
21022
+ * Use the `moveItemTo` property instead.
20924
21023
  *
20925
21024
  * - If the property is set to `moveToCustomFolder`, you must specify the name of the folder to which
20926
21025
  * the message will be moved in the `folderName` property of the `event.completed` call. Otherwise, the `postProcessingAction` property will default to
@@ -20939,12 +21038,6 @@ declare namespace Office {
20939
21038
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level (Outlook)}**: **read item**
20940
21039
  *
20941
21040
  * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Read
20942
- *
20943
- * **Important**: In Outlook on the web or in new Outlook on Windows (preview), a post-processing dialog isn't shown once the add-in completes processing a
20944
- * reported message. This applies even if `showPostProcessingDialog` is configured. However, depending on how you configured the `moveItemTo` property in the
20945
- * `event.completed` call, a notification is shown to signal when the reported message is deleted or moved to another folder in the mailbox. To learn more, see
20946
- * the "Review feature behavior and limitations" section of
20947
- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/spam-reporting#review-feature-behavior-and-limitations | Implement an integrated spam-reporting add-in}.
20948
21041
  */
20949
21042
  showPostProcessingDialog?: object;
20950
21043
  }
@@ -21268,7 +21361,8 @@ declare namespace Office {
21268
21361
  /**
21269
21362
  * Gets the user's time zone in Windows format.
21270
21363
  *
21271
- * The system time zone is usually returned. However, in Outlook on the web, the default time zone in the calendar preferences is returned instead.
21364
+ * The system time zone is usually returned. However, in Outlook on the web and in {@link https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627 | new Outlook on Windows}),
21365
+ * the default time zone in the calendar preferences is returned instead.
21272
21366
  *
21273
21367
  * @remarks
21274
21368
  *