create_email_folder
E-mail · macOS
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
Crée un dossier de messagerie dans Apple Mail (Mail.app) du Mac, dans un compte. Si Mail a plus d’un compte, `account` est obligatoire : l’outil refuse de deviner où va le dossier (list_email_accounts donne les noms). Si un dossier de ce nom existe déjà, il ne crée rien et le signale. Ne signale created qu’après avoir vu le dossier dans la liste des dossiers du compte ; sur un compte Exchange, où Mail ne peut pas confirmer le dossier auprès du serveur, il répond created=false avec le statut server_unconfirmed : utilisez m365_create_email_folder pour cette boîte aux lettres. Appelé sans confirm, il renvoie un aperçu ; passez confirm=true pour créer.
Entrées requises
name
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": "Account name (optional, uses default)",
"type": "string"
},
"confirm": {
"description": "Must be true to create",
"type": "boolean"
},
"name": {
"description": "Folder name",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}Exemple documentaire
Exemple de documentation pour create_email_folder. 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,
"name": "Planning meeting"
}