move_email

macOS

Zweck

Verschiebt eine E-Mail in ein anderes Postfach (verschachtelte Zielordner werden über den Namen gefunden). Übergeben Sie account= (aus list_emails/search_emails), damit die Nachrichtensuche ein Konto statt alle durchsucht – ohne dies sind Macs mit mehreren Konten langsam und können bei Massenverschiebungen in eine Zeitüberschreitung laufen. Wenn Sie den Ordner der Nachricht kennen, übergeben Sie zusätzlich mailbox= (das Feld `mailbox` aus der Auflistung), damit die Suche ihn zuerst durchsucht. Bei einem Exchange-Konto kann Mail die Verschiebung nicht mit dem Server bestätigen und antwortet mit moved=false und dem Status server_unconfirmed: Verwenden Sie für dieses Postfach m365_move_email.

Erforderliche Eingaben

• message_id
• target_mailbox

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "properties": {
    "account": {
      "description": "Mail.app account the message lives in (returned alongside the id). Pass it so the message is found in the right account.",
      "type": "string"
    },
    "confirm": {
      "default": "false",
      "description": "Set to true to actually move the message. Defaults to false.",
      "type": "boolean"
    },
    "mailbox": {
      "description": "Folder the message is in TODAY, before the move. Passing it skips searching the other folders.",
      "type": "string"
    },
    "message_id": {
      "description": "The message id returned by list_emails or search_emails. Accepts the bare id or the <angle-bracketed> form.",
      "type": "string"
    },
    "target_mailbox": {
      "description": "Destination folder, by name (see list_email_folders). Nested folders are found by their own name, not by a path.",
      "type": "string"
    }
  },
  "required": [
    "message_id",
    "target_mailbox"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für move_email. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "confirm": false,
  "message_id": "demo-message-001",
  "target_mailbox": "Archive"
}