m365_move_email

Microsoft 365 · macOS · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

À utiliser lorsque l’utilisateur veut déplacer des e-mails de son compte Microsoft 365 / Outlook vers un autre dossier du serveur Exchange, pour les classer, les archiver ou les organiser. Désignez les messages avec message_id (un) ou message_ids (jusqu’à 50), issus de m365_list_emails, m365_search_emails ou m365_read_email ; ou toute une conversation avec conversation_id (issu de m365_list_emails ou m365_search_emails) : seuls ses messages dans source_folder (inbox par défaut) sont alors déplacés, jamais ses copies dans Éléments envoyés, Brouillons ou d’autres dossiers, sauf si all_folders=true. destination est un id, un nom ou un chemin de dossier issu de m365_list_email_folders, ou inbox, archive, deleteditems, junkemail. Affiche d’abord un aperçu — définissez confirm=true pour déplacer. Un message est considéré comme déplacé seulement lorsqu’une seconde lecture le montre dans la destination et plus sous son ancien id ; un message déplacé reçoit un nouvel id (new_id). Nécessite l’autorisation Microsoft 365 Mail.ReadWrite : un compte connecté avant qu’elle soit demandée répond consent_required jusqu’à sa reconnexion. Pour le courrier de l’app Mail du Mac, utilisez move_email.

Entrées requises

destination

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour m365_move_email. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "confirm": false,
  "destination": "archive",
  "message_id": "demo-message-001"
}

Windows