webext-schema 5.2.5 → 5.2.7

package/schemas/mail/mailext.json

@@ -2337,7 +2337,7 @@
           "properties": {
             "stylesheet": {
               "optional": true,
-              "description": "URL to a stylesheet introducing additional CSS variables, extending the theme-able areas of Thunderbird. The `theme_experiment add-on in our example repository <https://github.com/thundernest/sample-extensions/tree/master/theme_experiment>`__ is using the stylesheet shown below, to add the <value>--chat-button-color</value> CSS color variable: <literalinclude>includes/theme/theme_experiment_style.css<lang>CSS</lang></literalinclude>The following <em>manifest.json</em> file maps the </value>--chat-button-color</value> CSS color variable to the theme color key <value>exp_chat_button</value> and uses it to set a color for the chat button: <literalinclude>includes/theme/theme_experiment_manifest.json<lang>JSON</lang></literalinclude>",
+              "description": "URL to a stylesheet introducing additional CSS variables, extending the theme-able areas of Thunderbird. The `theme_experiment add-on in our example repository <https://github.com/thunderbird/sample-extensions/tree/master/theme_experiment>`__ is using the stylesheet shown below, to add the <value>--chat-button-color</value> CSS color variable: <literalinclude>includes/theme/theme_experiment_style.css<lang>CSS</lang></literalinclude>The following <em>manifest.json</em> file maps the </value>--chat-button-color</value> CSS color variable to the theme color key <value>exp_chat_button</value> and uses it to set a color for the chat button: <literalinclude>includes/theme/theme_experiment_manifest.json<lang>JSON</lang></literalinclude>",
               "$ref": "ExtensionURL"
             },
             "images": {
@@ -2872,7 +2872,7 @@
           "type": "object",
           "properties": {
             "id": {
-              "type": "string",
+              "$ref": "MailAccountId",
               "description": "A unique identifier for this account."
             },
             "name": {
@@ -2884,6 +2884,7 @@
               "description": "What sort of account this is, e.g. <value>imap</value>, <value>nntp</value>, or <value>pop3</value>."
             },
             "folders": {
+              "max_manifest_version": 2,
               "type": "array",
               "optional": true,
               "description": "The folders for this account are only included if requested.",
@@ -2891,6 +2892,11 @@
                 "$ref": "folders.MailFolder"
               }
             },
+            "rootFolder": {
+              "$ref": "folders.MailFolder",
+              "optional": true,
+              "description": "The root folder associated with this account."
+            },
             "identities": {
               "type": "array",
               "description": "The identities associated with this account. The default identity is listed first, others in no particular order.",
@@ -2899,6 +2905,11 @@
               }
             }
           }
