webext-schema 5.2.3 → 5.2.6

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",
@@ -4163,7 +4176,7 @@
                   "optional": true
                 },
                 "type": {
-                  "description": "Specifies the type of the button. Default type is <code>button</code>.",
+                  "description": "Specifies the type of the button. Default type is <value>button</value>.",
                   "type": "string",
                   "enum": [
                     "button",
@@ -4271,7 +4284,7 @@
                   "optional": true
                 },
                 "type": {
-                  "description": "Specifies the type of the button. Default type is <code>button</code>.",
+                  "description": "Specifies the type of the button. Default type is <value>button</value>.",
                   "type": "string",
                   "enum": [
                     "button",
@@ -5776,6 +5789,9 @@
             },
             "overrideDefaultFccFolder": {
               "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
                 {
                   "$ref": "folders.MailFolder"
                 },
@@ -5791,6 +5807,9 @@
             },
             "additionalFccFolder": {
               "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
                 {
                   "$ref": "folders.MailFolder"
                 },
@@ -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",
@@ -6750,7 +6769,7 @@
                   "optional": true
                 },
                 "type": {
-                  "description": "Specifies the type of the button. Default type is <code>button</code>.",
+                  "description": "Specifies the type of the button. Default type is <value>button</value>.",
                   "type": "string",
                   "enum": [
                     "button",
@@ -7549,7 +7568,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 +7606,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,40 +7641,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": {
-              "type": "string",
+              "max_manifest_version": 2,
+              "$ref": "folders.MailFolderSpecialUse",
               "optional": true,
-              "description": "The type of folder, for several common types.",
-              "enum": [
-                "inbox",
-                "drafts",
-                "sent",
-                "trash",
-                "templates",
-                "archives",
-                "junk",
-                "outbox"
-              ]
+              "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",
@@ -7648,185 +7710,630 @@
               "description": "Number of unread messages in this folder."
             }
           }
-        }
-      ],
-      "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": "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."
             },
-            {
-              "name": "childName",
-              "type": "string"
+            "canAddSubfolders": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder supports adding new subfolders."
             },
-            {
-              "type": "function",
-              "name": "callback",
+            "canBeDeleted": {
+              "type": "boolean",
               "optional": true,
-              "parameters": [
-                {
-                  "$ref": "folders.MailFolder"
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "rename",
-          "type": "function",
-          "permissions": [
-            "accountsFolders"
-          ],
-          "description": "Renames a folder.",
-          "async": "callback",
-          "parameters": [
-            {
-              "name": "folder",
-              "$ref": "folders.MailFolder"
+              "description": "Whether this folder can be deleted."
             },
-            {
-              "name": "newName",
-              "type": "string"
+            "canBeRenamed": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether this folder can be renamed."
             },
-            {
-              "type": "function",
-              "name": "callback",
+            "canDeleteMessages": {
+              "type": "boolean",
               "optional": true,
-              "parameters": [
-                {
-                  "$ref": "folders.MailFolder"
-                }
-              ]
+              "description": "Whether this folder supports deleting messages."
             }
+          }
+        },
+        {
+          "id": "MailFolderSpecialUse",
+          "type": "string",
+          "description": "Supported values for the special use of a folder.",
+          "enum": [
+            "inbox",
+            "drafts",
+            "sent",
+            "trash",
+            "templates",
+            "archives",
+            "junk",
+            "outbox"
           ]
         },
         {
-          "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"
+          "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": "destination",
-              "choices": [
-                {
-                  "$ref": "folders.MailFolder"
-                },
-                {
-                  "$ref": "accounts.MailAccount"
-                }
-              ]
+            "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": "copy",
-          "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.",
-          "async": "callback",
-          "parameters": [
-            {
-              "name": "sourceFolder",
-              "$ref": "folders.MailFolder"
-            },
-            {
-              "name": "destination",
-              "choices": [
-                {
-                  "$ref": "folders.MailFolder"
-                },
-                {
-                  "$ref": "accounts.MailAccount"
-                }
-              ]
+          "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": "delete",
-          "permissions": [
-            "accountsFolders",
-            "messagesDelete"
-          ],
-          "type": "function",
-          "description": "Deletes a folder.",
-          "async": true,
-          "parameters": [
-            {
-              "name": "folder",
-              "$ref": "folders.MailFolder"
+          "id": "RegularExpression",
+          "type": "object",
+          "properties": {
+            "regexp": {
+              "type": "string",
+              "description": "A regular expression, for example <value>^Projects \\d{4}$</value>."
+            },
+            "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
             }
-          ]
-        },
+          }
+        }
+      ],
+      "functions": [
         {
-          "name": "getFolderInfo",
+          "name": "query",
           "type": "function",
-          "description": "Get additional information about a mail folder.",
+          "description": "Gets folders that match the specified properties, or all folders if no properties are specified.",
           "async": "callback",
           "parameters": [
             {
-              "name": "folder",
-              "$ref": "folders.MailFolder"
-            },
-            {
-              "type": "function",
-              "name": "callback",
+              "type": "object",
+              "name": "queryInfo",
               "optional": true,
-              "parameters": [
-                {
-                  "$ref": "folders.MailFolderInfo"
-                }
-              ]
-            }
-          ]
-        },
-        {
+              "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."
+                },
+                "mostRecent": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the folder (excluding subfolders) has been used within the last month. The returned folders will be sorted by their recentness and limited to the most recent ones, which is controlled by the <value>mail.folder_widget.max_recent</value> preference. A value of <value>false</value> is ignored."
+                },
+                "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. Ignored if <value>mostRecent</value> is specified."
+                },
+                "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"
+          ],
+          "type": "function",
+          "description": "Deletes 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.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 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.getFolderInfo() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ]
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "folders.MailFolderInfo"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "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",
           "description": "Get all parent folders as a flat ordered array. The first array entry is the direct parent.",
@@ -7834,7 +8341,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",
@@ -7865,12 +8381,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"
                 }
               ]
