[office-js][office-js-preview] (Outlook) Update support for the Recipients API in Outlook on mobile devices (DefinitelyTyped#73235)

samantharamon · web-flow · commit f3c4306d7f3b · 2025-08-07T10:19:05.000-07:00
diff --git a/types/office-js-preview/index.d.ts b/types/office-js-preview/index.d.ts
@@ -22294,9 +22294,8 @@ declare namespace Office {
          * - 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.
          * 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.
          *
-         * - In Outlook on Android and on iOS, the `addAsync` method isn't supported in Message Compose mode. Only the Appointment Organizer mode is
-         * supported. For more information on supported APIs in Outlook mobile, see
-         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         * - In Outlook on Android and on iOS, the `addAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `addAsync` method isn't
+         * supported when a user replies from the the reply field at the bottom of a message.
          *
          * There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
          *
@@ -22333,9 +22332,8 @@ declare namespace Office {
          * - In Outlook on the web, on Windows, and on Mac (classic UI), you can have a maximum of 500 recipients in a target field.
          * 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.
          *
-         * - In Outlook on Android and on iOS, the `addAsync` method isn't supported in Message Compose mode. Only the Appointment Organizer mode is
-         * supported. For more information on supported APIs in Outlook mobile, see
-         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         * - In Outlook on Android and on iOS, the `addAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `addAsync` method isn't
+         * supported when a user replies from the the reply field at the bottom of a message.
          *
          * There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
          *
@@ -22397,6 +22395,8 @@ declare namespace Office {
          * the value of the `recipientType` property for existing recipients isn't updated and will still be based on the domain of the previously selected account.
          * To get the correct recipient types after switching accounts, you must first remove the existing recipients, then add them back to the mail item.
          *
+         * In Outlook on Android and on iOS, only the `getAsync` method is supported when a user replies from the reply field at the bottom of a message.
+         *
          * @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`,
@@ -22446,6 +22446,8 @@ declare namespace Office {
          * the value of the `recipientType` property for existing recipients isn't updated and will still be based on the domain of the previously selected account.
          * To get the correct recipient types after switching accounts, you must first remove the existing recipients, then add them back to the mail item.
          *
+         * In Outlook on Android and on iOS, only the `getAsync` method is supported when a user replies from the reply field at the bottom of a message.
+         *
          * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
          *                 of type `Office.AsyncResult`. The `asyncResult.value` property of the result is an array of
          *                 {@link Office.EmailAddressDetails | EmailAddressDetails} objects.
@@ -22472,9 +22474,8 @@ declare namespace Office {
          * - 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.
          * If you need to add more recipients after setting 100 recipients, you can call `addAsync` repeatedly, but be mindful of the recipient limit of the field.
          *
-         * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
-         * supported. For more information on supported APIs in Outlook mobile, see
-         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         * - In Outlook on Android and on iOS, the `setAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `setAsync` method isn't
+         * supported when a user replies from the the reply field at the bottom of a message.
          *
          * There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
          *
@@ -22515,9 +22516,8 @@ declare namespace Office {
          * - 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.
          * If you need to add more recipients after setting 100 recipients, you can call `addAsync` repeatedly, but be mindful of the recipient limit of the field.
          *
-         * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
-         * supported. For more information on supported APIs in Outlook mobile, see
-         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         * - In Outlook on Android and on iOS, the `setAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `setAsync` method isn't
+         * supported when a user replies from the the reply field at the bottom of a message.
          *
          * There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
          *
diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
@@ -21938,9 +21938,8 @@ declare namespace Office {
          * - 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.
          * 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.
          *
-         * - In Outlook on Android and on iOS, the `addAsync` method isn't supported in Message Compose mode. Only the Appointment Organizer mode is
-         * supported. For more information on supported APIs in Outlook mobile, see
-         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         * - In Outlook on Android and on iOS, the `addAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `addAsync` method isn't
+         * supported when a user replies from the the reply field at the bottom of a message.
          *
          * There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
          *
@@ -21978,9 +21977,8 @@ declare namespace Office {
          * - 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.
          * 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.
          *
-         * - In Outlook on Android and on iOS, the `addAsync` method isn't supported in Message Compose mode. Only the Appointment Organizer mode is
-         * supported. For more information on supported APIs in Outlook mobile, see
-         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         * - In Outlook on Android and on iOS, the `addAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `addAsync` method isn't
+         * supported when a user replies from the the reply field at the bottom of a message.
          *
          * There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
          *
@@ -22042,6 +22040,8 @@ declare namespace Office {
          * the value of the `recipientType` property for existing recipients isn't updated and will still be based on the domain of the previously selected account.
          * To get the correct recipient types after switching accounts, you must first remove the existing recipients, then add them back to the mail item.
          *
+         * In Outlook on Android and on iOS, only the `getAsync` method is supported when a user replies from the reply field at the bottom of a message.
+         *
          * @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`,
@@ -22091,6 +22091,8 @@ declare namespace Office {
          * the value of the `recipientType` property for existing recipients isn't updated and will still be based on the domain of the previously selected account.
          * To get the correct recipient types after switching accounts, you must first remove the existing recipients, then add them back to the mail item.
          *
+         * In Outlook on Android and on iOS, only the `getAsync` method is supported when a user replies from the reply field at the bottom of a message.
+         *
          * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
          *                 of type `Office.AsyncResult`. The `asyncResult.value` property of the result is an array of
          *                 {@link Office.EmailAddressDetails | EmailAddressDetails} objects.
@@ -22117,9 +22119,8 @@ declare namespace Office {
          * - 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.
          * If you need to add more recipients after setting 100 recipients, you can call `addAsync` repeatedly, but be mindful of the recipient limit of the field.
          *
-         * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
-         * supported. For more information on supported APIs in Outlook mobile, see
-         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         * - In Outlook on Android and on iOS, the `setAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `setAsync` method isn't
+         * supported when a user replies from the the reply field at the bottom of a message.
          *
          * There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
          *
@@ -22160,9 +22161,8 @@ declare namespace Office {
          * - 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.
          * If you need to add more recipients after setting 100 recipients, you can call `addAsync` repeatedly, but be mindful of the recipient limit of the field.
          *
-         * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
-         * supported. For more information on supported APIs in Outlook mobile, see
-         * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis | Outlook JavaScript APIs supported in Outlook on mobile devices}.
+         * - In Outlook on Android and on iOS, the `setAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `setAsync` method isn't
+         * supported when a user replies from the the reply field at the bottom of a message.
          *
          * There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
          *

Original file line number	Diff line number	Diff line change
`@@ -22294,9 +22294,8 @@ declare namespace Office {`
`22294`	`22294`	`* - 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.`
`22295`	`22295`	* 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.
`22296`	`22296`	`*`
`22297`		- * - In Outlook on Android and on iOS, the `addAsync` method isn't supported in Message Compose mode. Only the Appointment Organizer mode is
`22298`		`- * supported. For more information on supported APIs in Outlook mobile, see`
`22299`		`- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis \| Outlook JavaScript APIs supported in Outlook on mobile devices}.`
	`22297`	+ * - In Outlook on Android and on iOS, the `addAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `addAsync` method isn't
	`22298`	`+ * supported when a user replies from the the reply field at the bottom of a message.`
`22300`	`22299`	`*`
`22301`	`22300`	* There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
`22302`	`22301`	`*`
`@@ -22333,9 +22332,8 @@ declare namespace Office {`
`22333`	`22332`	`* - In Outlook on the web, on Windows, and on Mac (classic UI), you can have a maximum of 500 recipients in a target field.`
`22334`	`22333`	* 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.
`22335`	`22334`	`*`
`22336`		- * - In Outlook on Android and on iOS, the `addAsync` method isn't supported in Message Compose mode. Only the Appointment Organizer mode is
`22337`		`- * supported. For more information on supported APIs in Outlook mobile, see`
`22338`		`- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis \| Outlook JavaScript APIs supported in Outlook on mobile devices}.`
	`22335`	+ * - In Outlook on Android and on iOS, the `addAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `addAsync` method isn't
	`22336`	`+ * supported when a user replies from the the reply field at the bottom of a message.`
`22339`	`22337`	`*`
`22340`	`22338`	* There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
`22341`	`22339`	`*`
`@@ -22397,6 +22395,8 @@ declare namespace Office {`
`22397`	`22395`	* the value of the `recipientType` property for existing recipients isn't updated and will still be based on the domain of the previously selected account.
`22398`	`22396`	`* To get the correct recipient types after switching accounts, you must first remove the existing recipients, then add them back to the mail item.`
`22399`	`22397`	`*`
	`22398`	+ * In Outlook on Android and on iOS, only the `getAsync` method is supported when a user replies from the reply field at the bottom of a message.
	`22399`	`+ *`
`22400`	`22400`	`* @param options - An object literal that contains one or more of the following properties:-`
`22401`	`22401`	* `asyncContext`: Developers can provide any object they wish to access in the callback function.
`22402`	`22402`	* @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
`@@ -22446,6 +22446,8 @@ declare namespace Office {`
`22446`	`22446`	* the value of the `recipientType` property for existing recipients isn't updated and will still be based on the domain of the previously selected account.
`22447`	`22447`	`* To get the correct recipient types after switching accounts, you must first remove the existing recipients, then add them back to the mail item.`
`22448`	`22448`	`*`
	`22449`	+ * In Outlook on Android and on iOS, only the `getAsync` method is supported when a user replies from the reply field at the bottom of a message.
	`22450`	`+ *`
`22449`	`22451`	* @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
`22450`	`22452`	* of type `Office.AsyncResult`. The `asyncResult.value` property of the result is an array of
`22451`	`22453`	`* {@link Office.EmailAddressDetails \| EmailAddressDetails} objects.`
`@@ -22472,9 +22474,8 @@ declare namespace Office {`
`22472`	`22474`	`* - 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.`
`22473`	`22475`	* If you need to add more recipients after setting 100 recipients, you can call `addAsync` repeatedly, but be mindful of the recipient limit of the field.
`22474`	`22476`	`*`
`22475`		- * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
`22476`		`- * supported. For more information on supported APIs in Outlook mobile, see`
`22477`		`- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis \| Outlook JavaScript APIs supported in Outlook on mobile devices}.`
	`22477`	+ * - In Outlook on Android and on iOS, the `setAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `setAsync` method isn't
	`22478`	`+ * supported when a user replies from the the reply field at the bottom of a message.`
`22478`	`22479`	`*`
`22479`	`22480`	* There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
`22480`	`22481`	`*`
`@@ -22515,9 +22516,8 @@ declare namespace Office {`
`22515`	`22516`	`* - 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.`
`22516`	`22517`	* If you need to add more recipients after setting 100 recipients, you can call `addAsync` repeatedly, but be mindful of the recipient limit of the field.
`22517`	`22518`	`*`
`22518`		- * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
`22519`		`- * supported. For more information on supported APIs in Outlook mobile, see`
`22520`		`- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis \| Outlook JavaScript APIs supported in Outlook on mobile devices}.`
	`22519`	+ * - In Outlook on Android and on iOS, the `setAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `setAsync` method isn't
	`22520`	`+ * supported when a user replies from the the reply field at the bottom of a message.`
`22521`	`22521`	`*`
`22522`	`22522`	* There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
`22523`	`22523`	`*`
Original file line number	Diff line number	Diff line change
`@@ -21938,9 +21938,8 @@ declare namespace Office {`
`21938`	`21938`	`* - 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.`
`21939`	`21939`	* 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.
`21940`	`21940`	`*`
`21941`		- * - In Outlook on Android and on iOS, the `addAsync` method isn't supported in Message Compose mode. Only the Appointment Organizer mode is
`21942`		`- * supported. For more information on supported APIs in Outlook mobile, see`
`21943`		`- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis \| Outlook JavaScript APIs supported in Outlook on mobile devices}.`
	`21941`	+ * - In Outlook on Android and on iOS, the `addAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `addAsync` method isn't
	`21942`	`+ * supported when a user replies from the the reply field at the bottom of a message.`
`21944`	`21943`	`*`
`21945`	`21944`	* There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
`21946`	`21945`	`*`
`@@ -21978,9 +21977,8 @@ declare namespace Office {`
`21978`	`21977`	`* - 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.`
`21979`	`21978`	* 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.
`21980`	`21979`	`*`
`21981`		- * - In Outlook on Android and on iOS, the `addAsync` method isn't supported in Message Compose mode. Only the Appointment Organizer mode is
`21982`		`- * supported. For more information on supported APIs in Outlook mobile, see`
`21983`		`- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis \| Outlook JavaScript APIs supported in Outlook on mobile devices}.`
	`21980`	+ * - In Outlook on Android and on iOS, the `addAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `addAsync` method isn't
	`21981`	`+ * supported when a user replies from the the reply field at the bottom of a message.`
`21984`	`21982`	`*`
`21985`	`21983`	* There's no recipient limit if you call `addAsync` in Outlook on Mac (new UI).
`21986`	`21984`	`*`
`@@ -22042,6 +22040,8 @@ declare namespace Office {`
`22042`	`22040`	* the value of the `recipientType` property for existing recipients isn't updated and will still be based on the domain of the previously selected account.
`22043`	`22041`	`* To get the correct recipient types after switching accounts, you must first remove the existing recipients, then add them back to the mail item.`
`22044`	`22042`	`*`
	`22043`	+ * In Outlook on Android and on iOS, only the `getAsync` method is supported when a user replies from the reply field at the bottom of a message.
	`22044`	`+ *`
`22045`	`22045`	`* @param options - An object literal that contains one or more of the following properties:-`
`22046`	`22046`	* `asyncContext`: Developers can provide any object they wish to access in the callback function.
`22047`	`22047`	* @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
`@@ -22091,6 +22091,8 @@ declare namespace Office {`
`22091`	`22091`	* the value of the `recipientType` property for existing recipients isn't updated and will still be based on the domain of the previously selected account.
`22092`	`22092`	`* To get the correct recipient types after switching accounts, you must first remove the existing recipients, then add them back to the mail item.`
`22093`	`22093`	`*`
	`22094`	+ * In Outlook on Android and on iOS, only the `getAsync` method is supported when a user replies from the reply field at the bottom of a message.
	`22095`	`+ *`
`22094`	`22096`	* @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`,
`22095`	`22097`	* of type `Office.AsyncResult`. The `asyncResult.value` property of the result is an array of
`22096`	`22098`	`* {@link Office.EmailAddressDetails \| EmailAddressDetails} objects.`
`@@ -22117,9 +22119,8 @@ declare namespace Office {`
`22117`	`22119`	`* - 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.`
`22118`	`22120`	* If you need to add more recipients after setting 100 recipients, you can call `addAsync` repeatedly, but be mindful of the recipient limit of the field.
`22119`	`22121`	`*`
`22120`		- * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
`22121`		`- * supported. For more information on supported APIs in Outlook mobile, see`
`22122`		`- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis \| Outlook JavaScript APIs supported in Outlook on mobile devices}.`
	`22122`	+ * - In Outlook on Android and on iOS, the `setAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `setAsync` method isn't
	`22123`	`+ * supported when a user replies from the the reply field at the bottom of a message.`
`22123`	`22124`	`*`
`22124`	`22125`	* There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
`22125`	`22126`	`*`
`@@ -22160,9 +22161,8 @@ declare namespace Office {`
`22160`	`22161`	`* - 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.`
`22161`	`22162`	* If you need to add more recipients after setting 100 recipients, you can call `addAsync` repeatedly, but be mindful of the recipient limit of the field.
`22162`	`22163`	`*`
`22163`		- * - In Outlook on Android and on iOS, the `setAsync` method isn't supported in the Message Compose mode. Only the Appointment Organizer mode is
`22164`		`- * supported. For more information on supported APIs in Outlook mobile, see`
`22165`		`- * {@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-mobile-apis \| Outlook JavaScript APIs supported in Outlook on mobile devices}.`
	`22164`	+ * - In Outlook on Android and on iOS, the `setAsync` method is supported starting in Version 4.2530.0. On these mobile clients, the `setAsync` method isn't
	`22165`	`+ * supported when a user replies from the the reply field at the bottom of a message.`
`22166`	`22166`	`*`
`22167`	`22167`	* There's no recipient limit if you call `setAsync` in Outlook on Mac (new UI).
`22168`	`22168`	`*`