+        },
+        {
+          "id": "MailAccountId",
+          "type": "string",
+          "description": "A unique id representing a :ref:`accounts.MailAccount`."
         }
       ],
       "functions": [
@@ -2938,7 +2949,7 @@
           "parameters": [
             {
               "name": "accountId",
-              "type": "string"
+              "$ref": "MailAccountId"
             },
             {
               "name": "includeFolders",
@@ -2991,11 +3002,12 @@
           "type": "function",
           "description": "Sets the default identity for an account.",
           "async": true,
-          "deprecated": "This will be removed. Use :ref:`identities.setDefault` instead.",
+          "max_manifest_version": 2,
+          "deprecated": "Deprecated since Thunderbird 91 and removed in Manifest V3: accounts.setDefaultIdentity() is now available as identities.setDefault.",
           "parameters": [
             {
               "name": "accountId",
-              "type": "string"
+              "$ref": "MailAccountId"
             },
             {
               "name": "identityId",
@@ -3008,11 +3020,12 @@
           "type": "function",
           "description": "Returns the default identity for an account, or <value>null</value> if it is not defined.",
           "async": "callback",
-          "deprecated": "This will be removed. Use :ref:`identities.getDefault` instead.",
+          "max_manifest_version": 2,
+          "deprecated": "Deprecated since Thunderbird 91 and removed in Manifest V3: accounts.getDefaultIdentity() is now available as identities.getDefault.",
           "parameters": [
             {
               "name": "accountId",
-              "type": "string"
+              "$ref": "MailAccountId"
             },
             {
               "type": "function",
@@ -3034,8 +3047,8 @@
           "description": "Fired when a new account has been created.",
           "parameters": [
             {
-              "name": "id",
-              "type": "string"
+              "name": "accountId",
+              "$ref": "MailAccountId"
             },
             {
               "name": "account",
@@ -3049,8 +3062,8 @@
           "description": "Fired when an account has been removed.",
           "parameters": [
             {
-              "name": "id",
-              "type": "string"
+              "name": "accountId",
+              "$ref": "MailAccountId"
             }
           ]
         },
@@ -3060,8 +3073,8 @@
           "description": "Fired when a property of an account has been modified. Folders and identities of accounts are not monitored by this event, use the dedicated folder and identity events instead. A changed ``defaultIdentity`` is reported only after a different identity has been assigned as default identity, but not after a property of the default identity has been changed.",
           "parameters": [
             {
-              "name": "id",
-              "type": "string"
+              "name": "accountId",
+              "$ref": "MailAccountId"
             },
             {
               "name": "changedValues",
@@ -4101,7 +4114,7 @@
                   "preprocess": "localize"
                 },
                 "default_icon": {
-                  "$ref": "IconPath",
+                  "$ref": "manifest.IconPath",
                   "description": "The paths to one or more icons for the action button.",
                   "optional": true
                 },
@@ -4200,7 +4213,7 @@
                   "preprocess": "localize"
                 },
                 "default_icon": {
-                  "$ref": "IconPath",
+                  "$ref": "manifest.IconPath",
                   "description": "The paths to one or more icons for the browserAction button.",
                   "optional": true
                 },
@@ -5776,6 +5789,9 @@
             },
             "overrideDefaultFccFolder": {
               "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
                 {
                   "$ref": "folders.MailFolder"
                 },
@@ -5791,6 +5807,9 @@
             },
             "additionalFccFolder": {
               "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
                 {
                   "$ref": "folders.MailFolder"
                 },
@@ -5829,7 +5848,7 @@
             },
             "relatedMessageId": {
               "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <value>null</value> in all other cases or if the original message was opened from file.",
-              "type": "integer",
+              "$ref": "messages.MessageId",
               "optional": true
             },
             "subject": {
@@ -5907,7 +5926,7 @@
             "attachVCard": {
               "type": "boolean",
               "optional": true,
-              "description": "Wether or not the vCard of the used identity will be attached to the message during send. Note: If the value has not been modified, selecting a different identity will load the default value of the new identity."
+              "description": "Whether or not the vCard of the used identity will be attached to the message during send. **Note:** If the value has not been modified, selecting a different identity will load the default value of the new identity."
             },
             "attachments": {
               "type": "array",
@@ -6205,9 +6224,8 @@
             {
               "name": "messageId",
               "description": "If specified, the message or template to edit as a new message.",
-              "type": "integer",
-              "optional": true,
-              "minimum": 1
+              "$ref": "messages.MessageId",
+              "optional": true
             },
             {
               "name": "details",
@@ -6236,8 +6254,7 @@
             {
               "name": "messageId",
               "description": "The message to reply to, as retrieved using other APIs.",
-              "type": "integer",
-              "minimum": 1
+              "$ref": "messages.MessageId"
             },
             {
               "name": "replyType",
@@ -6276,8 +6293,7 @@
             {
               "name": "messageId",
               "description": "The message to forward, as retrieved using other APIs.",
-              "type": "integer",
-              "minimum": 1
+              "$ref": "messages.MessageId"
             },
             {
               "name": "forwardType",
@@ -6714,7 +6730,7 @@
                   "preprocess": "localize"
                 },
                 "default_icon": {
-                  "$ref": "IconPath",
+                  "$ref": "manifest.IconPath",
                   "description": "The paths to one or more icons for the composeAction button.",
                   "optional": true
                 },
@@ -7549,7 +7565,7 @@
         {
           "name": "register",
           "type": "function",
-          "description": "Register a message display script programmatically",
+          "description": "Register a message display script programmatically. **Note:** Registered scripts will only be applied to newly opened messages. To apply the script to already open messages, manually inject your script by calling :ref:`tabs.executeScript` for each of the open <value>messageDisplay</value> tabs.",
           "async": true,
           "parameters": [
             {
@@ -7587,11 +7603,31 @@
         {
           "id": "MailFolder",
           "type": "object",
-          "description": "An object describing a mail folder, as returned for example by the :ref:`folders.getParentFolders` or :ref:`folders.getSubFolders` methods, or part of a :ref:`accounts.MailAccount` object, which is returned for example by the :ref:`accounts.list` and :ref:`accounts.get` methods. The ``subFolders`` property is only included if requested.",
+          "description": "An object describing a folder. The ``subFolders`` property is only included if requested.",
           "properties": {
             "accountId": {
-              "type": "string",
-              "description": "The account this folder belongs to."
+              "$ref": "accounts.MailAccountId",
+              "description": "The id of the account this folder belongs to."
+            },
+            "id": {
+              "$ref": "folders.MailFolderId",
+              "optional": true,
+              "description": "An identifier for the folder."
+            },
+            "isFavorite": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder is a favorite folder."
+            },
+            "isRoot": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder is a root folder."
+            },
+            "isVirtual": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder is a virtual search folder."
             },
             "name": {
               "type": "string",
@@ -7602,42 +7638,63 @@
               "type": "string",
               "description": "Path to this folder in the account. Although paths look predictable, never guess a folder's path, as there are a number of reasons why it may not be what you think it is. Use :ref:`folders.getParentFolders` or :ref:`folders.getSubFolders` to obtain hierarchy information."
             },
+            "specialUse": {
+              "type": "array",
+              "items": {
+                "$ref": "folders.MailFolderSpecialUse"
+              },
+              "optional": true,
+              "description": "The special use of this folder. A folder can have multiple special uses."
+            },
             "subFolders": {
               "type": "array",
               "description": "Subfolders are only included if requested. They will be returned in the same order as used in Thunderbird's folder pane.",
               "items": {
-                "$ref": "MailFolder"
+                "$ref": "folders.MailFolder"
               },
               "optional": true
             },
             "type": {
-              "choices": [
-                {
-                  "max_manifest_version": 2,
-                  "$ref": "folders.MailFolderType"
-                },
-                {
-                  "min_manifest_version": 3,
-                  "type": "array",
-                  "items": {
-                    "$ref": "folders.MailFolderType"
-                  }
-                }
-              ],
+              "max_manifest_version": 2,
+              "$ref": "folders.MailFolderSpecialUse",
               "optional": true,
-              "description": "The type of folder."
+              "description": "Deprecated. Was used to represent the type of this folder."
             }
           }
         },
+        {
+          "id": "MailFolderId",
+          "type": "string",
+          "description": "A unique id representing a :ref:`folders.MailFolder` throughout a session. Renaming or moving a folder will invalidate its id."
+        },
         {
           "id": "MailFolderInfo",
           "type": "object",
-          "description": "An object containing additional information about a mail folder.",
+          "description": "An object containing additional information about a folder.",
           "properties": {
             "favorite": {
               "type": "boolean",
               "optional": true,
-              "description": "Whether this folder is a favorite folder."
+              "max_manifest_version": 2,
+              "description": "Deprecated. This information is now available in :ref:`folders.MailFolder`."
+            },
+            "lastUsed": {
+              "$ref": "extensionTypes.Date",
+              "optional": true,
+              "description": "Date the folder was last used (precision: seconds)."
+            },
+            "quota": {
+              "type": "array",
+              "items": {
+                "$ref": "MailFolderQuota"
+              },
+              "optional": true,
+              "description": "Quota information, if available."
+            },
+            "newMessageCount": {
+              "type": "integer",
+              "optional": true,
+              "description": "Number of new messages in this folder."
             },
             "totalMessageCount": {
               "type": "integer",
@@ -7652,9 +7709,41 @@
           }
         },
         {
-          "id": "MailFolderType",
+          "id": "MailFolderCapabilities",
+          "type": "object",
+          "description": "An object containing capability information about a folder.",
+          "properties": {
+            "canAddMessages": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder supports adding new messages."
+            },
+            "canAddSubfolders": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder supports adding new subfolders."
+            },
+            "canBeDeleted": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder can be deleted."
+            },
+            "canBeRenamed": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder can be renamed."
+            },
+            "canDeleteMessages": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder supports deleting messages."
+            }
+          }
+        },
+        {
+          "id": "MailFolderSpecialUse",
           "type": "string",
-          "description": "The type of folder",
+          "description": "Supported values for the special use of a folder.",
           "enum": [
             "inbox",
             "drafts",
@@ -7665,148 +7754,467 @@
             "junk",
             "outbox"
           ]
-        }
-      ],
-      "functions": [
+        },
         {
-          "name": "create",
-          "type": "function",
-          "permissions": [
-            "accountsFolders"
-          ],
-          "description": "Creates a new subfolder in the specified folder or at the root of the specified account.",
-          "async": "callback",
-          "parameters": [
-            {
-              "name": "parent",
-              "choices": [
-                {
-                  "$ref": "folders.MailFolder"
-                },
-                {
-                  "$ref": "accounts.MailAccount"
-                }
-              ]
+          "id": "MailFolderQuota",
+          "type": "object",
+          "description": "An object containing quota information.",
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "STORAGE",
+                "MESSAGE"
+              ],
+              "description": "The type of the quota as defined by RFC2087. A <value>STORAGE</value> quota is constraining the available storage in bytes, a <value>MESSAGE</value> quota is constraining the number of storable messages."
             },
-            {
-              "name": "childName",
-              "type": "string"
+            "limit": {
+              "type": "integer",
+              "description": "The maximum available quota."
             },
-            {
-              "type": "function",
-              "name": "callback",
-              "optional": true,
-              "parameters": [
-                {
-                  "$ref": "folders.MailFolder"
-                }
-              ]
+            "used": {
+              "type": "integer",
+              "description": "The currently used quota."
+            },
+            "unused": {
+              "type": "integer",
+              "description": "The currently unused quota."
             }
-          ]
+          }
         },
         {
-          "name": "rename",
-          "type": "function",
-          "permissions": [
-            "accountsFolders"
-          ],
-          "description": "Renames a folder.",
-          "async": "callback",
-          "parameters": [
-            {
-              "name": "folder",
-              "$ref": "folders.MailFolder"
-            },
-            {
-              "name": "newName",
-              "type": "string"
+          "id": "QueryRange",
+          "type": "object",
+          "description": "An object defining a range.",
+          "properties": {
+            "min": {
+              "type": "integer",
+              "optional": true,
+              "description": "The minimum value required to match the query."
             },
-            {
-              "type": "function",
-              "name": "callback",
+            "max": {
+              "type": "integer",
               "optional": true,
-              "parameters": [
-                {
-                  "$ref": "folders.MailFolder"
-                }
-              ]
+              "description": "The maximum value required to match the query."
             }
-          ]
+          }
         },
         {
-          "name": "move",
-          "type": "function",
-          "permissions": [
-            "accountsFolders"
-          ],
-          "description": "Moves the given ``sourceFolder`` into the given ``destination``. Throws if the destination already contains a folder with the name of the source folder.",
-          "async": "callback",
-          "parameters": [
-            {
-              "name": "sourceFolder",
-              "$ref": "folders.MailFolder"
-            },
-            {
-              "name": "destination",
-              "choices": [
-                {
-                  "$ref": "folders.MailFolder"
-                },
-                {
-                  "$ref": "accounts.MailAccount"
-                }
-              ]
+          "id": "RegularExpression",
+          "type": "object",
+          "properties": {
+            "regexp": {
+              "type": "string",
+              "description": "A regular expression, for example <value>^Projects \\d{4}$</value>."
             },
-            {
-              "type": "function",
-              "name": "callback",
-              "optional": true,
-              "parameters": [
-                {
-                  "$ref": "folders.MailFolder"
-                }
-              ]
+            "flags": {
+              "type": "string",
+              "pattern": "^(i|u|v|iu|iv|ui|vi)$",
+              "description": "Supported RegExp flags: <value>i</value> = case insensitive, and/or one of <value>u</value> = unicode support or <value>v</value> = extended unicode support",
+              "optional": true
             }
-          ]
-        },
+          }
+        }
+      ],
+      "properties": {
+        "DEFAULT_MOST_RECENT_LIMIT": {
+          "value": -1,
+          "description": "The number of most recent folders used in Thunderbird's UI. Controled by the <value>mail.folder_widget.max_recent</value> preference."
+        }
+      },
+      "functions": [
         {
-          "name": "copy",
+          "name": "query",
           "type": "function",
-          "permissions": [
-            "accountsFolders"
-          ],
-          "description": "Copies the given ``sourceFolder`` into the given ``destination``. Throws if the destination already contains a folder with the name of the source folder.",
+          "description": "Gets folders that match the specified properties, or all folders if no properties are specified.",
           "async": "callback",
           "parameters": [
             {
-              "name": "sourceFolder",
-              "$ref": "folders.MailFolder"
-            },
-            {
-              "name": "destination",
-              "choices": [
-                {
-                  "$ref": "folders.MailFolder"
-                },
-                {
-                  "$ref": "accounts.MailAccount"
-                }
-              ]
-            },
-            {
-              "type": "function",
-              "name": "callback",
+              "type": "object",
+              "name": "queryInfo",
               "optional": true,
-              "parameters": [
-                {
-                  "$ref": "folders.MailFolder"
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "delete",
+              "default": {},
+              "properties": {
+                "accountId": {
+                  "$ref": "accounts.MailAccountId",
+                  "description": "Limits the search to folders of the account with the specified id.",
+                  "optional": true
+                },
+                "canAddMessages": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the folder supports adding new messages, or not."
+                },
+                "canAddSubfolders": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the folder supports adding new subfolders, or not."
+                },
+                "canBeDeleted": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the folder can be deleted, or not."
+                },
+                "canBeRenamed": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the folder can be renamed, or not."
+                },
+                "canDeleteMessages": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the folder supports deleting messages, or not."
+                },
+                "folderId": {
+                  "$ref": "folders.MailFolderId",
+                  "description": "Limits the search to the folder with the specified id.",
+                  "optional": true
+                },
+                "hasMessages": {
+                  "choices": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "$ref": "QueryRange"
+                    }
+                  ],
+                  "optional": true,
+                  "description": "Whether the folder (excluding subfolders) contains messages, or not. Supports to specify a :ref:`folders.QueryRange` (min/max) instead of a simple boolean value (none/some)."
+                },
+                "hasUnreadMessages": {
+                  "choices": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "$ref": "QueryRange"
+                    }
+                  ],
+                  "optional": true,
+                  "description": "Whether the folder (excluding subfolders) contains unread messages, or not. Supports to specify a :ref:`folders.QueryRange` (min/max) instead of a simple boolean value (none/some)."
+                },
+                "hasNewMessages": {
+                  "choices": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "$ref": "QueryRange"
+                    }
+                  ],
+                  "optional": true,
+                  "description": "Whether the folder (excluding subfolders) contains new messages, or not. Supports to specify a :ref:`folders.QueryRange` (min/max) instead of a simple boolean value (none/some)."
+                },
+                "hasSubFolders": {
+                  "choices": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "$ref": "QueryRange"
+                    }
+                  ],
+                  "optional": true,
+                  "description": "Whether the folder has subfolders, or not. Supports to specify a :ref:`folders.QueryRange` (min/max) instead of a simple boolean value (none/some)."
+                },
+                "isFavorite": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the folder is a favorite folder, or not."
+                },
+                "isVirtual": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this folder is a virtual search folder, or not."
+                },
+                "isRoot": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the folder is a root folder, or not."
+                },
+                "limit": {
+                  "type": "integer",
+                  "optional": true,
+                  "description": "Limits the number of returned folders. If used together with <value>recent</value>, supports being set to :ref:`folders.DEFAULT_MOST_RECENT_LIMIT`"
+                },
+                "name": {
+                  "choices": [
+                    {
+                      "$ref": "RegularExpression"
+                    },
+                    {
+                      "type": "string"
+                    }
+                  ],
+                  "optional": true,
+                  "description": "Return only folders whose name is matched by the provided string or regular expression."
+                },
+                "path": {
+                  "choices": [
+                    {
+                      "$ref": "RegularExpression"
+                    },
+                    {
+                      "type": "string"
+                    }
+                  ],
+                  "optional": true,
+                  "description": "Return only folders whose path is matched by the provided string or regular expression."
+                },
+                "recent": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the folder (excluding subfolders) has been used within the last month, or not. The returned folders will be sorted by their recentness."
+                },
+                "specialUse": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "folders.MailFolderSpecialUse"
+                  },
+                  "minItems": 1,
+                  "optional": true,
+                  "description": "Match only folders with the specified special use (folders have to match all specified uses)."
+                },
+                "type": {
+                  "max_manifest_version": 2,
+                  "$ref": "folders.MailFolderSpecialUse",
+                  "optional": true,
+                  "description": "Deprecated. Match only folders with the specified special use."
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "folders.MailFolder"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "get",
+          "type": "function",
+          "description": "Returns the specified folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folder",
+              "$ref": "folders.MailFolderId"
+            },
+            {
+              "name": "includeSubFolders",
+              "description": "Specifies whether the returned :ref:`folders.MailFolder` object should include all its nested subfolders . Defaults to <value>true</value>.",
+              "optional": true,
+              "default": true,
+              "type": "boolean"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "create",
+          "type": "function",
+          "permissions": [
+            "accountsFolders"
+          ],
+          "description": "Creates a new subfolder in the specified folder or at the root of the specified account.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "destination",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.create() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.create() requires to specify the MailFolderId of the account's rootFolder, instead of a full MailAccount object.",
+                  "$ref": "accounts.MailAccount"
+                }
+              ]
+            },
+            {
+              "name": "childName",
+              "type": "string"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "rename",
+          "type": "function",
+          "permissions": [
+            "accountsFolders"
+          ],
+          "description": "Renames a folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folder",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.rename() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            },
+            {
+              "name": "newName",
+              "type": "string"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "move",
+          "type": "function",
+          "permissions": [
+            "accountsFolders"
+          ],
+          "description": "Moves the given source folder into the given destination folder. Throws if the destination already contains a folder with the name of the source folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "source",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.move() requires to specify a MailFolderId for its source parameter, instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            },
+            {
+              "name": "destination",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.move() requires to specify a MailFolderId for its destination parameter, instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.move() requires to specify the MailFolderId of the account's rootFolder for its destination parameter, instead of a full MailAccount object.",
+                  "$ref": "accounts.MailAccount"
+                }
+              ]
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "copy",
+          "type": "function",
+          "permissions": [
+            "accountsFolders"
+          ],
+          "description": "Copies the given source folder into the given destination folder. Throws if the destination already contains a folder with the name of the source folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "source",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.copy() requires to specify a MailFolderId for its source parameter, instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            },
+            {
+              "name": "destination",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.copy() requires to specify a MailFolderId for its destination parameter, instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.copy() requires to specify the MailFolderId of the account's rootFolder for its destination parameter, instead of a full MailAccount object.",
+                  "$ref": "accounts.MailAccount"
+                }
+              ]
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "delete",
           "permissions": [
             "accountsFolders",
             "messagesDelete"
@@ -7817,19 +8225,73 @@
           "parameters": [
             {
               "name": "folder",
-              "$ref": "folders.MailFolder"
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.delete() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "update",
+          "permissions": [
+            "accountsFolders"
+          ],
+          "type": "function",
+          "description": "Updates properties of a folder.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "folder",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.update() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            },
+            {
+              "name": "updateProperties",
+              "type": "object",
+              "description": "The properties to update.",
+              "properties": {
+                "isFavorite": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Sets or clears the favorite status."
+                }
+              }
             }
           ]
         },
         {
           "name": "getFolderInfo",
           "type": "function",
-          "description": "Get additional information about a mail folder.",
+          "description": "Get additional information about a folder.",
           "async": "callback",
           "parameters": [
             {
               "name": "folder",
-              "$ref": "folders.MailFolder"
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getFolderInfo() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
             },
             {
               "type": "function",
@@ -7843,6 +8305,37 @@
             }
           ]
         },