@@ -7888,10 +8411,34 @@
               "optional": true,
               "parameters": [
                 {
-                  "type": "array",
-                  "items": {
-                    "$ref": "folders.MailFolder"
-                  }
+                  "type": "array",
+                  "items": {
+                    "$ref": "folders.MailFolder"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "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"
                 }
               ]
             }
@@ -7966,6 +8513,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",
@@ -8012,7 +8574,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."
             },
@@ -8073,7 +8635,7 @@
           "parameters": [
             {
               "name": "accountId",
-              "type": "string",
+              "$ref": "accounts.MailAccountId",
               "optional": true
             },
             {
@@ -8125,7 +8687,7 @@
           "parameters": [
             {
               "name": "accountId",
-              "type": "string"
+              "$ref": "accounts.MailAccountId"
             },
             {
               "name": "details",
@@ -8195,7 +8757,7 @@
           "parameters": [
             {
               "name": "accountId",
-              "type": "string"
+              "$ref": "accounts.MailAccountId"
             },
             {
               "type": "function",
@@ -8217,7 +8779,7 @@
           "parameters": [
             {
               "name": "accountId",
-              "type": "string"
+              "$ref": "accounts.MailAccountId"
             },
             {
               "name": "identityId",
@@ -8357,6 +8919,92 @@
             }
           }
         },
+        {
+          "id": "MailTabProperties",
+          "type": "object",
+          "properties": {
+            "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.",
+              "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
+            },
+            "displayedFolder": {
+              "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
+            }
+          }
+        },
         {
           "id": "QuickFilterTextDetail",
           "type": "object",
@@ -8481,11 +9129,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",
@@ -8496,80 +9171,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"
+                }
+              ]
             }
           ]
         },
@@ -8621,7 +9264,7 @@
             {
               "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"
               }
@@ -8672,7 +9315,7 @@
                       "type": "boolean"
                     },
                     {
-                      "$ref": "messages.TagsDetail"
+                      "$ref": "messages.tags.TagsDetail"
                     }
                   ],
                   "description": "Shows only messages with tags on them."
