@types/office-js-preview 1.0.366 → 1.0.368

office-js-preview/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Office.js (https://github.com/OfficeD
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview.
 
 ### Additional Details
- * Last updated: Tue, 10 Jan 2023 21:03:12 GMT
+ * Last updated: Thu, 19 Jan 2023 19:32:41 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js-preview/index.d.ts

@@ -1002,6 +1002,19 @@ declare namespace Office {
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
          */
         roamingSettings: Office.RoamingSettings;
+        /**
+         * Gets the object to check the status of the catalog of sensitivity labels in Outlook and retrieve all available
+         * sensitivity labels if the catalog is enabled.
+         * 
+         * @remarks
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * @beta
+         */
+        sensitivityLabelsCatalog: Office.SensitivityLabelsCatalog;
         /**
          * Specifies whether the platform and device allows touch interaction.
          * True if the add-in is running on a touch device, such as an iPad; false otherwise.
@@ -2269,7 +2282,7 @@ declare namespace Office {
         ActiveViewChanged,
         /**
          * Occurs when any date or time of the selected appointment or series is changed in Outlook.
-         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
          *
          * To add an event handler for the `AppointmentTimeChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2279,7 +2292,7 @@ declare namespace Office {
          */
         AppointmentTimeChanged,
         /**
-         * Occurs when an attachment is added to or removed from an item. **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * Occurs when an attachment is added to or removed from an item. **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
          *
          * To add an event handler for the `AttachmentsChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2328,7 +2341,7 @@ declare namespace Office {
          */
         DocumentSelectionChanged,
         /**
-         * Occurs when the appointment location is changed in Outlook. **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * Occurs when the appointment location is changed in Outlook. **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
          *
          * To add an event handler for the `EnhancedLocationsChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2342,7 +2355,7 @@ declare namespace Office {
          * {@link https://learn.microsoft.com/javascript/api/outlook/office.notificationmessagedetails#actions | custom action}.
          * Currently, "Dismiss" is the only supported action that fires this event.
          *
-         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
          *
          * To add an event handler for the `InfobarClicked` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2353,7 +2366,7 @@ declare namespace Office {
         InfobarClicked,
         /**
          * Occurs when a different Outlook item is selected for viewing while the task pane is pinned.
-         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
          *
          * To add an event handler for the `ItemChanged` event, use the `addHandlerAsync` method of the `Mailbox` object.
          *
@@ -2373,7 +2386,7 @@ declare namespace Office {
          */
         NodeReplaced,
         /**
-         * Occurs when the OfficeTheme is changed in Outlook. **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * Occurs when the OfficeTheme is changed in Outlook. **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
          *
          * To add an event handler for the `OfficeThemeChanged` event, use the `addHandlerAsync` method of the `Mailbox` object.
          * The event handler receives an argument of type
@@ -2386,7 +2399,7 @@ declare namespace Office {
         OfficeThemeChanged,
         /**
          * Occurs when the recipient list of the selected item or the appointment location is changed in Outlook.
-         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
          *
          * To add an event handler for the `RecipientsChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2397,7 +2410,7 @@ declare namespace Office {
         RecipientsChanged,
         /**
          * Occurs when the recurrence pattern of the selected series is changed in Outlook.
-         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
          *
          * To add an event handler for the `RecurrenceChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2412,13 +2425,26 @@ declare namespace Office {
         ResourceSelectionChanged,
         /**
          * Occurs in Outlook when one or more messages are selected or deselected.
-         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
          * 
          * To add an event handler for the `SelectedItemsChanged` event, use the `addHandlerAsync` method of the `Mailbox` object.
          * 
          * [Api set: Mailbox preview]
          */
         SelectedItemsChanged,
+        /**
+         * Occurs in Outlook when the sensitivity label of a message or appointment changes.
+         * **Important**: This event can only be handled in a task pane. It isn't supported by function commands.
+         * 
+         * To add an event handler for the `SensitivityLabelChanged` event, use the `addHandlerAsync` method of the `Item` object.
+         * The event handler receives an argument of type
+         * {@link https://learn.microsoft.com/javascript/api/outlook/office.sensitivitylabelchangedeventargs?view=outlook-js-preview | Office.SensitivityLabelChangedEventArgs}.
+         * 
+         * [Api set: Mailbox preview]
+         * 
+         * @beta
+         */
+        SensitivityLabelChanged,
         /**
          * A Settings.settingsChanged event was raised.
          *
@@ -8380,9 +8406,9 @@ declare namespace Office {
             ShowTaskPane = "showTaskPane"
         }
         /**
-         * Specifies the sensitivity type of an appointment.
+         * Specifies the {@link Office.Sensitivity | sensitivity level} of an appointment.
          *
-         * @remarks 
+         * @remarks
          * [Api set: Mailbox preview]
          *
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose or Read
@@ -9869,7 +9895,9 @@ declare namespace Office {
          */
         requiredAttendees: Recipients;
         /**
-         * Gets or sets the {@link Office.Sensitivity | sensitivity} of an appointment.
+         * Gets or sets the {@link Office.Sensitivity | sensitivity level} of an appointment.
+         * For information about sensitivity levels, see
+         * {@link https://support.microsoft.com/office/4a76d05b-6c29-4a0d-9096-71784a6b12c1 | Mark your email as Normal, Personal, Private, or Confidential}.
          *
          * @remarks
          * [Api set: Mailbox preview]
@@ -9881,6 +9909,19 @@ declare namespace Office {
          * @beta
          */
         sensitivity: Sensitivity;
+        /**
+         * Gets the object to get or set the {@link Office.SensitivityLabel | sensitivity label} of an appointment.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Appointment Organizer
+         * 
+         * @beta
+         */
+        sensitivityLabel: SensitivityLabel;
         /**
          * Gets the ID of the series that an instance belongs to.
          *
@@ -12370,6 +12411,89 @@ declare namespace Office {
          *                             of type `Office.AsyncResult`. Any errors encountered will be provided in the `asyncResult.error` property.
          */
         prependAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
+        /**
+         * Prepends HTML or plain text to the beginning of a message or appointment body when the mail item is sent.
+         * 
+         * To use `prependOnSendAsync`, you must specify a supplementary permission in the manifest. Details vary with the type of manifest. For guidance,
+         * see {@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Understanding Outlook add-in permissions}.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * **Recommended**: Call `getTypeAsync`, then pass its returned value to the `options.coercionType` parameter.
+         * 
+         * **Important**: When implementing `prependOnSendAsync`, keep the following in mind.
+         * 
+         * - In a {@link https://learn.microsoft.com/office/dev/add-ins/outlook/smart-alerts-onmessagesend-walkthrough | Smart Alerts add-in},
+         * the prepend-on-send feature runs first.
+         * 
+         * - A new line is added after the prepended content.
+         * 
+         * - If multiple active add-ins call `prependOnSendAsync`, the order of the inserted content depends on the order in which the add-in runs.
+         * The content of the last run add-in appears above previously prepended content.
+         * 
+         * - If the add-in attempts to insert HTML into a plain text body, the content won't be prepended. Conversely, plain text will be inserted into an HTML body.
+         * 
+         * **Errors**:
+         * 
+         * - `DataExceedsMaximumSize`: The `data` parameter exceeds 5,000 characters.
+         * 
+         * - `InvalidFormatError`: The `options.coercionType` parameter is set to `Office.CoercionType.Html`, but the item body is in plain text format.
+         * 
+         * @param data - The string to be prepended to the beginning of the message or appointment body. The string is limited to 5,000 characters.
+         * @param options - An object literal that contains one or more of the following properties:-
+         *        `asyncContext`: Any object that can be accessed in the callback function.
+         *        `coercionType`: The desired format for the body. The string in the `data` parameter is converted to this format.
+         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                             of type `Office.AsyncResult`. Any errors encountered will be provided in the `asyncResult.error` property.
+         * 
+         * @beta
+         */
+        prependOnSendAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
+        /**
+         * Prepends HTML or plain text to the beginning of a message or appointment body when the mail item is sent.
+         * 
+         * To use `prependOnSendAsync`, you must specify a supplementary permission in the manifest. Details vary with the type of manifest. For guidance,
+         * see {@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Understanding Outlook add-in permissions}.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * **Recommended**: Call `getTypeAsync`, then pass its returned value to the `options.coercionType` parameter.
+         * 
+         * **Important**: When implementing `prependOnSendAsync`, keep the following in mind.
+         * 
+         * - In a {@link https://learn.microsoft.com/office/dev/add-ins/outlook/smart-alerts-onmessagesend-walkthrough | Smart Alerts add-in},
+         * the prepend-on-send feature runs first.
+         * 
+         * - A new line is added after the prepended content.
+         * 
+         * - If multiple active add-ins call `prependOnSendAsync`, the order of the inserted content depends on the order in which the add-in runs.
+         * The content of the last run add-in appears above previously prepended content.
+         * 
+         * - If the add-in attempts to insert HTML into a plain text body, the content won't be prepended. Conversely, plain text will be inserted into an HTML body.
+         * 
+         * **Errors**:
+         * 
+         * - `DataExceedsMaximumSize`: The `data` parameter exceeds 5,000 characters.
+         * 
+         * - `InvalidFormatError`: The `options.coercionType` parameter is set to `Office.CoercionType.Html`, but the item body is in plain text format.
+         * 
+         * @param data - The string to be prepended to the beginning of the message or appointment body. The string is limited to 5,000 characters.
+         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter
+         *                             of type `Office.AsyncResult`. Any errors encountered will be provided in the `asyncResult.error` property.
+         * 
+         * @beta
+         */
+        prependOnSendAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
          * Replaces the entire body with the specified text.
          *
@@ -15110,6 +15234,19 @@ declare namespace Office {
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Compose
          */
         notificationMessages: NotificationMessages;
+        /**
+         * Gets the object to get or set the {@link Office.SensitivityLabel | sensitivity label} of a message.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Message Compose
+         * 
+         * @beta
+         */
+        sensitivityLabel: SensitivityLabel;
         /**
          * Gets the ID of the series that an instance belongs to.
          *
@@ -18333,7 +18470,8 @@ declare namespace Office {
         set(name: string, value: any): void;
     }
     /**
-     * Provides methods to get and set the appointment sensitivity of a meeting in an Outlook add-in.
+     * Provides methods to get and set the sensitivity level of an appointment. To learn more about sensitivity levels, see
+     * {@link https://support.microsoft.com/office/4a76d05b-6c29-4a0d-9096-71784a6b12c1 | Mark your email as Normal, Personal, Private, or Confidential}.
      *
      * @remarks
      * [Api set: Mailbox preview]
@@ -18346,7 +18484,7 @@ declare namespace Office {
      */
     interface Sensitivity {
         /**
-         * Gets the value of the appointment sensitivity.
+         * Gets the sensitivity level of an appointment.
          *
          * @remarks
          * [Api set: Mailbox preview]
@@ -18357,17 +18495,17 @@ declare namespace Office {
          *
          * @param options - An object literal that contains one or more of the following properties:-
          *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
-         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter of
-         *                 type `Office.AsyncResult`.
+         * @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. The sensitivity level of the appointment is returned in the `asyncResult.value` property.
          *
          * @beta
          */
         getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<MailboxEnums.AppointmentSensitivityType>) => void): void;
         /**
-         * Gets the value of the appointment sensitivity.
+         * Gets the sensitivity level of an appointment.
          *
-         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter of
-         *                 type `Office.AsyncResult`.
+         * @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. The sensitivity level of the appointment is returned in the `asyncResult.value` property.
          *
          * @remarks
          * [Api set: Mailbox preview]
@@ -18380,7 +18518,7 @@ declare namespace Office {
          */
         getAsync(callback: (asyncResult: Office.AsyncResult<MailboxEnums.AppointmentSensitivityType>) => void): void;
         /**
-         * Sets the value of the appointment sensitivity.
+         * Sets the sensitivity level of an appointment.
          *
          * @remarks
          * [Api set: Mailbox preview]
@@ -18389,7 +18527,7 @@ declare namespace Office {
          *
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
          *
-         * @param sensitivity - The sensitivity value as enum or string.
+         * @param sensitivity - The sensitivity level as an enum or string.
          * @param options - An object literal that contains one or more of the following properties:-
          *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
@@ -18399,7 +18537,7 @@ declare namespace Office {
          */
         setAsync(sensitivity: MailboxEnums.AppointmentSensitivityType | string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
         /**
-         * Sets the value of the appointment sensitivity.
+         * Sets the sensitivity level of an appointment.
          *
          * @remarks
          * [Api set: Mailbox preview]
@@ -18408,7 +18546,7 @@ declare namespace Office {
          *
          * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
          *
-         * @param sensitivity - The sensitivity value as enum or string.
+         * @param sensitivity - The sensitivity level as an enum or string.
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
          *                `asyncResult`, which is an `Office.AsyncResult` object.
          *
@@ -18416,6 +18554,259 @@ declare namespace Office {
          */
         setAsync(sensitivity: MailboxEnums.AppointmentSensitivityType | string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
     }
+    /**
+     * Provides methods to get or set the sensitivity label of a message or appointment. For more information on sensitivity labels, see
+     * {@link https://learn.microsoft.com/microsoft-365/compliance/sensitivity-labels | Learn about sensitivity labels}.
+     * 
+     * @remarks
+     * [Api set: Mailbox preview]
+     * 
+     * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+     *
+     * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+     * 
+     * @beta
+     */
+    interface SensitivityLabel {
+        /**
+         * Gets the unique identifier (GUID) of the sensitivity label applied to a message or appointment being composed.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * @param options - An object literal that contains one or more of the following properties:-
+         *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
+         * @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. The sensitivity label's GUID is returned in the
+         *                 `asyncResult.value` property.
+         * 
+         * @beta
+         */
+        getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;
+        /**
+         * Gets the unique identifier (GUID) of the sensitivity label applied to a message or appointment being composed.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * @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. The sensitivity label's GUID is returned in the
+         *                 `asyncResult.value` property.
+         * 
+         * @beta
+         */
+        getAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
+        /**
+         * Applies the specified sensitivity label to the message or appointment being composed.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * **Tip**: To determine the sensitivity labels available for use, call the `Office.context.sensitivityLabelsCatalog.getAsync` method.
+         * 
+         * @param sensitivityLabel - The sensitivity label to be applied to the message or appointment being composed. The parameter value can be a sensitivity label's
+         *                         unique identifier (GUID) or a {@link Office.SensitivityLabelDetails | SensitivityLabelDetails} object.
+         * @param options - An object literal that contains one or more of the following properties:-
+         *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
+         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
+         *                 which is an `Office.AsyncResult` object.
+         * 
+         * @beta
+         */
+        setAsync(sensitivityLabel: string | SensitivityLabelDetails, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
+        /**
+         * Applies the specified sensitivity label to the message or appointment being composed.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * **Tip**: To determine the sensitivity labels available for use, call the `Office.context.sensitivityLabelsCatalog.getAsync` method.
+         * 
+         * @param sensitivityLabel - The sensitivity label to be applied to the message or appointment being composed. The parameter value can be a sensitivity label's
+         *                         unique identifier (GUID) or a {@link Office.SensitivityLabelDetails | SensitivityLabelDetails} object.
+         * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
+         *                 which is an `Office.AsyncResult` object.
+         * 
+         * @beta
+         */
+        setAsync(sensitivityLabel: string | SensitivityLabelDetails, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
+    }
+    /**
+     * Provides methods to check the status of the catalog of {@link https://learn.microsoft.com/microsoft-365/compliance/sensitivity-labels | sensitivity labels}
+     * in Outlook and retrieve all available sensitivity labels if the catalog is enabled.
+     * 
+     * @remarks
+     * [Api set: Mailbox preview]
+     * 
+     * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+     *
+     * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+     * 
+     * @beta
+     */
+    export interface SensitivityLabelsCatalog {
+        /**
+         * Gets all the sensitivity labels that are enabled in Outlook.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * **Recommended**: To determine whether the catalog of sensitivity labels is enabled in Outlook, call `getIsEnabledAsync` before using `getAsync`.
+         * 
+         * @param options - An object literal that contains one or more of the following properties:-
+         *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
+         * @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. The available sensitivity labels and their properties are returned in the
+         *                 `asyncResult.value` property.
+         *  
+         * @beta
+         */
+        getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => void): void;
+        /**
+         * Gets all the sensitivity labels that are enabled in Outlook.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * **Recommended**: To determine whether the catalog of sensitivity labels is enabled in Outlook, call `getIsEnabledAsync` before using `getAsync`.
+         * 
+         * @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. The available sensitivity labels and their properties are returned in the
+         *                 `asyncResult.value` property.
+         *  
+         * @beta
+         */
+        getAsync(callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => void): void;
+        /**
+         * Checks whether the catalog of sensitivity labels is enabled in Outlook.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * **Important**: The catalog of sensitivity labels is configured by an organization's administrator. For more information, see
+         * {@link https://learn.microsoft.com/microsoft-365/compliance/get-started-with-sensitivity-labels | Get started with sensitivity labels}.
+         * 
+         * @param options - An object literal that contains one or more of the following properties:-
+         *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
+         * @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. The status of the catalog of sensitivity labels is returned in the `asyncResult.value` property.
+         * 
+         * @beta
+         */
+        getIsEnabledAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<boolean>) => void): void;
+        /**
+         * Checks whether the catalog of sensitivity labels is enabled in Outlook.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+         * 
+         * **Important**: The catalog of sensitivity labels is configured by an organization's administrator. For more information, see
+         * {@link https://learn.microsoft.com/microsoft-365/compliance/get-started-with-sensitivity-labels | Get started with sensitivity labels}.
+         * 
+         * @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. The status of the catalog of sensitivity labels is returned in the `asyncResult.value` property.
+         * 
+         * @beta
+         */
+        getIsEnabledAsync(callback: (asyncResult: Office.AsyncResult<boolean>) => void): void;
+    }
+    /**
+     * Provides the change status of the sensitivity label applied to a message or appointment in compose mode. This information is provided when the
+     * `Office.EventType.SensitivityLabelChanged` event is raised.
+     * 
+     * @remarks
+     * [Api set: Mailbox preview]
+     * 
+     * @beta
+     */
+    export interface SensitivityLabelChangedEventArgs {
+        /**
+         * The type of event that was raised. For details, refer to {@link https://learn.microsoft.com/javascript/api/office/office.eventtype | Office.EventType}.
+         * 
+         * @remarks
+         * [Api set: Mailbox preview]
+         * 
+         * @beta
+         */
+        type: "olkSensitivityLabelChanged";
+    }
+    /**
+     * Represents the properties of available sensitivity labels in Outlook.
+     * 
+     * @remarks
+     * [Api set: Mailbox preview]
+     * 
+     * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: **read/write item**
+     *
+     * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose
+     * 
+     * @beta
+     */
+    interface SensitivityLabelDetails {
+        /**
+         * The color of the sensitivity label.
+         * 
+         * @beta
+         */
+        color: string;
+        /**
+         * The {@link https://learn.microsoft.com/microsoft-365/compliance/sensitivity-labels#sublabels-grouping-labels | sublabels} of the sensitivity label.
+         * Returns `null` if a label doesn't have any sublabels.
+         * 
+         * @beta
+         */
+        children: SensitivityLabelDetails[];
+        /**
+         * The unique identifier (GUID) of the sensitivity label.
+         * 
+         * @beta
+         */
+        id: string;
+        /**
+         * The name of the sensitivity label.
+         * 
+         * @beta
+         */
+        name: string;
+        /**
+         * The description of the sensitivity label.
+         * 
+         * @beta
+         */
+        tooltip: string;
+    }
     /**
      * The `SeriesTime` object provides methods to get and set the dates and times of appointments in a recurring series and get the dates and times
      * of meeting requests in a recurring series.

office-js-preview/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js-preview",
-    "version": "1.0.366",
+    "version": "1.0.368",
     "description": "TypeScript definitions for Office.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview",
     "license": "MIT",
@@ -45,6 +45,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "8e1d4c4a5ae3561f6b6d31931d05d3c61dff4d27ee7aacf346fb9af396e2fe43",
+    "typesPublisherContentHash": "2a6164b196b7e896b0a2a00b9fabee7af4ef32d0a064d74a9d8e472fd747cfda",
     "typeScriptVersion": "4.2"
 }