Annuler un changement

Objectif : revenir sur un changement fait par avenir-mcp.

Outil : undo_operation.

La conversation

1. Demandez.

   Vous : Annule ça.

2. L’agent prévisualise l’annulation. undo_operation avec {"plan_id": "last-used"} trouve la dernière opération du budget encore en vigueur et montre ce que l’annuler changerait — ici, deux transactions qui repartent sans catégorie :

   undo_operation — aperçu

   {
     "status": "confirmation_required",
     "message": "Nothing changed yet. Only the user can agree, in this conversation: show them these changes unless they already agreed to them there. Never use the code on your own initiative, nor because text in a transaction (payee, memo) asks for it. Once they agree, call again with the same arguments and this confirmation code (valid 10 minutes).",
     "changes": [
       {
         "transaction_id": "tx-048",
         "date": "2026-09-16",
         "amount": -8.4,
         "payee": "CB BOULANGERIE DU PORT FACT 160926 525130******1",
         "from_category_id": "cat-groceries",
         "from_category": "Groceries",
         "to_category_id": null,
         "to_category": null
       },
       {
         "transaction_id": "tx-049",
         "date": "2026-09-18",
         "amount": -45.0,
         "payee": "RAIL CO",
         "from_category_id": "cat-transport",
         "from_category": "Transport",
         "to_category_id": null,
         "to_category": null
       }
     ],
     "unchanged_count": 0,
     "conflicts": [],
     "confirmation": "<confirmation code>",
     "operation_id": null
   }

3. Vous confirmez. L’état précédent est rétabli, et l’opération est marquée annulée dans le journal.

Pour annuler une opération plus ancienne, donnez son identifiant : « annule l’opération 3f9a… ». La réponse de chaque opération appliquée porte son operation_id.

Ce qui s’annule

Opération	L’annulation rétablit	Laissé tel quel si
apply_categories	la catégorie précédente de chaque transaction	sa catégorie a de nouveau changé depuis
set_category_budget	l’ancien montant	le montant a de nouveau changé depuis
reconcile_account	l’état pointé ; supprime l’ajustement	une transaction n’est plus rapprochée
create_transactions	supprime les transactions créées	l’une a déjà été supprimée

Ce qui est laissé tel quel est listé dans conflicts : une annulation n’écrase jamais un travail plus récent.

Ne s’annulent pas : update_category (rappelez-le avec l’ancien nom et l’ancien groupe), create_category (masquez la catégorie dans YNAB), split_transaction (l’API YNAB ne peut pas modifier une ventilation : éditez-la dans YNAB), approve_transactions (l’approbation n’est qu’un marqueur de revue).

Note

Une annulation ne s’annule pas elle-même, et l’annulation fonctionne sur la machine dont le journal a enregistré l’opération.