Multi Mail

Edit a draft

drafts_update

Destructive

Change a draft in a connected mailbox. A field the call leaves out stays as the draft has it. On Gmail a new subject moves the draft out of its conversation into one of its own; on Outlook the answer names the conversation the draft is kept in. A mailbox whose provider is imap keeps the edited draft under a new id the answer names, and the old id then reads nothing; an old version its server did not remove stays in Drafts, named as previousVersionId. An address the person did not give is found in their past mail - messages_list_all_mailboxes with from: or to: and the name, at the headers view - and is theirs to confirm before anything is written to it. The person's own last letter to someone - the newest found with to: and their address whose sender is an address mailboxes_list names - shows the manner they write to them in.

Input Schema

Name	Required	Description
`cc`	No	Who to copy.
`id`	Yes	The id a draft tool answered, or the draftId a search or a read answered.
`to`	No	Who the message is addressed to.
`bcc`	No	Who to blind-copy. The other recipients are not told.
`body`	No	Your own words. They replace everything the draft says above the message it quotes, a signature there included; that quote stays as written, its formatting and pictures with it, and a draft quoting in HTML stays HTML. Given without html on a draft quoting nothing, the draft becomes plain text.
`html`	No	Your own words as HTML, in place of the draft's own above any quote; given without body, their plain-text version is read from them. An Outlook mailbox keeps only the HTML and writes the plain version from it.
`mailbox`	Yes	The mailbox's name or its email address.
`subject`	No	The subject line.
`chatFiles`	No	Files the person attached in this chat, as the chat itself hands them over - never an address you write: a file anywhere else is refused, and goes in attachments instead. Named, they and attachments together replace the files the draft holds: one it holds stays only where attachments names it again.
`attachments`	No	Files to carry, each held by any connected mailbox, written out or put at an upload address. A file you hold and can send yourself by HTTP PUT, as from a terminal, is named by filename and mimeType alone: the call then writes nothing and answers with an address to put it at, and the same call made again names it by the upload that answer gave it. Any other file is written out, kept small. Named, they replace the ones it holds - never the pictures inside its words - and an empty list removes them all. An Outlook draft takes on the new files before it gives up the old, so a replacement stopped midway is reported and may leave both. An Outlook draft sent while it is rewritten may lose its old files from the sent copy.

Output Schema

Name	Required	Description
`id`	No
`from`	No	The address the draft goes from once sent.
`link`	No
`uploads`	No
`threadId`	No
`signature`	No	Which signature went under your words, or why none did: gmail, Gmail's own for the address it went from; lumman, the one Lumman keeps for an Outlook mailbox or one whose provider is imap; none_set, that address has none - settings_send_as_patch sets one, a Gmail one only where that address is the one the mailbox signs in with; left_out, the call asked for none; already_in_words, your words already carried it; company_adds, the person has said the mailbox's company adds its own on its server.
`unfilledFields`	No	The template fields your words hold unfilled, such as {first_name} or [Name], each as written. A send of the draft refuses one held in its words above any message it quotes until drafts_update puts the words each stands for in its place.
`previousVersionId`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedNov 2, 2026

changedInput schema / properties / attachments / description

Previous value: -"Files to carry, each held by any connected mailbox, written out or put at an upload address. A file you hold and can send yourself by HTTP PUT, as from a terminal, is named by filename and mimeType alone: the call then writes nothing and answers with an address to put it at, and the same call made again names it by the upload that answer gave it. Otherwise write a small file out. Named, they replace the ones it holds - never the pictures inside its words - and an empty list removes them all. An Outlook draft takes on the new files before it gives up the old, so a replacement stopped midway is reported and may leave both. An Outlook draft sent while it is rewritten may lose its old files from the sent copy."New value: +"Files to carry, each held by any connected mailbox, written out or put at an upload address. A file you hold and can send yourself by HTTP PUT, as from a terminal, is named by filename and mimeType alone: the call then writes nothing and answers with an address to put it at, and the same call made again names it by the upload that answer gave it. Any other file is written out, kept small. Named, they replace the ones it holds - never the pictures inside its words - and an empty list removes them all. An Outlook draft takes on the new files before it gives up the old, so a replacement stopped midway is reported and may leave both. An Outlook draft sent while it is rewritten may lose its old files from the sent copy."

changedInput schema / properties / chatFiles / description