+        {
+          "name": "getFolderCapabilities",
+          "type": "function",
+          "description": "Get capability information about a folder.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "folder",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getFolderCapabilities() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolderCapabilities"
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "getParentFolders",
           "type": "function",
@@ -7851,7 +8344,16 @@
           "parameters": [
             {
               "name": "folder",
-              "$ref": "folders.MailFolder"
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getParentFolders() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
             },
             {
               "name": "includeSubFolders",
@@ -7882,12 +8384,19 @@
           "async": "callback",
           "parameters": [
             {
-              "name": "folderOrAccount",
+              "name": "folder",
               "choices": [
                 {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getSubFolders() requires to specify a MailFolderId instead of a full MailFolder object.",
                   "$ref": "folders.MailFolder"
                 },
                 {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.getSubFolders() requires to specify the MailFolderId of the account's rootFolder, instead of a full MailAccount object.",
                   "$ref": "accounts.MailAccount"
                 }
               ]
@@ -7913,6 +8422,30 @@
               ]
             }
           ]
+        },
+        {
+          "name": "markAsRead",
+          "permissions": [
+            "accountsFolders"
+          ],
+          "type": "function",
+          "description": "Marks all messages in a folder as read.",
+          "async": false,
+          "parameters": [
+            {
+              "name": "folder",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: folders.markAsRead() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            }
+          ]
         }
       ],
       "events": [
@@ -7983,6 +8516,21 @@
             }
           ]
         },
