copy_email

macOS

Objectif

Copie un e-mail dans une autre boîte aux lettres d’Apple Mail (Mail.app) du Mac ; l’original reste en place. Nécessite confirm=true. copied vaut true seulement lorsque la boîte cible affiche une copie de plus du message ; sinon la réponse indique que ce n’est pas confirmé. Pour copier dans une boîte d’UN AUTRE compte, omettez account (avec account=, la cible est cherchée uniquement dans ce compte) et utilisez un nom de dossier que seul ce compte possède. Une cible inexistante est refusée, avec la liste des boîtes aux lettres qui ont été vues.

Entrées requises

• message_id
• target_mailbox

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.

{
  "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 copy the message. Defaults to false.",
      "type": "boolean"
    },
    "mailbox": {
      "description": "Folder the message is in. 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"
}

Exemple documentaire

Exemple de documentation pour copy_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.

{
  "account": "Demo iCloud",
  "confirm": false,
  "mailbox": "INBOX",
  "message_id": "demo-message-001",
  "target_mailbox": "Projects"
}