Previous value: -"Files the person attached in this chat, as the chat itself hands them over - never an address you write: a file anywhere else is refused, and goes in attachments instead. Named, they and attachments together replace the files the draft holds: restate in attachments any it should keep."New value: +"Files the person attached in this chat, as the chat itself hands them over - never an address you write: a file anywhere else is refused, and goes in attachments instead. Named, they and attachments together replace the files the draft holds: one it holds stays only where attachments names it again."

changedOutput schema / properties / unfilledFields / description

Previous value: -"The template fields your words hold unfilled, such as {first_name} or [Name], each as written. A send of the draft refuses one held in its words above any message it quotes: put the words each stands for in its place with drafts_update first."New value: +"The template fields your words hold unfilled, such as {first_name} or [Name], each as written. A send of the draft refuses one held in its words above any message it quotes until drafts_update puts the words each stands for in its place."

Changed2 schema fields changedOct 30, 2026

changedInput schema / properties / attachments / description

Previous value: -"Files to carry, each held by a connected mailbox of the draft's own provider, written out or put at an upload address. A file you hold and can send yourself by HTTP PUT, as from a terminal, is named by filename and mimeType alone: the call then writes nothing and answers with an address to put it at, and the same call made again names it by the upload that answer gave it. Otherwise write a small file out. Named, they replace the ones it holds - never the pictures inside its words - and an empty list removes them all. An Outlook draft takes on the new files before it gives up the old, so a replacement stopped midway is reported and may leave both. An Outlook draft sent while it is rewritten may lose its old files from the sent copy."New value: +"Files to carry, each held by any connected mailbox, written out or put at an upload address. A file you hold and can send yourself by HTTP PUT, as from a terminal, is named by filename and mimeType alone: the call then writes nothing and answers with an address to put it at, and the same call made again names it by the upload that answer gave it. Otherwise write a small file out. Named, they replace the ones it holds - never the pictures inside its words - and an empty list removes them all. An Outlook draft takes on the new files before it gives up the old, so a replacement stopped midway is reported and may leave both. An Outlook draft sent while it is rewritten may lose its old files from the sent copy."

changedInput schema / properties / attachments / items / anyOf