+        {
+          "name": "onUpdated",
+          "type": "function",
+          "description": "Fired when properties of a folder have changed (<value>specialUse</value> and <value>isFavorite</value>).",
+          "parameters": [
+            {
+              "name": "originalFolder",
+              "$ref": "folders.MailFolder"
+            },
+            {
+              "name": "updatedFolder",
+              "$ref": "folders.MailFolder"
+            }
+          ]
+        },
         {
           "name": "onFolderInfoChanged",
           "type": "function",
@@ -8029,7 +8577,7 @@
           "type": "object",
           "properties": {
             "accountId": {
-              "type": "string",
+              "$ref": "accounts.MailAccountId",
               "optional": true,
               "description": "The id of the :ref:`accounts.MailAccount` this identity belongs to. The ``accountId`` property is read-only."
             },
@@ -8090,7 +8638,7 @@
           "parameters": [
             {
               "name": "accountId",
-              "type": "string",
+              "$ref": "accounts.MailAccountId",
               "optional": true
             },
             {
@@ -8142,7 +8690,7 @@
           "parameters": [
             {
               "name": "accountId",
-              "type": "string"
+              "$ref": "accounts.MailAccountId"
             },
             {
               "name": "details",
@@ -8212,7 +8760,7 @@
           "parameters": [
             {
               "name": "accountId",
-              "type": "string"
+              "$ref": "accounts.MailAccountId"
             },
             {
               "type": "function",
@@ -8234,7 +8782,7 @@
           "parameters": [
             {
               "name": "accountId",
-              "type": "string"
+              "$ref": "accounts.MailAccountId"
             },
             {
               "name": "identityId",
@@ -8253,61 +8801,134 @@
               "name": "identityId",
               "type": "string"
             },
-            {
-              "name": "identity",
-              "$ref": "MailIdentity"
-            }
-          ]
-        },
-        {
-          "name": "onDeleted",
-          "type": "function",
-          "description": "Fired when an identity has been removed from an account.",
-          "parameters": [
-            {
-              "name": "identityId",
-              "type": "string"
-            }
-          ]
-        },
-        {
-          "name": "onUpdated",
-          "type": "function",
-          "description": "Fired when one or more properties of an identity have been modified. The returned :ref:`identities.MailIdentity` includes only the changed values.",
-          "parameters": [
-            {
-              "name": "identityId",
-              "type": "string"
+            {
+              "name": "identity",
+              "$ref": "MailIdentity"
+            }
+          ]
+        },
+        {
+          "name": "onDeleted",
+          "type": "function",
+          "description": "Fired when an identity has been removed from an account.",
+          "parameters": [
+            {
+              "name": "identityId",
+              "type": "string"
+            }
+          ]
+        },
+        {
+          "name": "onUpdated",
+          "type": "function",
+          "description": "Fired when one or more properties of an identity have been modified. The returned :ref:`identities.MailIdentity` includes only the changed values.",
+          "parameters": [
+            {
+              "name": "identityId",
+              "type": "string"
+            },
+            {
+              "name": "changedValues",
+              "$ref": "MailIdentity"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "mailTabs.json": [
+    {
+      "namespace": "mailTabs",
+      "types": [
+        {
+          "id": "MailTab",
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "integer"
+            },
+            "windowId": {
+              "type": "integer"
+            },
+            "active": {
+              "type": "boolean"
+            },
+            "sortType": {
+              "type": "string",
+              "description": "**Note:** ``sortType`` and ``sortOrder`` depend on each other, so both should be present, or neither.",
+              "optional": true,
+              "enum": [
+                "none",
+                "date",
+                "subject",
+                "author",
+                "id",
+                "thread",
+                "priority",
+                "status",
+                "size",
+                "flagged",
+                "unread",
+                "recipient",
+                "location",
+                "tags",
+                "junkStatus",
+                "attachments",
+                "account",
+                "custom",
+                "received",
+                "correspondent"
+              ]
+            },
+            "sortOrder": {
+              "type": "string",
+              "description": "**Note:** ``sortType`` and ``sortOrder`` depend on each other, so both should be present, or neither.",
+              "optional": true,
+              "enum": [
+                "none",
+                "ascending",
+                "descending"
+              ]
+            },
+            "viewType": {
+              "type": "string",
+              "optional": true,
+              "enum": [
+                "ungrouped",
+                "groupedByThread",
+                "groupedBySortType"
+              ]
+            },
+            "layout": {
+              "type": "string",
+              "enum": [
+                "standard",
+                "wide",
+                "vertical"
+              ]
+            },
+            "folderPaneVisible": {
+              "type": "boolean",
+              "optional": true
+            },
+            "messagePaneVisible": {
+              "type": "boolean",
+              "optional": true
             },
-            {
-              "name": "changedValues",
-              "$ref": "MailIdentity"
+            "displayedFolder": {
+              "$ref": "folders.MailFolder",
+              "optional": true,
+              "description": "The <permission>accountsRead</permission> permission is required for this property to be included."
             }
-          ]
-        }
-      ]
-    }
-  ],
-  "mailTabs.json": [
-    {
-      "namespace": "mailTabs",
-      "types": [
+          }
+        },
         {
-          "id": "MailTab",
+          "id": "MailTabProperties",
           "type": "object",
           "properties": {
-            "id": {
-              "type": "integer"
-            },
-            "windowId": {
-              "type": "integer"
-            },
-            "active": {
-              "type": "boolean"
-            },
             "sortType": {
               "type": "string",
-              "description": "**Note:** ``sortType`` and ``sortOrder`` depend on each other, so both should be present, or neither.",
+              "description": "Sorts the list of messages. ``sortOrder`` must also be given.",
               "optional": true,
               "enum": [
                 "none",
@@ -8334,7 +8955,7 @@
             },
             "sortOrder": {
               "type": "string",
-              "description": "**Note:** ``sortType`` and ``sortOrder`` depend on each other, so both should be present, or neither.",
+              "description": "Sorts the list of messages. ``sortType`` must also be given.",
               "optional": true,
               "enum": [
                 "none",
@@ -8353,6 +8974,8 @@
             },
             "layout": {
               "type": "string",
+              "description": "Sets the arrangement of the folder pane, message list pane, and message display pane. Note that setting this applies it to all mail tabs.",
+              "optional": true,
               "enum": [
                 "standard",
                 "wide",
@@ -8361,16 +8984,27 @@
             },
             "folderPaneVisible": {
               "type": "boolean",
+              "description": "Shows or hides the folder pane.",
               "optional": true
             },
             "messagePaneVisible": {
               "type": "boolean",
+              "description": "Shows or hides the message display pane.",
               "optional": true
             },
             "displayedFolder": {
-              "$ref": "folders.MailFolder",
-              "optional": true,
-              "description": "The <permission>accountsRead</permission> permission is required for this property to be included."
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: MailTabProperties.displayedFolder needs to be specified as a MailFolderId instead of as a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ],
+              "description": "Sets the folder displayed in the mail tab. Requires the <permission>accountsRead</permission> permission. The previous message selection in the given folder will be restored, if any. This property is ignored, if <value>selectedMessages</value> is specified.",
+              "optional": true
             }
           }
         },
@@ -8498,11 +9132,38 @@
             }
           ]
         },
+        {
+          "name": "create",
+          "type": "function",
+          "description": "Creates a new mail tab. Standard tab properties can be adjusted via :ref:`tabs.update` after the mail tab has been created. **Note:** A new mail window can be created via :ref:`windows.create`.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "createProperties",
+              "$ref": "MailTabProperties",
+              "optional": true,
+              "default": {}
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "name": "mailTab",
+                  "$ref": "MailTab",
+                  "optional": true,
+                  "description": "Details about the created mail tab. Will contain the ID of the new tab."
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "update",
           "type": "function",
           "description": "Modifies the properties of a mail tab. Properties that are not specified in ``updateProperties`` are not modified.",
-          "async": true,
+          "async": "callback",
           "parameters": [
             {
               "name": "tabId",
@@ -8513,80 +9174,48 @@
             },
             {
               "name": "updateProperties",
-              "type": "object",
-              "properties": {
-                "displayedFolder": {
-                  "$ref": "folders.MailFolder",
-                  "description": "Sets the folder displayed in the tab. The extension must have the <permission>accountsRead</permission> permission to do this. The previous message selection in the given folder will be restored.",
-                  "optional": true
-                },
-                "sortType": {
-                  "type": "string",
-                  "description": "Sorts the list of messages. ``sortOrder`` must also be given.",
-                  "optional": true,
-                  "enum": [
-                    "none",
-                    "date",
-                    "subject",
-                    "author",
-                    "id",
-                    "thread",
-                    "priority",
-                    "status",
-                    "size",
-                    "flagged",
-                    "unread",
-                    "recipient",
-                    "location",
-                    "tags",
-                    "junkStatus",
-                    "attachments",
-                    "account",
-                    "custom",
-                    "received",
-                    "correspondent"
-                  ]
-                },
-                "sortOrder": {
-                  "type": "string",
-                  "description": "Sorts the list of messages. ``sortType`` must also be given.",
-                  "optional": true,
-                  "enum": [
-                    "none",
-                    "ascending",
-                    "descending"
-                  ]
-                },
-                "viewType": {
-                  "type": "string",
-                  "optional": true,
-                  "enum": [
-                    "ungrouped",
-                    "groupedByThread",
-                    "groupedBySortType"
-                  ]
-                },
-                "layout": {
-                  "type": "string",
-                  "description": "Sets the arrangement of the folder pane, message list pane, and message display pane. Note that setting this applies it to all mail tabs.",
+              "$ref": "MailTabProperties"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "name": "mailTab",
+                  "$ref": "MailTab",
                   "optional": true,
-                  "enum": [
-                    "standard",
-                    "wide",
-                    "vertical"
-                  ]
-                },
-                "folderPaneVisible": {
-                  "type": "boolean",
-                  "description": "Shows or hides the folder pane.",
-                  "optional": true
-                },
-                "messagePaneVisible": {
-                  "type": "boolean",
-                  "description": "Shows or hides the message display pane.",
-                  "optional": true
+                  "description": "Details about the updated mail tab."
                 }
-              }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "getListedMessages",
+          "type": "function",
+          "description": "Lists the messages in the current view, honoring sort order and filters.",
+          "permissions": [
+            "messagesRead"
+          ],
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "tabId",
+              "type": "integer",
+              "description": "Defaults to the active tab of the current window.",
+              "optional": true,
+              "minimum": 1
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "messages.MessageList"
+                }
+              ]
             }
           ]
         },
@@ -8638,9 +9267,9 @@
             {
               "name": "messageIds",
               "type": "array",
-              "description": "The IDs of the messages, which should be selected. The mailTab will switch to the folder of the selected messages. Throws if they belong to different folders. Array can be empty to deselect any currently selected message.",
+              "description": "The IDs of the messages, which should be selected. The mail tab will switch to the folder of the selected messages. Throws if they belong to different folders. Array can be empty to deselect any currently selected message.",
               "items": {
-                "type": "integer"
+                "$ref": "messages.MessageId"
               }
             }
           ]
@@ -8689,7 +9318,7 @@
                       "type": "boolean"
                     },
                     {
-                      "$ref": "messages.TagsDetail"
+                      "$ref": "messages.tags.TagsDetail"
                     }
                   ],
                   "description": "Shows only messages with tags on them."
@@ -9136,6 +9765,37 @@
               }
             }
           }
+        },
+        {
+          "id": "SingleMenuIconPath",
+          "choices": [
+            {
+              "type": "string",
+              "format": "imageDataOrStrictRelativeUrl"
+            },
+            {
+              "type": "string",
+              "pattern": "^(moz-extension|blob):.*$"
+            }
+          ],
+          "description": "The provided path may be a relative path to an icon file, an image <value>data:</value> URL, a <value>blob:</value> URL or a <value>moz-extension:<value> URL. The <value>data:</value> or <value>blob:</value> URLs can be retrieved as follows: <literalinclude>includes/DataBlobUrls.js<lang>JavaScript</lang></literalinclude>,"
+        },
+        {
+          "id": "MenuIconPath",
+          "choices": [
+            {
+              "$ref": "SingleMenuIconPath"
+            },
+            {
+              "type": "object",
+              "patternProperties": {
+                "^[1-9]\\d*$": {
+                  "$ref": "SingleMenuIconPath"
+                }
+              }
+            }
+          ],
+          "description": "Either a <em>string</em> to specify a single icon path to be used for all sizes, or a <em>dictionary object</em> to specify paths for multiple icons in different sizes, so the icon does not have to be scaled for a device with a different pixel density. Each entry is a <em>name-value</em> pair with <em>name</em> being a size and <em>value</em> being a path to the icon for the specified size. Example: <literalinclude>includes/MenuIconPath.json<lang>JSON</lang></literalinclude>See the `MDN documentation about choosing icon sizes <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action#choosing_icon_sizes>`__ for more information on this. "
         }
       ],
       "functions": [
@@ -9170,7 +9830,7 @@
                   "description": "The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension."
                 },
                 "icons": {
-                  "$ref": "manifest.IconPath",
+                  "$ref": "MenuIconPath",
                   "optional": true,
                   "description": "Custom icons to display next to the menu item. Custom icons can only be set for items appearing in submenus."
                 },
