diff --git a/types/office-js-preview/index.d.ts b/types/office-js-preview/index.d.ts
index aa29c3c25e..9778889180 100644
--- a/types/office-js-preview/index.d.ts
+++ b/types/office-js-preview/index.d.ts
@@ -9576,6 +9576,9 @@ declare namespace Office {
/**
* Specifies the category color.
*
+ * **Note**: The actual color depends on how the Outlook client renders it.
+ * In this case, the colors noted on each preset are for the Outlook desktop client.
+ *
* [Api set: Mailbox Preview]
*
* @remarks
@@ -13663,6 +13666,21 @@ declare namespace Office {
*
*/
body: Body;
+ /**
+ * Gets an object that provides methods for managing the item's categories.
+ *
+ * [Api set: Mailbox Preview]
+ *
+ * @remarks
+ *
+ *
+ * | {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level} | ReadItem |
+ * | {@link https://docs.microsoft.com/outlook/add-ins/#extension-points | Applicable Outlook mode} | Compose or Read |
+ *
+ *
+ * @beta
+ */
+ categories: Categories;
/**
* Gets the type of item that an instance represents.
*
@@ -15046,6 +15064,21 @@ declare namespace Office {
*
*/
body: Body;
+ /**
+ * Gets an object that provides methods for managing the item's categories.
+ *
+ * [Api set: Mailbox Preview]
+ *
+ * @remarks
+ *
+ *
+ * | {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level} | ReadItem |
+ * | {@link https://docs.microsoft.com/outlook/add-ins/#extension-points | Applicable Outlook mode} | Message Compose |
+ *
+ *
+ * @beta
+ */
+ categories: Categories;
/**
* Provides access to the Cc (carbon copy) recipients of a message. The type of object and level of access depends on the mode of the
* current item.
@@ -17381,8 +17414,8 @@ declare namespace Office {
*/
interface Categories {
/**
- * Adds categories to an item. Each category name must be unique to that mailbox but multiple categories can use the same color.
- * Each category must also be in the categories master list.
+ * Adds categories to an item. Each category must be in the categories master list on that mailbox and so must have a unique name
+ * but multiple categories can use the same color.
*
* @param categories - The categories to be added to the item.
* @param options - Optional. An object literal that contains one or more of the following properties.
@@ -17396,16 +17429,15 @@ declare namespace Office {
*
* | {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level} | ReadWriteItem |
* | {@link https://docs.microsoft.com/outlook/add-ins/#extension-points | Applicable Outlook mode} | Compose or Read |
- * | Errors | NumberOfCategoriesExceeded - The number of categories exceeded the maximum amount. |
- * | InvalidCategory - Invalid categories were provided. |
+ * | Errors | InvalidCategory - Invalid categories were provided. |
*
*
* @beta
*/
addAsync(categories: string[], options?: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult) => void): void;
/**
- * Adds categories to an item. Each category name must be unique to that mailbox but multiple categories can use the same color.
- * Each category must also be in the categories master list.
+ * Adds categories to an item. Each category must be in the categories master list on that mailbox and so must have a unique name
+ * but multiple categories can use the same color.
*
* @param categories - The categories to be added to the item.
* @param callback - When the method completes, the function passed in the callback parameter is called with a single parameter of
@@ -17417,8 +17449,7 @@ declare namespace Office {
*
* | {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level} | ReadWriteItem |
* | {@link https://docs.microsoft.com/outlook/add-ins/#extension-points | Applicable Outlook mode} | Compose or Read |
- * | Errors | NumberOfCategoriesExceeded - The number of categories exceeded the maximum amount. |
- * | InvalidCategory - Invalid categories were provided. |
+ * | Errors | InvalidCategory - Invalid categories were provided. |
*
*
* @beta