Previous value: -[
-  {
-    "properties": {
-      "attachmentId": {
-        "description": "An attachment id, as a message read named it.",
-        "maxLength": 2048,
-        "pattern": "^(?:\\d+(?:\\.\\d+)*|[A-Za-z0-9_=-]+)$",
-        "type": "string"
-      },
-      "mailbox": {
-        "description": "The mailbox holding the message the file is in, of the same provider as the one written from.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "messageId": {
-        "description": "The provider's own identifier.",
-        "pattern": "^[A-Za-z0-9_=-]{1,512}$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mailbox",
-      "messageId",
-      "attachmentId"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "content": {
-        "contentEncoding": "base64",
-        "description": "The file's own bytes, base64.",
-        "format": "base64",
-        "pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
-        "type": "string"
-      },
-      "contentId": {
-        "description": "Places a picture inside the words rather than among the files: html shows it where it writes <img src=\"cid:<contentId>\">. One html does not show goes among the files.",
-        "maxLength": 200,
-        "pattern": "^[\\w.+-]+(?:@[\\w.-]+)?$",
-        "type": "string"
-      },
-      "filename": {
-        "description": "What the file is called.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "mimeType": {
-        "description": "The file's media type.",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "filename",
-      "mimeType",
-      "content"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "filename": {
-        "description": "What the file is called.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "mimeType": {
-        "description": "The file's media type.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "upload": {
-        "description": "The upload an earlier call's answer gave this file, once the file is put at its address.",
-        "format": "uuid",
-        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "filename",
-      "mimeType",
-      "upload"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "description": "A file you hold, named alone: the call answers with an address to put it at.",
-    "properties": {
-      "filename": {
-        "description": "What the file is called.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "mimeType": {
-        "description": "The file's media type.",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "filename",
-      "mimeType"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "attachmentId": {
+        "description": "An attachment id, as a message read named it.",
+        "maxLength": 2048,
+        "pattern": "^(?:\\d+(?:\\.\\d+)*|[A-Za-z0-9_=-]+)$",
+        "type": "string"
+      },
+      "mailbox": {
+        "description": "The mailbox holding the message the file is in, whatever its provider.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "messageId": {
+        "description": "The provider's own identifier.",
+        "pattern": "^[A-Za-z0-9_=-]{1,512}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mailbox",
+      "messageId",
+      "attachmentId"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "content": {
+        "contentEncoding": "base64",
+        "description": "The file's own bytes, base64.",
+        "format": "base64",
+        "pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
+        "type": "string"
+      },
+      "contentId": {
+        "description": "Places a picture inside the words rather than among the files: html shows it where it writes <img src=\"cid:<contentId>\">. One html does not show goes among the files.",
+        "maxLength": 200,
+        "pattern": "^[\\w.+-]+(?:@[\\w.-]+)?$",
+        "type": "string"
+      },
+      "filename": {
+        "description": "What the file is called.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mimeType": {
+        "description": "The file's media type.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mimeType",
+      "content"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "filename": {
+        "description": "What the file is called.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mimeType": {
+        "description": "The file's media type.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "upload": {
+        "description": "The upload an earlier call's answer gave this file, once the file is put at its address.",
+        "format": "uuid",
+        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mimeType",
+      "upload"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "A file you hold, named alone: the call answers with an address to put it at.",
+    "properties": {
+      "filename": {
+        "description": "What the file is called.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mimeType": {
+        "description": "The file's media type.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mimeType"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 30, 2026

addedOutput schema / properties / from

Added value: +{
+  "description": "The address the draft goes from once sent.",
+  "type": "string"
+}

Changed1 schema field changedOct 29, 2026

addedOutput schema / properties / unfilledFields

Added value: +{
+  "description": "The template fields your words hold unfilled, such as {first_name} or [Name], each as written. A send of the draft refuses one held in its words above any message it quotes: put the words each stands for in its place with drafts_update first.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Changed4 schema fields changedOct 29, 2026

changedInput schema / properties / attachments / description

Previous value: -"Files to carry, each held by a connected mailbox of the draft's own provider, written out or put at an upload address. A file you hold and can send yourself by HTTP PUT, as from a terminal, is named by filename and mimeType alone: the call then writes nothing and answers with an address to put it at, and the same call made again names it by the upload that answer gave it. Otherwise write a small file out. Named, they replace the ones it holds, and an empty list removes them all. An Outlook draft takes on the new files before it gives up the old, so a replacement stopped midway is reported and may leave both. An Outlook draft sent while it is rewritten may lose its old files from the sent copy."New value: +"Files to carry, each held by a connected mailbox of the draft's own provider, written out or put at an upload address. A file you hold and can send yourself by HTTP PUT, as from a terminal, is named by filename and mimeType alone: the call then writes nothing and answers with an address to put it at, and the same call made again names it by the upload that answer gave it. Otherwise write a small file out. Named, they replace the ones it holds - never the pictures inside its words - and an empty list removes them all. An Outlook draft takes on the new files before it gives up the old, so a replacement stopped midway is reported and may leave both. An Outlook draft sent while it is rewritten may lose its old files from the sent copy."

changedInput schema / properties / attachments / items / anyOf

Previous value: -[
-  {
-    "properties": {
-      "attachmentId": {
-        "description": "An attachment id, as a message read named it.",
-        "maxLength": 2048,
-        "pattern": "^(?:\\d+(?:\\.\\d+)*|[A-Za-z0-9_=-]+)$",
-        "type": "string"
-      },
-      "mailbox": {
-        "description": "The mailbox holding the message the file is in, of the same provider as the one written from.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "messageId": {
-        "description": "The provider's own identifier.",
-        "pattern": "^[A-Za-z0-9_=-]{1,512}$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mailbox",
-      "messageId",
-      "attachmentId"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "content": {
-        "contentEncoding": "base64",
-        "description": "The file's own bytes, base64.",
-        "format": "base64",
-        "pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
-        "type": "string"
-      },
-      "filename": {
-        "description": "What the file is called.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "mimeType": {
-        "description": "The file's media type.",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "filename",
-      "mimeType",
-      "content"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "filename": {
-        "description": "What the file is called.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "mimeType": {
-        "description": "The file's media type.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "upload": {
-        "description": "The upload an earlier call's answer gave this file, once the file is put at its address.",
-        "format": "uuid",
-        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "filename",
-      "mimeType",
-      "upload"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "description": "A file you hold, named alone: the call answers with an address to put it at.",
-    "properties": {
-      "filename": {
-        "description": "What the file is called.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "mimeType": {
-        "description": "The file's media type.",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "filename",
-      "mimeType"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "attachmentId": {
+        "description": "An attachment id, as a message read named it.",
+        "maxLength": 2048,
+        "pattern": "^(?:\\d+(?:\\.\\d+)*|[A-Za-z0-9_=-]+)$",
+        "type": "string"
+      },
+      "mailbox": {
+        "description": "The mailbox holding the message the file is in, of the same provider as the one written from.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "messageId": {
+        "description": "The provider's own identifier.",
+        "pattern": "^[A-Za-z0-9_=-]{1,512}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mailbox",
+      "messageId",
+      "attachmentId"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "content": {
+        "contentEncoding": "base64",
+        "description": "The file's own bytes, base64.",
+        "format": "base64",
+        "pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
+        "type": "string"
+      },
+      "contentId": {
+        "description": "Places a picture inside the words rather than among the files: html shows it where it writes <img src=\"cid:<contentId>\">. One html does not show goes among the files.",
+        "maxLength": 200,
+        "pattern": "^[\\w.+-]+(?:@[\\w.-]+)?$",
+        "type": "string"
+      },
+      "filename": {
+        "description": "What the file is called.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mimeType": {
+        "description": "The file's media type.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mimeType",
+      "content"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "filename": {
+        "description": "What the file is called.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mimeType": {
+        "description": "The file's media type.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "upload": {
+        "description": "The upload an earlier call's answer gave this file, once the file is put at its address.",
+        "format": "uuid",
+        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mimeType",
+      "upload"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "A file you hold, named alone: the call answers with an address to put it at.",
+    "properties": {
+      "filename": {
+        "description": "What the file is called.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mimeType": {
+        "description": "The file's media type.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mimeType"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / properties / body / description

Previous value: -"The whole message text, a reply's quote included. Given without html, the draft becomes plain text."New value: +"Your own words. They replace everything the draft says above the message it quotes, a signature there included; that quote stays as written, its formatting and pictures with it, and a draft quoting in HTML stays HTML. Given without html on a draft quoting nothing, the draft becomes plain text."

changedInput schema / properties / html / description

Previous value: -"The whole message as HTML, for formatting; given without body, its plain-text version is read from it. An Outlook mailbox keeps only the HTML and writes the plain version from it."New value: +"Your own words as HTML, in place of the draft's own above any quote; given without body, their plain-text version is read from them. An Outlook mailbox keeps only the HTML and writes the plain version from it."

Changed2 schema fields changedOct 25, 2026

changedOutput schema / properties / signature / description

Previous value: -"Which signature went under your words, or why none did: gmail, Gmail's own for the address it went from; lumman, the one Lumman keeps for an Outlook mailbox or one whose provider is imap; none_set, that address has none - settings_send_as_patch sets one, a Gmail one only where that address is the one the mailbox signs in with; left_out, the call asked for none; already_in_words, your words already carried it."New value: +"Which signature went under your words, or why none did: gmail, Gmail's own for the address it went from; lumman, the one Lumman keeps for an Outlook mailbox or one whose provider is imap; none_set, that address has none - settings_send_as_patch sets one, a Gmail one only where that address is the one the mailbox signs in with; left_out, the call asked for none; already_in_words, your words already carried it; company_adds, the person has said the mailbox's company adds its own on its server."

changedOutput schema / properties / signature / enum

Previous value: -[
-  "gmail",
-  "lumman",
-  "none_set",
-  "left_out",
-  "already_in_words"
-]New value: +[
+  "gmail",
+  "lumman",
+  "none_set",
+  "left_out",
+  "already_in_words",
+  "company_adds"
+]

Changed2 schema fields changedOct 25, 2026

changedOutput schema / properties / signature / description

Previous value: -"Which signature went under your words, or why none did: gmail, Gmail's own for the address it went from; none_set, that address has none - settings_send_as_patch sets a Gmail one where that address is the one the mailbox signs in with, and an Outlook mailbox, or one whose provider is imap, has none here; left_out, the call asked for none; already_in_words, your words already carried it."New value: +"Which signature went under your words, or why none did: gmail, Gmail's own for the address it went from; lumman, the one Lumman keeps for an Outlook mailbox or one whose provider is imap; none_set, that address has none - settings_send_as_patch sets one, a Gmail one only where that address is the one the mailbox signs in with; left_out, the call asked for none; already_in_words, your words already carried it."

changedOutput schema / properties / signature / enum

Previous value: -[
-  "gmail",
-  "none_set",
-  "left_out",
-  "already_in_words"
-]New value: +[
+  "gmail",
+  "lumman",
+  "none_set",
+  "left_out",
+  "already_in_words"
+]

Changed1 schema field changedOct 25, 2026

addedOutput schema / properties / signature

Added value: +{
+  "description": "Which signature went under your words, or why none did: gmail, Gmail's own for the address it went from; none_set, that address has none - settings_send_as_patch sets a Gmail one where that address is the one the mailbox signs in with, and an Outlook mailbox, or one whose provider is imap, has none here; left_out, the call asked for none; already_in_words, your words already carried it.",
+  "enum": [
+    "gmail",
+    "none_set",
+    "left_out",
+    "already_in_words"
+  ],
+  "type": "string"
+}

Changed3 schema fields changedOct 25, 2026

changedInput schema / properties / bcc / items / pattern

Previous value: -"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[\\w!#$%&'*+/=?^\\x60{|}~-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+(?:\\.(?:[\\w!#$%&'*+/=?^\\x60{|}~-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+)*@(?:(?:(?:[A-Za-z0-9-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+\\.)+(?:[A-Za-z0-9-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+|\\[(?:\\d{1,3}(?:\\.\\d{1,3}){3}|IPv6:[\\dA-Fa-f:.]+)\\])$"

changedInput schema / properties / cc / items / pattern

Previous value: -"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[\\w!#$%&'*+/=?^\\x60{|}~-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+(?:\\.(?:[\\w!#$%&'*+/=?^\\x60{|}~-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+)*@(?:(?:(?:[A-Za-z0-9-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+\\.)+(?:[A-Za-z0-9-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+|\\[(?:\\d{1,3}(?:\\.\\d{1,3}){3}|IPv6:[\\dA-Fa-f:.]+)\\])$"

changedInput schema / properties / to / items / pattern

Previous value: -"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[\\w!#$%&'*+/=?^\\x60{|}~-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+(?:\\.(?:[\\w!#$%&'*+/=?^\\x60{|}~-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+)*@(?:(?:(?:[A-Za-z0-9-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+\\.)+(?:[A-Za-z0-9-]|[¡-ᙿᚁ-῿-‧‪-‮‰-⁞⁠-⿿、-﻾＀-])+|\\[(?:\\d{1,3}(?:\\.\\d{1,3}){3}|IPv6:[\\dA-Fa-f:.]+)\\])$"

Changed1 schema field changedOct 19, 2026

addedInput schema / properties / chatFiles

Added value: +{
+  "description": "Files the person attached in this chat, as the chat itself hands them over - never an address you write: a file anywhere else is refused, and goes in attachments instead. Named, they and attachments together replace the files the draft holds: restate in attachments any it should keep.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "download_url": {
+        "type": "string"
+      },
+      "file_id": {
+        "type": "string"
+      },
+      "file_name": {
+        "type": "string"
+      },
+      "mime_type": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "download_url",
+      "file_id"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Changed4 schema fields changedOct 19, 2026

changedInput schema / properties / attachments / description

Previous value: -"Files to carry, each held by a connected mailbox of the draft's own provider or written out. Named, they replace the ones it holds, and an empty list removes them all. An Outlook draft takes on the new files before it gives up the old, so a replacement stopped midway is reported and may leave both. An Outlook draft sent while it is rewritten may lose its old files from the sent copy."New value: +"Files to carry, each held by a connected mailbox of the draft's own provider, written out or put at an upload address. A file you hold and can send yourself by HTTP PUT, as from a terminal, is named by filename and mimeType alone: the call then writes nothing and answers with an address to put it at, and the same call made again names it by the upload that answer gave it. Otherwise write a small file out. Named, they replace the ones it holds, and an empty list removes them all. An Outlook draft takes on the new files before it gives up the old, so a replacement stopped midway is reported and may leave both. An Outlook draft sent while it is rewritten may lose its old files from the sent copy."

changedInput schema / properties / attachments / items / anyOf

Previous value: -[
-  {
-    "properties": {
-      "attachmentId": {
-        "description": "An attachment id, as a message read named it.",
-        "maxLength": 2048,
-        "pattern": "^(?:\\d+(?:\\.\\d+)*|[A-Za-z0-9_=-]+)$",
-        "type": "string"
-      },
-      "mailbox": {
-        "description": "The mailbox holding the message the file is in, of the same provider as the one written from.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "messageId": {
-        "description": "The provider's own identifier.",
-        "pattern": "^[A-Za-z0-9_=-]{1,512}$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mailbox",
-      "messageId",
-      "attachmentId"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "content": {
-        "contentEncoding": "base64",
-        "description": "The file's own bytes, base64.",
-        "format": "base64",
-        "pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
-        "type": "string"
-      },
-      "filename": {
-        "description": "What the file is called.",
-        "minLength": 1,
-        "type": "string"
-      },
-      "mimeType": {
-        "description": "The file's media type.",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "filename",
-      "mimeType",
-      "content"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "attachmentId": {
+        "description": "An attachment id, as a message read named it.",
+        "maxLength": 2048,
+        "pattern": "^(?:\\d+(?:\\.\\d+)*|[A-Za-z0-9_=-]+)$",
+        "type": "string"
+      },
+      "mailbox": {
+        "description": "The mailbox holding the message the file is in, of the same provider as the one written from.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "messageId": {
+        "description": "The provider's own identifier.",
+        "pattern": "^[A-Za-z0-9_=-]{1,512}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mailbox",
+      "messageId",
+      "attachmentId"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "content": {
+        "contentEncoding": "base64",
+        "description": "The file's own bytes, base64.",
+        "format": "base64",
+        "pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
+        "type": "string"
+      },
+      "filename": {
+        "description": "What the file is called.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mimeType": {
+        "description": "The file's media type.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mimeType",
+      "content"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "filename": {
+        "description": "What the file is called.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mimeType": {
+        "description": "The file's media type.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "upload": {
+        "description": "The upload an earlier call's answer gave this file, once the file is put at its address.",
+        "format": "uuid",
+        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mimeType",
+      "upload"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "A file you hold, named alone: the call answers with an address to put it at.",
+    "properties": {
+      "filename": {
+        "description": "What the file is called.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mimeType": {
+        "description": "The file's media type.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mimeType"
+    ],
+    "type": "object"
+  }
+]

addedOutput schema / properties / uploads

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "address": {
+        "type": "string"
+      },
+      "filename": {
+        "type": "string"
+      },
+      "upload": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "upload",
+      "address"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

removedOutput schema / required
```
Removed value: -[
-  "id"
-]
```

Changed2 schema fields changedOct 9, 2026
- addedOutput schema / properties / previousVersionId
```
Added value: +{
+  "type": "string"
+}
```
- changedOutput schema / required
```
Previous value: -[
-  "id",
-  "link"
-]New value: +[
+  "id"
+]
```

Changed2 schema fields changedOct 8, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Changed3 schema fields changedOct 6, 2026

changedInput schema / properties / bcc / items / pattern

Previous value: -"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"

changedInput schema / properties / cc / items / pattern

Previous value: -"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"

changedInput schema / properties / to / items / pattern

Previous value: -"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"

First observedOct 5, 2026

TDQS

A3.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds substantial behavior beyond the annotations: omitted fields are preserved, Gmail and Outlook handle subject/conversation changes differently, imap drafts move to a new id, the old id stops resolving, and a previous version may remain as previousVersionId. It also discloses attachment replacement semantics and Outlook-specific caveats, which is rich transparency for a destructive mutation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded in the first sentence, but the description is a dense, meandering paragraph with archaic phrasing and many semicolon-linked caveats. Most content is relevant to a complex mutation, but the structure makes it harder to parse than necessary.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 10 parameters, full schema coverage, annotations covering destructive behavior, and an output schema, the description is largely complete about side effects and provider-specific outcomes. It could be stronger with explicit routing to sibling draft tools and clearer permission expectations, but the behavioral picture is sufficiently detailed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is already 100%, so the baseline is 3. The description still adds useful parameter meaning, especially that a new subject can move a Gmail draft to its own conversation and that omitted fields retain their existing values, going beyond the schema's short field descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action: changing an existing draft in a connected mailbox. It distinguishes the operation from creating or sending a draft through the word 'Change' and the resource 'draft', but it does not explicitly differentiate from sibling tools such as drafts_create or drafts_send.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by 'Change a draft' and by details such as omitted fields staying unchanged, but the description never explicitly says when to use this tool instead of drafts_create, drafts_send, drafts_reply, or drafts_delete. It gives some procedural guidance around confirming an unlisted address, but no clear exclusions or alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Multi Mail tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Edit a draft

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources