Automatically generated docs (#2450)

Co-authored-by: github-actions <[email protected]>

Author: ElizabethSamuel-MSFT

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

@@ -70,6 +70,42 @@ properties:
         type: >-
           <xref uid="outlook!Office.MailboxEnums.AttachmentType:enum" /> |
           string
+  - name: contentId
+    uid: outlook!Office.AttachmentDetails#contentId:member
+    package: outlook!
+    fullName: contentId
+    summary: Gets the content identifier of an inline attachment.
+    remarks: >-
+      **Important**:
+
+
+      - The `contentId` property is only supported in Outlook on the web, the
+      new Outlook on Windows, and classic Outlook on Windows (preview). To
+      preview the `contentId` property in classic Outlook on Windows, your
+      Outlook client must run Version 2510 (Build 19312.20000) or later and must
+      be on the Beta Channel. For more information, see [Microsoft 365 Insider
+      Program](https://aka.ms/Msft365InsiderProgram)<!-- -->.
+
+
+      - Changes to how inline images are represented in the HTML body of Outlook
+      emails in Outlook on the web and the new Outlook on Windows released on
+      November 15, 2025. Previously, the attachment ID of the image appeared in
+      the `src` attribute of the applicable `<img>` element. Now, the image is
+      represented by a content ID (`cid`<!-- -->) in the `src` attribute
+      instead. If you parse the attachment ID from the HTML editor or get the
+      Base64-encoded value of the image from the URL in the `src` attribute, you
+      must update your add-in's parsing logic. For more information, see
+      [Changes to inline image representation in Outlook on the web and new
+      Outlook for
+      Windows](https://devblogs.microsoft.com/microsoft365dev/changes-to-inline-images-in-outlook)<!--
+      -->.
+
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'contentId: string;'
+      return:
+        type: string
   - name: contentType
     uid: outlook!Office.AttachmentDetails#contentType:member
     package: outlook!

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

@@ -129,24 +129,23 @@ properties:
       **Important**:
 
 
-      - The `contentId` property is only supported in Outlook on the web and
-      Outlook on Windows (new and classic (preview)). To preview the `contentId`
-      property in classic Outlook on Windows, your Outlook client must run
-      Version 2510 (Build 19312.20000) or later and must be on the Beta Channel.
-      For more information, see [Microsoft 365 Insider
+      - The `contentId` property is only supported in Outlook on the web, the
+      new Outlook on Windows, and classic Outlook on Windows (preview). To
+      preview the `contentId` property in classic Outlook on Windows, your
+      Outlook client must run Version 2510 (Build 19312.20000) or later and must
+      be on the Beta Channel. For more information, see [Microsoft 365 Insider
       Program](https://aka.ms/Msft365InsiderProgram)<!-- -->.
 
 
-      - Starting November 15, 2025, changes to how inline images are represented
-      in the HTML body of Outlook emails in Outlook on the web and the new
-      Outlook on Windows will begin rolling out to production users. Previously,
-      the attachment ID of the image appeared in the `src` attribute of the
-      applicable `<img>` element. After the change, the image will be
+      - Changes to how inline images are represented in the HTML body of Outlook
+      emails in Outlook on the web and the new Outlook on Windows released on
+      November 15, 2025. Previously, the attachment ID of the image appeared in
+      the `src` attribute of the applicable `<img>` element. Now, the image is
       represented by a content ID (`cid`<!-- -->) in the `src` attribute
-      instead. As a result, you'll need to update your add-in's parsing logic if
-      you parse the attachment ID from the HTML editor or get the Base64 value
-      of the image from the URL in the `src` attribute. For more information,
-      see [Changes to inline image representation in Outlook on the web and new
+      instead. If you parse the attachment ID from the HTML editor or get the
+      Base64-encoded value of the image from the URL in the `src` attribute, you
+      must update your add-in's parsing logic. For more information, see
+      [Changes to inline image representation in Outlook on the web and new
       Outlook for
       Windows](https://devblogs.microsoft.com/microsoft365dev/changes-to-inline-images-in-outlook)<!--
       -->.

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

@@ -34,6 +34,7 @@ remarks: >-
 
       const eventData = event.dragAndDropEventData;
       console.log(`x-coordinate: ${eventData.pageX}, y-coordinate: ${eventData.pageY}`);
+      console.log(`x-coordinate relative to task pane: ${eventData.taskPaneX}, y-coordinate relative to task pane: ${eventData.taskPaneY}`);
 
       if (eventData.type == "drop") {
         console.log("Items dropped into task pane.");

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

@@ -33,6 +33,7 @@ remarks: >-
 
       const eventData = event.dragAndDropEventData;
       console.log(`x-coordinate: ${eventData.pageX}, y-coordinate: ${eventData.pageY}`);
+      console.log(`x-coordinate relative to task pane: ${eventData.taskPaneX}, y-coordinate relative to task pane: ${eventData.taskPaneY}`);
 
       if (eventData.type == "drop") {
         console.log("Items dropped into task pane.");
@@ -93,6 +94,44 @@ properties:
       content: 'pageY: number;'
       return:
         type: number
+  - name: taskPaneX
+    uid: outlook!Office.DragoverEventData#taskPaneX:member
+    package: outlook!
+    fullName: taskPaneX
+    summary: >-
+      Gets the x-coordinate of the mouse pointer that represents the horizontal
+      position in pixels. The position is relative to the left edge of the
+      add-in's task pane.
+    remarks: >-
+      \[ [API set: Mailbox
+      1.5](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets)
+      \]
+
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'taskPaneX: number;'
+      return:
+        type: number
+  - name: taskPaneY
+    uid: outlook!Office.DragoverEventData#taskPaneY:member
+    package: outlook!
+    fullName: taskPaneY
+    summary: >-
+      Gets the y-coordinate of the mouse pointer that represents the vertical
+      position in pixels. The position is relative to the top edge of the
+      add-in's task pane.
+    remarks: >-
+      \[ [API set: Mailbox
+      1.5](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets)
+      \]
+
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'taskPaneY: number;'
+      return:
+        type: number
   - name: type
     uid: outlook!Office.DragoverEventData#type:member
     package: outlook!

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

@@ -33,6 +33,7 @@ remarks: >-
 
       const eventData = event.dragAndDropEventData;
       console.log(`x-coordinate: ${eventData.pageX}, y-coordinate: ${eventData.pageY}`);
+      console.log(`x-coordinate relative to task pane: ${eventData.taskPaneX}, y-coordinate relative to task pane: ${eventData.taskPaneY}`);
 
       if (eventData.type == "drop") {
         console.log("Items dropped into task pane.");
@@ -111,6 +112,44 @@ properties:
       content: 'pageY: number;'
       return:
         type: number
+  - name: taskPaneX
+    uid: outlook!Office.DropEventData#taskPaneX:member
+    package: outlook!
+    fullName: taskPaneX
+    summary: >-
+      Gets the x-coordinate of the mouse pointer that represents the horizontal
+      position in pixels. The position is relative to the left edge of the
+      add-in's task pane.
+    remarks: >-
+      \[ [API set: Mailbox
+      1.5](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets)
+      \]
+
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'taskPaneX: number;'
+      return:
+        type: number
+  - name: taskPaneY
+    uid: outlook!Office.DropEventData#taskPaneY:member
+    package: outlook!
+    fullName: taskPaneY
+    summary: >-
+      Gets the y-coordinate of the mouse pointer that represents the vertical
+      position in pixels. The position is relative to the top edge of the
+      add-in's task pane.
+    remarks: >-
+      \[ [API set: Mailbox
+      1.5](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets)
+      \]
+
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'taskPaneY: number;'
+      return:
+        type: number
   - name: type
     uid: outlook!Office.DropEventData#type:member
     package: outlook!

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

@@ -33,6 +33,7 @@ remarks: >-
 
       const eventData = event.dragAndDropEventData;
       console.log(`x-coordinate: ${eventData.pageX}, y-coordinate: ${eventData.pageY}`);
+      console.log(`x-coordinate relative to task pane: ${eventData.taskPaneX}, y-coordinate relative to task pane: ${eventData.taskPaneY}`);
 
       if (eventData.type == "drop") {
         console.log("Items dropped into task pane.");

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

@@ -33,6 +33,7 @@ remarks: >-
 
       const eventData = event.dragAndDropEventData;
       console.log(`x-coordinate: ${eventData.pageX}, y-coordinate: ${eventData.pageY}`);
+      console.log(`x-coordinate relative to task pane: ${eventData.taskPaneX}, y-coordinate relative to task pane: ${eventData.taskPaneY}`);
 
       if (eventData.type == "drop") {
         console.log("Items dropped into task pane.");

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

@@ -348,9 +348,13 @@ properties:
 
 
       - The `from` and `sender` properties represent the same person unless the
-      message is sent by a delegate. In that case, the `from` property
-      represents the delegator, and the `sender` property represents the
-      delegate.
+      message is sent by a delegate with **Send on behalf** permissions. In
+      this case, the `from` property returns the delegator's email address and
+      the `sender` property returns the delegate's address. For information
+      about mailbox delegation, see [Manage permissions for recipients in
+      Exchange
+      Online](https://learn.microsoft.com/exchange/recipients-in-exchange-online/manage-permissions-for-recipients)<!--
+      -->.
 
 
       - The `recipientType` property of the `EmailAddressDetails` object in the
@@ -671,9 +675,13 @@ properties:
 
 
       - The `from` and `sender` properties represent the same person unless the
-      message is sent by a delegate. In that case, the `from` property
-      represents the delegator, and the `sender` property represents the
-      delegate.
+      message is sent by a delegate with **Send on behalf** permissions. In
+      this case, the `from` property returns the delegator's email address and
+      the `sender` property returns the delegate's address. For information
+      about mailbox delegation, see [Manage permissions for recipients in
+      Exchange
+      Online](https://learn.microsoft.com/exchange/recipients-in-exchange-online/manage-permissions-for-recipients)<!--
+      -->.
 
 
       - The `recipientType` property of the `EmailAddressDetails` object in the

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

@@ -606,20 +606,9 @@ properties:
     uid: outlook!Office.MessageRead#from:member
     package: outlook!
     fullName: from
-    summary: >-
+    summary: |-
       Gets the email address of the sender of a message.
 
-
-      The `from` and `sender` properties represent the same person unless the
-      message is sent by a delegate. In that case, the `from` property
-      represents the delegator, and the `sender` property represents the
-      delegate.
-
-
-      **Note**: The `recipientType` property of the `EmailAddressDetails`
-      object in the `from` property is undefined.
-
-
       The `from` property returns an `EmailAddressDetails` object.
     remarks: >-
       **[Minimum permission
@@ -632,6 +621,23 @@ properties:
       -->**: Message Read
 
 
+      **Important**:
+
+
+      - The `from` and `sender` properties represent the same person unless the
+      message is sent by a delegate with **Send on behalf** permissions. In
+      this case, the `from` property returns the delegator's email address and
+      the `sender` property returns the delegate's address. For information
+      about mailbox delegation, see [Manage permissions for recipients in
+      Exchange
+      Online](https://learn.microsoft.com/exchange/recipients-in-exchange-online/manage-permissions-for-recipients)<!--
+      -->.
+
+
+      - The `recipientType` property of the `EmailAddressDetails` object in the
+      `from` property is undefined.
+
+
       #### Examples
 
 
@@ -1203,18 +1209,7 @@ properties:
     uid: outlook!Office.MessageRead#sender:member
     package: outlook!
     fullName: sender
-    summary: >-
-      Gets the email address of the sender of an email message.
-
-
-      The `from` and `sender` properties represent the same person unless the
-      message is sent by a delegate. In that case, the `from` property
-      represents the delegator, and the `sender` property represents the
-      delegate.
-
-
-      **Note**: The `recipientType` property of the `EmailAddressDetails`
-      object in the `sender` property is undefined.
+    summary: Gets the email address of the sender of an email message.
     remarks: >-
       **[Minimum permission
       level](https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions)<!--
@@ -1226,6 +1221,23 @@ properties:
       -->**: Message Read
 
 
+      **Important**:
+
+
+      - The `from` and `sender` properties represent the same person unless the
+      message is sent by a delegate with **Send on behalf** permissions. In
+      this case, the `from` property returns the delegator's email address and
+      the `sender` property returns the delegate's address. For information
+      about mailbox delegation, see [Manage permissions for recipients in
+      Exchange
+      Online](https://learn.microsoft.com/exchange/recipients-in-exchange-online/manage-permissions-for-recipients)<!--
+      -->.
+
+
+      - The `recipientType` property of the `EmailAddressDetails` object in the
+      `sender` property is undefined.
+
+
       #### Examples
 
 

docs/docs-ref-autogen/outlook_1_1/outlook/office.attachmentdetails.yml

@@ -70,6 +70,42 @@ properties:
         type: >-
           <xref uid="outlook!Office.MailboxEnums.AttachmentType:enum" /> |
           string
+  - name: contentId
+    uid: outlook!Office.AttachmentDetails#contentId:member
+    package: outlook!
+    fullName: contentId
+    summary: Gets the content identifier of an inline attachment.
+    remarks: >-
+      **Important**:
+
+
+      - The `contentId` property is only supported in Outlook on the web, the
+      new Outlook on Windows, and classic Outlook on Windows (preview). To
+      preview the `contentId` property in classic Outlook on Windows, your
+      Outlook client must run Version 2510 (Build 19312.20000) or later and must
+      be on the Beta Channel. For more information, see [Microsoft 365 Insider
+      Program](https://aka.ms/Msft365InsiderProgram)<!-- -->.
+
+
+      - Changes to how inline images are represented in the HTML body of Outlook
+      emails in Outlook on the web and the new Outlook on Windows released on
+      November 15, 2025. Previously, the attachment ID of the image appeared in
+      the `src` attribute of the applicable `<img>` element. Now, the image is
+      represented by a content ID (`cid`<!-- -->) in the `src` attribute
+      instead. If you parse the attachment ID from the HTML editor or get the
+      Base64-encoded value of the image from the URL in the `src` attribute, you
+      must update your add-in's parsing logic. For more information, see
+      [Changes to inline image representation in Outlook on the web and new
+      Outlook for
+      Windows](https://devblogs.microsoft.com/microsoft365dev/changes-to-inline-images-in-outlook)<!--
+      -->.
+
+    isPreview: false
+    isDeprecated: false
+    syntax:
+      content: 'contentId: string;'
+      return:
+        type: string
   - name: contentType
     uid: outlook!Office.AttachmentDetails#contentType:member
     package: outlook!