@@ -9774,7 +10417,7 @@
                   "optional": true
                 },
                 "type": {
-                  "description": "Specifies the type of the button. Default type is <code>button</code>.",
+                  "description": "Specifies the type of the button. Default type is <value>button</value>.",
                   "type": "string",
                   "enum": [
                     "button",
@@ -10565,7 +11208,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`."
             }
           }
         },
@@ -10671,52 +11314,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",
@@ -10744,6 +11341,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": [
@@ -10828,6 +11442,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
+            }
           ]
         }
       ],
@@ -10843,7 +11465,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",
@@ -10851,7 +11482,7 @@
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "MessageList"
+                  "$ref": "messages.MessageList"
                 }
               ]
             }
@@ -10873,16 +11504,28 @@
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "MessageList"
+                  "$ref": "messages.MessageList"
                 }
               ]
             }
           ]
         },
+        {
+          "name": "abortList",
+          "type": "function",
+          "description": "Finalizes the specified list and terminates any process currently still adding messages.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "messageListId",
+              "type": "string"
+            }
+          ]
+        },
         {
           "name": "get",
           "type": "function",
-          "description": "Returns a specified message.",
+          "description": "Returns the specified message.",
           "async": "callback",
           "parameters": [
             {
@@ -10904,7 +11547,7 @@
         {
           "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": [
             {
@@ -11071,10 +11714,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",
@@ -11091,8 +11746,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."
                 },
@@ -11119,20 +11781,25 @@
                 "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."
                 },
@@ -11146,10 +11813,47 @@
                   "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,
+                  "description": "Set the timeout in ms after which results should be returned, even if the nominal number of messages-per-page has not yet been reached. Defaults to <value>1000</value> ms. Setting it to <value>0</value> will disable auto-pagination."
+                },
+                "messagesPerPage": {
+                  "type": "integer",
+                  "optional": true,
+                  "description": "Set the nominal number of messages-per-page for this query. Defaults to <value>100</value> messages."
+                },
+                "returnMessageListId": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "The <em>messageListId</em> is usually returned together with the first page, after some messages have been found. Enabling this option will change the return value of this function and return the <em>messageListId</em> directly."
                 }
               }
             },
@@ -11159,7 +11863,14 @@
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "MessageList"
+                  "choices": [
+                    {
+                      "$ref": "messages.MessageList"
+                    },
+                    {
+                      "type": "string"
+                    }
+                  ]
                 }
               ]
             }
@@ -11203,7 +11914,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.move() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ],
               "description": "The folder to move the messages to."
             }
           ]
@@ -11229,7 +11949,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.copy() requires to specify a MailFolderId instead of a full MailFolder object.",
+                  "$ref": "folders.MailFolder"
+                }
+              ],
               "description": "The folder to copy the messages to."
             }
           ]
@@ -11278,7 +12007,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."
             },
             {
@@ -11323,6 +12061,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",
@@ -11332,7 +12072,7 @@
                 {
                   "type": "array",
                   "items": {
-                    "$ref": "MessageTag"
+                    "$ref": "messages.tags.MessageTag"
                   }
                 }
               ]
@@ -11347,12 +12087,14 @@
           "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",
               "name": "key",
-              "description": "Unique tag identifier (must use only alphanumeric characters).",
-              "pattern": "^[$a-zA-Z0-9]+$"
+              "description": "Unique tag identifier (will be converted to lower case). Must not include <value>()<>{/%*\"</value> or spaces.",
+              "pattern": "^[^ ()/{%*<>\"]+$"
             },
             {
               "type": "string",
@@ -11362,7 +12104,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}"
             }
           ]
@@ -11375,12 +12117,14 @@
           "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",
               "name": "key",
-              "description": "Unique tag identifier.",
-              "pattern": "^[$a-zA-Z0-9]+$"
+              "description": "Unique tag identifier (will be converted to lower case). Must not include <value>()<>{/%*\"</value> or spaces.",
+              "pattern": "^[^ ()/{%*<>\"]+$"
             },
             {
               "type": "object",
@@ -11409,11 +12153,170 @@
           "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",
+      "permissions": [
+        "messagesRead"
+      ],
+      "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.listTags` 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",
+          "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",
               "name": "key",
-              "pattern": "^[$a-zA-Z0-9]+$"
+              "description": "Unique tag identifier (will be converted to lower case). Must not include <value>()<>{/%*\"</value> or spaces.",
+              "pattern": "^[^ ()/{%*<>\"]+$"
             }
           ]
         }
@@ -12074,20 +12977,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": {
@@ -12112,6 +13002,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",
@@ -12408,9 +13316,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",
@@ -12527,7 +13445,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",