@@ -9311,7 +9971,7 @@
                   "optional": true
                 },
                 "icons": {
-                  "$ref": "manifest.IconPath",
+                  "$ref": "MenuIconPath",
                   "optional": "omit-key-if-missing"
                 },
                 "title": {
@@ -9686,9 +10346,8 @@
                   "description": "The DOM file object of a message to be opened."
                 },
                 "messageId": {
-                  "type": "integer",
+                  "$ref": "messages.MessageId",
                   "optional": true,
-                  "minimum": 1,
                   "description": "The id of a message to be opened. Will throw an <em>ExtensionError</em>, if the provided ``messageId`` is unknown or invalid."
                 },
                 "headerMessageId": {
@@ -9759,7 +10418,7 @@
                   "preprocess": "localize"
                 },
                 "default_icon": {
-                  "$ref": "IconPath",
+                  "$ref": "manifest.IconPath",
                   "description": "The paths to one or more icons for the messageDisplayAction button.",
                   "optional": true
                 },
@@ -10480,6 +11139,8 @@
                 "messagesMove",
                 "messagesRead",
                 "messagesTags",
+                "messagesTagsList",
+                "messagesUpdate",
                 "sensitiveDataUpload"
               ]
             }
@@ -10493,6 +11154,12 @@
         "messagesRead"
       ],
       "types": [
+        {
+          "id": "MessageId",
+          "type": "integer",
+          "minimum": 1,
+          "description": "A unique id representing a :ref:`messages.MessageHeader` and the associated message. This id doesn’t refer to the Message-ID email header. It is an internal tracking number that does not remain after a restart. Nor does it follow an email that has been moved to a different folder."
+        },
         {
           "id": "MessageHeader",
           "type": "object",
@@ -10540,8 +11207,7 @@
               "type": "boolean"
             },
             "id": {
-              "type": "integer",
-              "minimum": 1
+              "$ref": "messages.MessageId"
             },
             "junk": {
               "description": "Whether the message has been marked as junk. Always <value>false</value> for news/nntp messages and external messages.",
@@ -10582,7 +11248,7 @@
               "items": {
                 "type": "string"
               },
-              "description": "Tags associated with this message. For a list of available tags, call the listTags method."
+              "description": "Tags associated with this message. For a list of available tags, use :ref:`messages.tags.list`."
             }
           }
         },
