Skip to content

Commit

Permalink
[Outlook] (internet headers) Document support in Outlook on mobile de…
Browse files Browse the repository at this point in the history
…vices (#4534)

* Add mobile support

* Apply suggestions from code review

Co-authored-by: Elizabeth Samuel <elizs@microsoft.com>

---------

Co-authored-by: Elizabeth Samuel <elizs@microsoft.com>
  • Loading branch information
samantharamon and ElizabethSamuel-MSFT committed Apr 30, 2024
1 parent 00f23cb commit 70aa88b
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 3 deletions.
10 changes: 8 additions & 2 deletions docs/outlook/internet-headers.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Get and set internet headers
description: How to get and set internet headers on a message in an Outlook add-in.
ms.date: 07/10/2022
ms.date: 04/30/2024
ms.topic: how-to
ms.localizationpriority: medium
---
Expand All @@ -24,14 +24,20 @@ While there's a way for you to set the internet headers through Exchange Web Ser
## Purpose of the internet headers API

Introduced in [requirement set 1.8](/javascript/api/requirement-sets/outlook/requirement-set-1.8/outlook-requirement-set-1.8), the internet headers APIs enable developers to:
Introduced in [Mailbox requirement set 1.8](/javascript/api/requirement-sets/outlook/requirement-set-1.8/outlook-requirement-set-1.8), the internet headers APIs enable developers to:

- Stamp information on an email that persists after it leaves Exchange across all clients.
- Read information on an email that persisted after the email left Exchange across all clients in mail read scenarios.
- Access the entire MIME header of the email.

![Diagram of internet headers. Text: User 1 sends email. Add-in manages custom internet headers while user is composing email. User 2 receives the email. Add-in gets internet headers from received email then parses and uses custom headers.](../images/outlook-internet-headers.png)

## Supported clients

To use the internet headers API in your add-in, your Outlook client must support requirement set 1.8 or later. For information on supported clients, see [Outlook client support](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#outlook-client-support).

The internet headers API is also supported in Outlook on Android and on iOS starting in Version 4.2405.0. To learn more about features supported in Outlook on mobile devices, see [Outlook JavaScript APIs supported in Outlook on mobile devices](outlook-mobile-apis.md).

## Set internet headers while composing a message

Use the [item.internetHeaders](/javascript/api/outlook/office.messagecompose#outlook-office-messagecompose-internetheaders-member) property to manage the custom internet headers you place on the current message in Compose mode.
Expand Down
5 changes: 4 additions & 1 deletion docs/outlook/outlook-mobile-apis.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Outlook JavaScript APIs supported in Outlook on mobile devices
description: Learn which Outlook JavaScript APIs are supported in Outlook on mobile devices.
ms.date: 02/06/2024
ms.date: 04/30/2024
ms.localizationpriority: medium
---

Expand All @@ -20,6 +20,9 @@ The following table lists a subset of APIs from requirement sets beyond 1.5 that
|[Office.context.mailbox.item.disableClientSignatureAsync](/javascript/api/outlook/office.messagecompose#outlook-office-messagecompose-disableclientsignatureasync-member(1))|Mailbox 1.10|Message Compose|<ul><li>Android (Version 4.2352.0 or later)</li><li>iOS (Version 4.2352.0 or later)</li></ul>|
|[Office.context.mailbox.item.from.getAsync](/javascript/api/outlook/office.from#outlook-office-from-getasync-member(1))|Mailbox 1.7|Message Compose|<ul><li>Android (Version 4.2352.0 or later)</li><li>iOS (Version 4.2352.0 or later)</li></ul>|
|[Office.context.mailbox.item.getComposeTypeAsync](/javascript/api/outlook/office.messagecompose#outlook-office-messagecompose-getcomposetypeasync-member(1))|Mailbox 1.10|Message Compose|<ul><li>Android (Version 4.2352.0 or later)</li><li>iOS (Version 4.2352.0 or later)</li></ul>|
|[Office.context.mailbox.item.internetHeaders.getAsync](/javascript/api/outlook/office.internetheaders#outlook-office-internetheaders-getasync-member(1))|Mailbox 1.8|Message Compose|<ul><li>Android (Version 4.2405.0 or later)</li><li>iOS (Version 4.2405.0 or later)</li></ul>|
|[Office.context.mailbox.item.internetHeaders.removeAsync](/javascript/api/outlook/office.internetheaders#outlook-office-internetheaders-removeasync-member(1))|Mailbox 1.8|Message Compose|<ul><li>Android (Version 4.2405.0 or later)</li><li>iOS (Version 4.2405.0 or later)</li></ul>|
|[Office.context.mailbox.item.internetHeaders.setAsync](/javascript/api/outlook/office.internetheaders#outlook-office-internetheaders-setasync-member(1))|Mailbox 1.8|Message Compose|<ul><li>Android (Version 4.2405.0 or later)</li><li>iOS (Version 4.2405.0 or later)</li></ul>|

## Unsupported APIs

Expand Down

0 comments on commit 70aa88b

Please sign in to comment.