todo_complete_task

Rappels et Microsoft To Do · 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

Marque une tâche Microsoft To Do comme terminée. Fonctionne via Apple Reminders, qui se synchronise avec To Do lorsque le compte Microsoft est ajouté à Reminders ; la modification apparaît donc dans To Do après la prochaine synchronisation. Privilégiez task_id issu de todo_list_tasks. Avec `title` à la place, il termine l'unique tâche ouverte dont le titre contient ce texte (sans tenir compte de la casse) ; si plusieurs correspondent, il n'en termine AUCUNE et les liste avec leur task_id. Sans `list`, il cherche dans toutes les listes Reminders, pas seulement celles de To Do. Appelé sans confirm, il renvoie un aperçu ; passez confirm=true pour terminer la tâche.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

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": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "List name to narrow search by title (optional)",
      "type": "string"
    },
    "task_id": {
      "description": "Task ID from todo_list_tasks",
      "type": "string"
    },
    "title": {
      "description": "Task title (partial match, alternative to task_id)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour todo_complete_task. 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,
  "title": "Planning meeting"
}

Windows

Objectif

Marque une tâche comme terminée dans Microsoft To Do/Tâches Outlook, via l'application de bureau Outlook ; Windows uniquement. Sans confirm=true, rien ne change : l'appel renvoie un aperçu qui reprend l'objet et la liste et ne recherche pas la tâche, donc il n'indique pas si la tâche existe. Avec confirm=true, il cherche la tâche dont l'objet est égal à `subject` (pas de correspondance partielle, pas d'ID de tâche) et la marque comme terminée à 100 %. Sans `list`, il ne cherche que dans le dossier racine Tâches, pas dans ses sous-dossiers ; avec `list`, un nom ou chemin complet issu de todo_list_tasks, il ne cherche que là, et une liste inconnue ou correspondant à plusieurs dossiers est refusée avec une erreur. Lorsque plusieurs tâches OUVERTES de ce dossier partagent l'objet, aucune n'est terminée : l'appel échoue et liste les candidates, chacune avec un task_id ; rappelez avec ce task_id pour en terminer une. Une tâche introuvable renvoie 'not found', et une réponse d'Outlook qui ne confirme pas la modification est une erreur, jamais un succès. La tâche n'est pas supprimée ; ce serveur n'a aucun outil pour la rouvrir.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

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 — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "Task list or folder to complete the task in, by name or full path as reported by todo_list_tasks (default: only the root Tasks folder). Disambiguates when the same subject exists in more than one list. The name the cloud catalog (Mac) advertises.",
      "type": "string"
    },
    "subject": {
      "description": "Task subject (exact match)",
      "type": "string"
    },
    "task_id": {
      "description": "A task_id listed by this tool when several open tasks share the subject. Completes exactly that task; subject and list are not needed.",
      "type": "string"
    },
    "title": {
      "description": "Alias for `subject` — the name the cloud catalog (Mac) advertises. Exact match here, unlike the Mac tool's partial match.",
      "type": "string"
    }
  },
  "type": "object"
}

Exemple documentaire

{
  "confirm": false,
  "title": "Planning meeting"
}