@@ -10680,7 +11346,7 @@
             },
             "tags": {
               "type": "array",
-              "description": "Tags associated with this message. For a list of available tags, call the listTags method.",
+              "description": "Tags associated with this message. For a list of available tags, call the :ref:`messages.tags.list` method.",
               "optional": true,
               "items": {
                 "type": "string"
@@ -10688,52 +11354,6 @@
             }
           }
         },
-        {
-          "id": "MessageTag",
-          "type": "object",
-          "properties": {
-            "key": {
-              "type": "string",
-              "description": "Unique tag identifier."
-            },
-            "tag": {
-              "type": "string",
-              "description": "Human-readable tag name."
-            },
-            "color": {
-              "type": "string",
-              "description": "Tag color."
-            },
-            "ordinal": {
-              "type": "string",
-              "description": "Custom sort string (usually empty)."
-            }
-          }
-        },
-        {
-          "id": "TagsDetail",
-          "type": "object",
-          "description": "Used for filtering messages by tag in various methods. Note that functions using this type may have a partial implementation.",
-          "properties": {
-            "tags": {
-              "type": "object",
-              "description": "A <em>dictionary object</em> with one or more filter condition as <em>key-value</em> pairs, the <em>key</em> being the tag to filter on, and the <em>value</em> being a boolean expression, requesting whether a message must include (<value>true</value>) or exclude (<value>false</value>) the tag. For a list of available tags, call the :ref:`messages.listTags` method.",
-              "patternProperties": {
-                ".*": {
-                  "type": "boolean"
-                }
-              }
-            },
-            "mode": {
-              "type": "string",
-              "description": "Whether all of the tag filters must apply, or any of them.",
-              "enum": [
-                "all",
-                "any"
-              ]
-            }
-          }
-        },
         {
           "id": "MessageAttachment",
           "type": "object",
@@ -10761,6 +11381,23 @@
               "description": "A MessageHeader, if this attachment is a message."
             }
           }
+        },
+        {
+          "id": "QueryRange",
+          "type": "object",
+          "description": "An object defining a range.",
+          "properties": {
+            "min": {
+              "type": "integer",
+              "optional": true,
+              "description": "The minimum value required to match the query."
+            },
+            "max": {
+              "type": "integer",
+              "optional": true,
+              "description": "The maximum value required to match the query."
+            }
+          }
         }
       ],
       "events": [
@@ -10845,6 +11482,14 @@
               "name": "messages",
               "$ref": "messages.MessageList"
             }
+          ],
+          "extraParameters": [
+            {
+              "name": "monitorAllFolders",
+              "description": "Monitor all folders (including all special use folders as defined by :ref:`folders.MailFolderSpecialUse`) instead of just inbox folders and normal folders.",
+              "type": "boolean",
+              "optional": true
+            }
           ]
         }
       ],
