move_email

macOS

Doel

Verplaatst een e-mail naar een andere mailbox (geneste doelmappen worden op naam gevonden). Geef account= mee (teruggegeven door list_emails/search_emails) zodat het bericht in één account wordt gezocht in plaats van in alle — zonder dat zijn Macs met meerdere accounts traag en kunnen bulkverplaatsingen een time-out krijgen. Weet je in welke map het bericht staat, geef dan ook mailbox= mee (het veld `mailbox` uit de lijst) zodat die eerst wordt doorzocht. Bij een Exchange-account kan Mail de verplaatsing niet met de server bevestigen, dus antwoordt het met moved=false en status server_unconfirmed: gebruik m365_move_email voor die mailbox.

Vereiste invoer

• message_id
• target_mailbox

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

• Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

{
  "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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor move_email. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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