m365_move_email

Microsoft 365 · macOS · Windows

Effect: schrijven. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Gebruik dit wanneer de gebruiker e-mails van zijn Microsoft 365 / Outlook-account naar een andere map op de Exchange-server wil verplaatsen, om ze te archiveren, op te bergen of te ordenen. Noem de berichten met message_id (één) of message_ids (maximaal 50), uit m365_list_emails, m365_search_emails of m365_read_email; of een heel gesprek met conversation_id (uit m365_list_emails of m365_search_emails): dan verplaatsen alleen de berichten ervan in source_folder (standaard inbox), nooit de kopieën in Verzonden items, Concepten of andere mappen, tenzij all_folders=true. destination is een map-id, naam of pad uit m365_list_email_folders, of inbox, archive, deleteditems, junkemail. Toont eerst een voorbeeld — stel confirm=true in om te verplaatsen. Een bericht telt pas als verplaatst wanneer een tweede lezing het in de bestemming toont en niet meer onder zijn oude id; een verplaatst bericht krijgt een nieuwe id (new_id). Vereist de Microsoft 365-machtiging Mail.ReadWrite: een account dat is gekoppeld voordat erom werd gevraagd, antwoordt consent_required totdat het opnieuw is gekoppeld. Gebruik move_email voor mail in de Mail-app van de Mac.

Vereiste invoer

destination

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.

Canoniek technisch schema in het Engels — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "all_folders": {
      "description": "With conversation_id: true moves its messages from every folder, Sent Items and Drafts included (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Set to true to move (default: shows a preview only).",
      "type": "boolean"
    },
    "conversation_id": {
      "description": "Move the messages of this conversation that are in source_folder.",
      "type": "string"
    },
    "destination": {
      "description": "The folder to move them to: an id, name or path from m365_list_email_folders, or inbox, archive, deleteditems, junkemail.",
      "type": "string"
    },
    "message_id": {
      "description": "The ID of one message to move.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 50 messages to move.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source_folder": {
      "description": "With conversation_id: the folder its messages are moved from (default inbox). An id, name or path.",
      "type": "string"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor m365_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,
  "destination": "archive",
  "message_id": "demo-message-001"
}

Windows