@@ -10860,7 +11505,16 @@
           "parameters": [
             {
               "name": "folder",
-              "$ref": "folders.MailFolder"
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: messages.list() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
             },
             {
               "type": "function",
@@ -10911,12 +11565,12 @@
         {
           "name": "get",
           "type": "function",
-          "description": "Returns a specified message.",
+          "description": "Returns the specified message.",
           "async": "callback",
           "parameters": [
             {
               "name": "messageId",
-              "type": "integer"
+              "$ref": "messages.MessageId"
             },
             {
               "type": "function",
@@ -10933,12 +11587,12 @@
         {
           "name": "getFull",
           "type": "function",
-          "description": "Returns a specified message, including all headers and MIME parts. Throws if the message could not be read, for example due to network issues.",
+          "description": "Returns the specified message, including all headers and MIME parts. Throws if the message could not be read, for example due to network issues.",
           "async": "callback",
           "parameters": [
             {
               "name": "messageId",
-              "type": "integer"
+              "$ref": "messages.MessageId"
             },
             {
               "type": "function",
@@ -10960,7 +11614,7 @@
           "parameters": [
             {
               "name": "messageId",
-              "type": "integer"
+              "$ref": "messages.MessageId"
             },
             {
               "name": "options",
@@ -11020,7 +11674,7 @@
           "parameters": [
             {
               "name": "messageId",
-              "type": "integer"
+              "$ref": "messages.MessageId"
             },
             {
               "type": "function",
@@ -11045,7 +11699,7 @@
           "parameters": [
             {
               "name": "messageId",
-              "type": "integer"
+              "$ref": "messages.MessageId"
             },
             {
               "name": "partName",
@@ -11074,7 +11728,7 @@
           "parameters": [
             {
               "name": "messageId",
-              "type": "integer"
+              "$ref": "messages.MessageId"
             },
             {
               "name": "partName",
@@ -11100,10 +11754,22 @@
               "optional": true,
               "default": {},
               "properties": {
+                "accountId": {
+                  "$ref": "accounts.MailAccountId",
+                  "description": "Limits the search to folders of the account with the specified id.",
+                  "optional": true
+                },
                 "attachment": {
-                  "type": "boolean",
+                  "choices": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "$ref": "QueryRange"
+                    }
+                  ],
                   "optional": true,
-                  "description": "If specified, returns only messages with or without attachments."
+                  "description": "Whether the message has attachments, or not. Supports to specify a :ref:`messages.QueryRange` (min/max) instead of a simple boolean value (none/some)."
                 },
                 "author": {
                   "type": "string",
@@ -11120,8 +11786,15 @@
                   "optional": true,
                   "description": "Returns only flagged (or unflagged if false) messages."
                 },
+                "folderId": {
+                  "$ref": "folders.MailFolderId",
+                  "optional": true,
+                  "description": "Returns only messages from the folder with the specified id. The <permission>accountsRead</permission> permission is required."
+                },
                 "folder": {
                   "$ref": "folders.MailFolder",
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: messages.queryInfo.folder has been replaced by messages.queryInfo.folderId.",
                   "optional": true,
                   "description": "Returns only messages from the specified folder. The <permission>accountsRead</permission> permission is required."
                 },
@@ -11148,22 +11821,27 @@
                 "includeSubFolders": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "Search the folder specified by ``queryInfo.folder`` recursively."
+                  "description": "Search the specified folder recursively."
                 },
                 "recipients": {
                   "type": "string",
                   "optional": true,
                   "description": "Returns only messages whose recipients match all specified addresses. The search value is a semicolon separated list of email addresses, names or combinations (e.g.: <value>Name <user@domain.org></value>). For a match, all specified addresses must equal a recipient's address completely and all specified names must match a recipient's name partially. All matches are done case-insensitive."
                 },
+                "size": {
+                  "$ref": "QueryRange",
+                  "optional": true,
+                  "description": "Returns only messages with a size in the specified byte range."
+                },
                 "subject": {
                   "type": "string",
                   "optional": true,
-                  "description": "Returns only messages with this value matching the subject."
+                  "description": "Returns only messages whose subject contains the provided string."
                 },
                 "tags": {
-                  "$ref": "TagsDetail",
+                  "$ref": "messages.tags.TagsDetail",
                   "optional": true,
-                  "description": "Returns only messages with the specified tags. For a list of available tags, call the :ref:`messages.listTags` method."
+                  "description": "Returns only messages with the specified tags. For a list of available tags, call the :ref:`messages.tags.list` method."
                 },
                 "toDate": {
                   "$ref": "extensionTypes.Date",
@@ -11175,11 +11853,33 @@
                   "optional": true,
                   "description": "Returns only messages with at least one recipient address matching any configured identity."
                 },
+                "junk": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Returns only messages whith the specified junk state."
+                },
+                "junkScore": {
+                  "$ref": "QueryRange",
+                  "optional": true,
+                  "description": "Returns only messages with a junk score in the specified range."
+                },
+                "new": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Returns only messages with the specified new state."
+                },
                 "unread": {
                   "type": "boolean",
                   "optional": true,
+                  "max_manifest_version": 2,
                   "description": "Returns only unread (or read if false) messages."
                 },
+                "read": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Returns only messages with the specified read state.",
+                  "min_manifest_version": 3
+                },
                 "autoPaginationTimeout": {
                   "type": "integer",
                   "optional": true,
@@ -11219,13 +11919,15 @@
         {
           "name": "update",
           "type": "function",
-          "description": "Marks or unmarks a message as junk, read, flagged, or tagged. Updating external messages will throw an <em>ExtensionError</em>.",
+          "description": "Updates message properties and tags. Updating external messages will throw an <em>ExtensionError</em>.",
           "async": true,
+          "permissions": [
+            "messagesUpdate"
+          ],
           "parameters": [
             {
               "name": "messageId",
-              "type": "integer",
-              "minimum": 1
+              "$ref": "messages.MessageId"
             },
             {
               "name": "newProperties",
@@ -11248,13 +11950,21 @@
               "type": "array",
               "description": "The IDs of the messages to move.",
               "items": {
-                "type": "integer",
-                "minimum": 1
+                "$ref": "messages.MessageId"
               }
             },
             {
               "name": "destination",
-              "$ref": "folders.MailFolder",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: messages.move() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ],
               "description": "The folder to move the messages to."
             }
           ]
@@ -11274,13 +11984,21 @@
               "type": "array",
               "description": "The IDs of the messages to copy.",
               "items": {
-                "type": "integer",
-                "minimum": 1
+                "$ref": "messages.MessageId"
               }
             },
             {
               "name": "destination",
-              "$ref": "folders.MailFolder",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: messages.copy() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ],
               "description": "The folder to copy the messages to."
             }
           ]
@@ -11299,8 +12017,7 @@
               "type": "array",
               "description": "The IDs of the messages to delete.",
               "items": {
-                "type": "integer",
-                "minimum": 1
+                "$ref": "messages.MessageId"
               }
             },
             {
@@ -11329,7 +12046,16 @@
             },
             {
               "name": "destination",
-              "$ref": "folders.MailFolder",
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "max_manifest_version": 2,
+                  "deprecated": "Support deprecated since Thunderbird 121 and removed in Manifest V3: messages.import() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ],
               "description": "The folder to import the messages into."
             },
             {
@@ -11363,8 +12089,7 @@
               "type": "array",
               "description": "The IDs of the messages to archive.",
               "items": {
-                "type": "integer",
-                "minimum": 1
+                "$ref": "messages.MessageId"
               }
             }
           ]
@@ -11374,6 +12099,8 @@
           "type": "function",
           "description": "Returns a list of tags that can be set on messages, and their human-friendly name, colour, and sort order.",
           "async": "callback",
+          "max_manifest_version": 2,
+          "deprecated": "Deprecated since Thunderbird 121 and removed in Manifest V3: messages.listTags() is now available as messages.tags.list().",
           "parameters": [
             {
               "type": "function",
@@ -11383,7 +12110,7 @@
                 {
                   "type": "array",
                   "items": {
-                    "$ref": "MessageTag"
+                    "$ref": "messages.tags.MessageTag"
                   }
                 }
               ]
@@ -11398,6 +12125,8 @@
           "permissions": [
             "messagesTags"
           ],
+          "max_manifest_version": 2,
+          "deprecated": "Deprecated since Thunderbird 121 and removed in Manifest V3: messages.createTag() is now available as messages.tags.create().",
           "parameters": [
             {
               "type": "string",
@@ -11413,7 +12142,7 @@
             {
               "type": "string",
               "name": "color",
-              "description": "Tag color in hex format (i.e.: #000080 for navy blue)",
+              "description": "Tag color in hex format (i.e.: <value>#000080</value> for navy blue)",
               "pattern": "^#[0-9a-f]{6}"
             }
           ]
@@ -11426,6 +12155,8 @@
           "permissions": [
             "messagesTags"
           ],
+          "max_manifest_version": 2,
+          "deprecated": "Deprecated since Thunderbird 121 and removed in Manifest V3: messages.updateTag() is now available as messages.tags.update().",
           "parameters": [
             {
               "type": "string",
@@ -11460,6 +12191,164 @@
           "permissions": [
             "messagesTags"
           ],
+          "max_manifest_version": 2,
+          "deprecated": "Deprecated since Thunderbird 121 and removed in Manifest V3: messages.deleteTag() is now available as messages.tags.delete().",
+          "parameters": [
+            {
+              "type": "string",
+              "name": "key",
+              "description": "Unique tag identifier (will be converted to lower case). Must not include <value>()<>{/%*\"</value> or spaces.",
+              "pattern": "^[^ ()/{%*<>\"]+$"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "namespace": "messages.tags",
+      "types": [
+        {
+          "id": "MessageTag",
+          "type": "object",
+          "properties": {
+            "key": {
+              "type": "string",
+              "description": "Unique tag identifier."
+            },
+            "tag": {
+              "type": "string",
+              "description": "Human-readable tag name."
+            },
+            "color": {
+              "type": "string",
+              "description": "Tag color."
+            },
+            "ordinal": {
+              "type": "string",
+              "description": "Custom sort string (usually empty)."
+            }
+          }
+        },
+        {
+          "id": "TagsDetail",
+          "type": "object",
+          "description": "Used for filtering messages by tag in various methods. Note that functions using this type may have a partial implementation.",
+          "properties": {
+            "tags": {
+              "type": "object",
+              "description": "A <em>dictionary object</em> with one or more filter condition as <em>key-value</em> pairs, the <em>key</em> being the tag to filter on, and the <em>value</em> being a boolean expression, requesting whether a message must include (<value>true</value>) or exclude (<value>false</value>) the tag. For a list of available tags, call the :ref:`messages.tags.list` method.",
+              "patternProperties": {
+                ".*": {
+                  "type": "boolean"
+                }
+              }
+            },
+            "mode": {
+              "type": "string",
+              "description": "Whether all of the tag filters must apply, or any of them.",
+              "enum": [
+                "all",
+                "any"
+              ]
+            }
+          }
+        }
+      ],
+      "functions": [
+        {
+          "name": "list",
+          "type": "function",
+          "description": "Returns a list of tags that can be set on messages, and their human-friendly name, colour, and sort order.",
+          "async": "callback",
+          "permissions": [
+            "messagesTagsList"
+          ],
+          "parameters": [
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "messages.tags.MessageTag"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "create",
+          "type": "function",
+          "description": "Creates a new message tag. Tagging a message will store the tag's key in the user's message. Throws if the specified tag key is used already.",
+          "async": true,
+          "permissions": [
+            "messagesTags"
+          ],
+          "parameters": [
+            {
+              "type": "string",
+              "name": "key",
+              "description": "Unique tag identifier (will be converted to lower case). Must not include <value>()<>{/%*\"</value> or spaces.",
+              "pattern": "^[^ ()/{%*<>\"]+$"
+            },
+            {
+              "type": "string",
+              "name": "tag",
+              "description": "Human-readable tag name."
+            },
+            {
+              "type": "string",
+              "name": "color",
+              "description": "Tag color in hex format (i.e.: #000080 for navy blue)",
+              "pattern": "^#[0-9a-f]{6}"
+            }
+          ]
+        },
+        {
+          "name": "update",
+          "type": "function",
+          "description": "Updates a message tag.",
+          "async": true,
+          "permissions": [
+            "messagesTags"
+          ],
+          "parameters": [
+            {
+              "type": "string",
+              "name": "key",
+              "description": "Unique tag identifier (will be converted to lower case). Must not include <value>()<>{/%*\"</value> or spaces.",
+              "pattern": "^[^ ()/{%*<>\"]+$"
+            },
+            {
+              "type": "object",
+              "name": "updateProperties",
+              "properties": {
+                "tag": {
+                  "type": "string",
+                  "optional": "true",
+                  "description": "Human-readable tag name."
+                },
+                "color": {
+                  "type": "string",
+                  "pattern": "^#[0-9a-f]{6}",
+                  "description": "Tag color in hex format (i.e.: #000080 for navy blue).",
+                  "optional": "true"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "name": "delete",
+          "type": "function",
+          "description": "Deletes a message tag, removing it from the list of known tags. Its key will not be removed from tagged messages, but they will appear untagged. Recreating a deleted tag, will make all former tagged messages appear tagged again.",
+          "async": true,
+          "permissions": [
+            "messagesTags"
+          ],
           "parameters": [
             {
               "type": "string",
@@ -12126,20 +13015,7 @@
               "description": "The `CookieStore <|link-cookieStore|>`__ id used by the tab. Either a custom id created using the `contextualIdentities API <|link-contextualIdentity|>`__, or a built-in one: <value>firefox-default</value>, <value>firefox-container-1</value>, <value>firefox-container-2</value>, <value>firefox-container-3</value>, <value>firefox-container-4</value>, <value>firefox-container-5</value>. **Note:** The naming pattern was deliberately not changed for Thunderbird, but kept for compatibility reasons."
             },
             "type": {
-              "type": "string",
-              "enum": [
-                "addressBook",
-                "calendar",
-                "calendarEvent",
-                "calendarTask",
-                "chat",
-                "content",
-                "mail",
-                "messageCompose",
-                "messageDisplay",
-                "special",
-                "tasks"
-              ],
+              "$ref": "TabType",
               "optional": true
             },
             "mailTab": {
@@ -12164,6 +13040,24 @@
           ],
           "description": "Whether the tabs have completed loading."
         },
+        {
+          "id": "TabType",
+          "type": "string",
+          "enum": [
+            "addressBook",
+            "calendar",
+            "calendarEvent",
+            "calendarTask",
+            "chat",
+            "content",
+            "mail",
+            "messageCompose",
+            "messageDisplay",
+            "special",
+            "tasks"
+          ],
+          "description": "Tab types supported by the tabs API."
+        },
         {
           "id": "WindowType",
           "type": "string",
@@ -12460,9 +13354,19 @@
                   "optional": true
                 },
                 "type": {
-                  "type": "string",
+                  "choices": [
+                    {
+                      "$ref": "TabType"
+                    },
+                    {
+                      "type": "array",
+                      "items": {
+                        "$ref": "TabType"
+                      }
+                    }
+                  ],
                   "optional": true,
-                  "description": "Match tabs against the given Tab.type (see :ref:`tabs.Tab`). Ignored if ``queryInfo.mailTab`` is specified."
+                  "description": "Match tabs against the given tab type or types. Ignored if ``queryInfo.mailTab`` is specified."
                 },
                 "active": {
                   "type": "boolean",
@@ -12579,7 +13483,7 @@
                 "url": {
                   "type": "string",
                   "optional": true,
-                  "description": "A URL of a page to load. If the URL points to a content page (a web page, an extension page or a registered WebExtension protocol handler page), the tab will navigate to the requested page. All other URLs will be opened externally without changing the tab. Note: This function will throw an error, if a content page is loaded into a non-content tab (its type must be either <value>content</value> or <value>mail</value>)."
+                  "description": "A URL of a page to load. If the URL points to a content page (a web page, an extension page or a registered WebExtension protocol handler page), the tab will navigate to the requested page. All other URLs will be opened externally without changing the tab. **Note:** This function will throw an error, if a content page is loaded into a non-content tab (its type must be either <value>content</value> or <value>mail</value>)."
                 },
                 "active": {
                   "type": "boolean",