Merge branch 'main' into live

Author: github-actions

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

@@ -2245,16 +2245,7 @@ methods:
     uid: 'outlook!Office.AppointmentCompose#getAttachmentContentAsync:member(1)'
     package: outlook!
     fullName: 'getAttachmentContentAsync(attachmentId, options, callback)'
-    summary: >-
-      Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
-
-
-      The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best
-      practice, you should get the attachment's identifier from a `getAttachmentsAsync` call, then in the same session,
-      use that identifier to retrieve the attachment. In Outlook on the web, on mobile devices, and in [new Outlook on
-      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->, 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 then subsequently pops out the form to continue in a separate window.
+    summary: Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
     remarks: >-
       \[ [API set: Mailbox 1.8](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -2269,6 +2260,24 @@ methods:
       -->**: Appointment Organizer
 
 
+      **Important**:
+
+
+      - The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a
+      best practice, you should get the attachment's identifier from a `getAttachmentsAsync` call, then in the same
+      session, use that identifier to retrieve the attachment.
+
+
+      - In Outlook on the web and the [new Outlook on
+      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->,
+      `getAttachmentContentAsync` doesn't support attachments that were added using the **Upload and share** option.
+
+
+      - In Outlook on the web, on mobile devices, and in the new Outlook on Windows, 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 then subsequently pops out the form to continue in a separate window.
+
+
       **Errors**:
 
 
@@ -2346,16 +2355,7 @@ methods:
     uid: 'outlook!Office.AppointmentCompose#getAttachmentContentAsync:member(2)'
     package: outlook!
     fullName: 'getAttachmentContentAsync(attachmentId, callback)'
-    summary: >-
-      Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
-
-
-      The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best
-      practice, you should get the attachment's identifier from a `getAttachmentsAsync` call, then in the same session,
-      use that identifier to retrieve the attachment. In Outlook on the web, on mobile devices, and in [new Outlook on
-      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->, 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 then subsequently pops out the form to continue in a separate window.
+    summary: Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
     remarks: >-
       \[ [API set: Mailbox 1.8](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -2370,6 +2370,24 @@ methods:
       -->**: Appointment Organizer
 
 
+      **Important**:
+
+
+      - The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a
+      best practice, you should get the attachment's identifier from a `getAttachmentsAsync` call, then in the same
+      session, use that identifier to retrieve the attachment.
+
+
+      - In Outlook on the web and the [new Outlook on
+      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->,
+      `getAttachmentContentAsync` doesn't support attachments that were added using the **Upload and share** option.
+
+
+      - In Outlook on the web, on mobile devices, and in the new Outlook on Windows, 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 then subsequently pops out the form to continue in a separate window.
+
+
       **Errors**:
 
 
@@ -2419,6 +2437,11 @@ methods:
       -->**: Appointment Organizer
 
 
+      **Important**: In Outlook on the web and the new Outlook on Windows, users can select the **Upload and
+      share** option to upload an attachment to OneDrive and include a link to the file in the mail item. However,
+      since only a link is included, `getAttachmentsAsync` doesn't return this attachment.
+
+
       #### Examples
 
 
@@ -2512,6 +2535,11 @@ methods:
       **[Applicable Outlook
       mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!--
       -->**: Appointment Organizer
+
+
+      **Important**: In Outlook on the web and the new Outlook on Windows, users can select the **Upload and
+      share** option to upload an attachment to OneDrive and include a link to the file in the mail item. However,
+      since only a link is included, `getAttachmentsAsync` doesn't return this attachment.
     isPreview: false
     isDeprecated: false
     syntax:

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

@@ -41,11 +41,17 @@ properties:
       -->**: Appointment Attendee
 
 
-      **Note**: Certain types of files are blocked by Outlook due to potential security issues and are therefore not
-      returned. For more information, see [Blocked attachments in
+      **Important**:
+
+
+      - Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned.
+      For more information, see [Blocked attachments in
       Outlook](https://support.microsoft.com/office/434752e1-02d3-4e90-9124-8b81e49a8519)<!-- -->.
 
 
+      - Attachments added using the **Upload and share** option aren't returned.
+
+
       #### Examples
 
 
@@ -1909,17 +1915,7 @@ methods:
     uid: 'outlook!Office.AppointmentRead#getAttachmentContentAsync:member(1)'
     package: outlook!
     fullName: 'getAttachmentContentAsync(attachmentId, options, callback)'
-    summary: >-
-      Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
-
-
-      The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best
-      practice, you should get the attachment's identifier from an
-      [item.attachments](xref:outlook!Office.AppointmentRead%23attachments:member) call, then in the same session, use
-      that identifier to retrieve the attachment. In Outlook on the web, on mobile devices, and in [new Outlook on
-      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->, 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 then subsequently pops out the form to continue in a separate window.
+    summary: Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
     remarks: >-
       \[ [API set: Mailbox 1.8](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -1934,6 +1930,25 @@ methods:
       -->**: Appointment Attendee
 
 
+      **Important**:
+
+
+      - The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a
+      best practice, you should get the attachment's identifier from an
+      [item.attachments](xref:outlook!Office.MessageRead%23attachments:member) call, then in the same session, use that
+      identifier to retrieve the attachment.
+
+
+      - In Outlook on the web and the [new Outlook on
+      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->,
+      `getAttachmentContentAsync` doesn't support attachments that were added using the **Upload and share** option.
+
+
+      - In Outlook on the web, on mobile devices, and in the new Outlook on Windows, 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 then subsequently pops out the form to continue in a separate window.
+
+
       **Errors**:
 
 
@@ -2002,17 +2017,7 @@ methods:
     uid: 'outlook!Office.AppointmentRead#getAttachmentContentAsync:member(2)'
     package: outlook!
     fullName: 'getAttachmentContentAsync(attachmentId, callback)'
-    summary: >-
-      Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
-
-
-      The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best
-      practice, you should get the attachment's identifier from an
-      [item.attachments](xref:outlook!Office.AppointmentRead%23attachments:member) call, then in the same session, use
-      that identifier to retrieve the attachment. In Outlook on the web, on mobile devices, and in [new Outlook on
-      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->, 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 then subsequently pops out the form to continue in a separate window.
+    summary: Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
     remarks: >-
       \[ [API set: Mailbox 1.8](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -2027,6 +2032,25 @@ methods:
       -->**: Appointment Attendee
 
 
+      **Important**:
+
+
+      - The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a
+      best practice, you should get the attachment's identifier from an
+      [item.attachments](xref:outlook!Office.MessageRead%23attachments:member) call, then in the same session, use that
+      identifier to retrieve the attachment.
+
+
+      - In Outlook on the web and the [new Outlook on
+      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->,
+      `getAttachmentContentAsync` doesn't support attachments that were added using the **Upload and share** option.
+
+
+      - In Outlook on the web, on mobile devices, and in the new Outlook on Windows, 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 then subsequently pops out the form to continue in a separate window.
+
+
       **Errors**:
 
 

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

@@ -520,16 +520,7 @@ methods:
     uid: 'outlook!Office.LoadedMessageCompose#getAttachmentContentAsync:member(1)'
     package: outlook!
     fullName: 'getAttachmentContentAsync(attachmentId, options, callback)'
-    summary: >-
-      Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
-
-
-      The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best
-      practice, you should get the attachment's identifier from a `getAttachmentsAsync` call, then in the same session,
-      use that identifier to retrieve the attachment. In Outlook on the web and [new Outlook on
-      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->, 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 then subsequently pops out the form to continue in a separate window.
+    summary: Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
     remarks: >-
       \[ [API set: Mailbox 1.8](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -544,6 +535,24 @@ methods:
       -->**: Message Compose
 
 
+      **Important**:
+
+
+      - The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a
+      best practice, you should get the attachment's identifier from a `getAttachmentsAsync` call, then in the same
+      session, use that identifier to retrieve the attachment.
+
+
+      - In Outlook on the web and the [new Outlook on
+      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->,
+      `getAttachmentContentAsync` doesn't support attachments that were added using the **Upload and share** option.
+
+
+      - In Outlook on the web, on mobile devices, and in the new Outlook on Windows, 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 then subsequently pops out the form to continue in a separate window.
+
+
       **Errors**:
 
 
@@ -583,16 +592,7 @@ methods:
     uid: 'outlook!Office.LoadedMessageCompose#getAttachmentContentAsync:member(2)'
     package: outlook!
     fullName: 'getAttachmentContentAsync(attachmentId, callback)'
-    summary: >-
-      Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
-
-
-      The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a best
-      practice, you should get the attachment's identifier from a `getAttachmentsAsync` call, then in the same session,
-      use that identifier to retrieve the attachment. In Outlook on the web and [new Outlook on
-      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->, 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 then subsequently pops out the form to continue in a separate window.
+    summary: Gets an attachment from a message or appointment and returns it as an `AttachmentContent` object.
     remarks: >-
       \[ [API set: Mailbox 1.8](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -607,6 +607,24 @@ methods:
       -->**: Message Compose
 
 
+      **Important**:
+
+
+      - The `getAttachmentContentAsync` method gets the attachment with the specified identifier from the item. As a
+      best practice, you should get the attachment's identifier from a `getAttachmentsAsync` call, then in the same
+      session, use that identifier to retrieve the attachment.
+
+
+      - In Outlook on the web and the [new Outlook on
+      Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)<!-- -->,
+      `getAttachmentContentAsync` doesn't support attachments that were added using the **Upload and share** option.
+
+
+      - In Outlook on the web, on mobile devices, and in the new Outlook on Windows, 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 then subsequently pops out the form to continue in a separate window.
+
+
       **Errors**:
 
 
@@ -654,6 +672,11 @@ methods:
       **[Applicable Outlook
       mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!--
       -->**: Message Compose
+
+
+      **Important**: In Outlook on the web and the new Outlook on Windows, users can select the **Upload and
+      share** option to upload an attachment to OneDrive and include a link to the file in the mail item. However,
+      since only a link is included, `getAttachmentsAsync` doesn't return this attachment.
     isPreview: true
     isDeprecated: false
     syntax:
@@ -694,6 +717,11 @@ methods:
       **[Applicable Outlook
       mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!--
       -->**: Message Compose
+
+
+      **Important**: In Outlook on the web and the new Outlook on Windows, users can select the **Upload and
+      share** option to upload an attachment to OneDrive and include a link to the file in the mail item. However,
+      since only a link is included, `getAttachmentsAsync` doesn't return this attachment.
     isPreview: true
     isDeprecated: false
     syntax: