Use messageId

compose.rst

@@ -110,7 +110,7 @@ Open a new message compose window forwarding a given message.
 
    .. api-member::
       :name: ``messageId``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
       The message to forward, as retrieved using other APIs.
 
@@ -165,7 +165,7 @@ Open a new message compose window.
 
    .. api-member::
       :name: [``messageId``]
-      :type: (integer, optional)
+      :type: (:ref:`messages.MessageId`, optional)
       :annotation: -- [Added in TB 84, backported to TB 78.7.0]
 
       If specified, the message or template to edit as a new message.
@@ -208,7 +208,7 @@ Open a new message compose window replying to a given message.
 
    .. api-member::
       :name: ``messageId``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
       The message to reply to, as retrieved using other APIs.
 
@@ -1313,7 +1313,7 @@ Used by various functions to represent the state of a message being composed. No
 
    .. api-member::
       :name: [``relatedMessageId``]
-      :type: (integer, optional)
+      :type: (:ref:`messages.MessageId`, optional)
       :annotation: -- [Added in TB 95]
 
       The id of the original message (in case of draft, template, forward or reply). Read-only. Is :value:`null` in all other cases or if the original message was opened from file.

mailTabs.rst

@@ -267,7 +267,7 @@ Selects none, one or multiple messages.
 
    .. api-member::
       :name: ``messageIds``
-      :type: (array of integer)
+      :type: (array of :ref:`messages.MessageId`)
 
       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.
 

messageDisplay.rst

@@ -163,7 +163,7 @@ Opens a message in a new tab or in a new window.
 
       .. api-member::
          :name: [``messageId``]
-         :type: (integer, optional)
+         :type: (:ref:`messages.MessageId`, optional)
 
          The id of a message to be opened. Will throw an *ExtensionError*, if the provided ``messageId`` is unknown or invalid.
 

messages.rst

@@ -98,7 +98,7 @@ Archives messages using the current settings. Archiving external messages will t
 
    .. api-member::
       :name: ``messageIds``
-      :type: (array of integer)
+      :type: (array of :ref:`messages.MessageId`)
 
       The IDs of the messages to archive.
 
@@ -124,7 +124,7 @@ Copies messages to a specified folder.
 
    .. api-member::
       :name: ``messageIds``
-      :type: (array of integer)
+      :type: (array of :ref:`messages.MessageId`)
 
       The IDs of the messages to copy.
 
@@ -163,7 +163,7 @@ Deletes messages permanently, or moves them to the trash folder (honoring the ac
 
    .. api-member::
       :name: ``messageIds``
-      :type: (array of integer)
+      :type: (array of :ref:`messages.MessageId`)
 
       The IDs of the messages to delete.
 
@@ -196,7 +196,7 @@ Returns a specified message.
 
    .. api-member::
       :name: ``messageId``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
 
 .. api-header::
@@ -229,7 +229,7 @@ Returns a specified message, including all headers and MIME parts. Throws if the
 
    .. api-member::
       :name: ``messageId``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
 
 .. api-header::
@@ -262,7 +262,7 @@ Returns the unmodified source of a message. Throws if the message could not be r
 
    .. api-member::
       :name: ``messageId``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
 
    .. api-member::
@@ -402,7 +402,7 @@ Moves messages to a specified folder. If the messages cannot be removed from the
 
    .. api-member::
       :name: ``messageIds``
-      :type: (array of integer)
+      :type: (array of :ref:`messages.MessageId`)
 
       The IDs of the messages to move.
 
@@ -585,7 +585,7 @@ Marks or unmarks a message as junk, read, flagged, or tagged. Updating external
 
    .. api-member::
       :name: ``messageId``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
 
    .. api-member::
@@ -646,7 +646,7 @@ Gets the content of a :ref:`messages.MessageAttachment` as a `File <https://deve
 
    .. api-member::
       :name: ``messageId``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
 
    .. api-member::
@@ -689,7 +689,7 @@ Lists the attachments of a message.
 
    .. api-member::
       :name: ``messageId``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
 
 .. api-header::
@@ -722,7 +722,7 @@ Opens the specified attachment
 
    .. api-member::
       :name: ``messageId``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
 
    .. api-member::
@@ -1194,7 +1194,7 @@ Basic information about a message.
 
    .. api-member::
       :name: ``id``
-      :type: (integer)
+      :type: (:ref:`messages.MessageId`)
 
 
    .. api-member::
@@ -1264,6 +1264,18 @@ Basic information about a message.
       Whether the message has been marked as read. Not available for external or attached messages.
 
 
+.. _messages.MessageId:
+
+MessageId
+---------
+
+.. api-section-annotation-hack:: 
+
+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.
+
+.. api-header::
+   :label: integer
+
 .. _messages.MessageList:
 
 MessageList