ynab-mcpb

by dizzlkheinz

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

ynab_update_transactions

Idempotent

Update up to 100 YNAB transactions in one batch, with a dry-run preview to validate changes before applying them.

Instructions

Update 1–100 transactions in a single batch with dry-run preview.

Args:

budget_id (string, optional): Budget UUID. Omit to use the default budget.
transactions (array, required): Up to 100 objects, each requires id plus fields to update. Amount updates use one of amount_decimal (preferred), amount_milliunits, or deprecated amount. A non-split transaction can be converted to a split by supplying the parent amount plus subtransactions that sum to it; YNAB does not support replacing lines on an existing split.
dry_run (boolean, optional): Preview changes without saving. Default: false.

Returns: summary (updated, failed), results[], transactions[].

Examples:

Dry run: set dry_run=true to preview before/after for first 10 items

Write safety: call without confirmation_token to preview. The preview returns confirmation_token and confirmation_expires_at in its structured output (and in its text). Execute the identical validated request with that short-lived confirmation_token.

Input Schema

Name	Required	Description
`dry_run`	No
`budget_id`	No
`transactions`	Yes
`confirmation_token`	No	Short-lived, single-use token returned by the immediately preceding preview of this exact validated request. Omit, or pass null or an empty string, to preview.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv0.32.0Nov 7, 2026

changedOutput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "ynab_update_transactions",
-        "type": "string"
-      },
-      "dry_run": {
-        "const": true,
-        "type": "boolean"
-      },
-      "note": {
-        "type": "string"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "accounts_affected": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "fields_to_update": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "total_transactions": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total_transactions",
-          "accounts_affected",
-          "fields_to_update"
-        ],
-        "type": "object"
-      },
-      "transactions_preview": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "after": {
-              "additionalProperties": false,
-              "properties": {
-                "amount": {
-                  "description": "Amount in decimal currency units",
-                  "type": "number"
-                },
-                "amount_milliunits": {
-                  "maximum": 9007199254740991,
-                  "minimum": -9007199254740991,
-                  "type": "integer"
-                },
-                "approved": {
-                  "type": "boolean"
-                },
-                "category_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "cleared": {
-                  "enum": [
-                    "cleared",
-                    "uncleared",
-                    "reconciled"
-                  ],
-                  "type": "string"
-                },
-                "date": {
-                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                  "type": "string"
-                },
-                "flag_color": {
-                  "anyOf": [
-                    {
-                      "enum": [
-                        "red",
-                        "orange",
-                        "yellow",
-                        "green",
-                        "blue",
-                        "purple"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "memo": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "payee_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "payee_name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "subtransactions": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "amount": {
-                        "description": "Amount in decimal currency units",
-                        "type": "number"
-                      },
-                      "amount_currency": {
-                        "type": "number"
-                      },
-                      "amount_formatted": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "amount_milliunits": {
-                        "maximum": 9007199254740991,
-                        "minimum": -9007199254740991,
-                        "type": "integer"
-                      },
-                      "category_id": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "category_name": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "deleted": {
-                        "type": "boolean"
-                      },
-                      "id": {
-                        "type": "string"
-                      },
-                      "memo": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "payee_id": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "payee_name": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "scheduled_transaction_id": {
-                        "type": "string"
-                      },
-                      "transaction_id": {
-                        "type": "string"
-                      },
-                      "transfer_account_id": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "transfer_transaction_id": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "amount"
-                    ],
-                    "type": "object"
-                  },
-                  "type": "array"
-                }
-              },
-              "type": "object"
-            },
-            "before": {
-              "anyOf": [
-                {
-                  "const": "unavailable",
-                  "type": "string"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "amount": {
-                      "description": "Amount in decimal currency units",
-                      "type": "number"
-                    },
-                    "amount_milliunits": {
-                      "maximum": 9007199254740991,
-                      "minimum": -9007199254740991,
-                      "type": "integer"
-                    },
-                    "approved": {
-                      "type": "boolean"
-                    },
-                    "category_id": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "cleared": {
-                      "enum": [
-                        "cleared",
-                        "uncleared",
-                        "reconciled"
-                      ],
-                      "type": "string"
-                    },
-                    "date": {
-                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                      "type": "string"
-                    },
-                    "flag_color": {
-                      "anyOf": [
-                        {
-                          "enum": [
-                            "red",
-                            "orange",
-                            "yellow",
-                            "green",
-                            "blue",
-                            "purple"
-                          ],
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "memo": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "payee_id": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "payee_name": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "subtransactions": {
-                      "items": {
-                        "additionalProperties": false,
-                        "properties": {
-                          "amount": {
-                            "description": "Amount in decimal currency units",
-                            "type": "number"
-                          },
-                          "amount_currency": {
-                            "type": "number"
-                          },
-                          "amount_formatted": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "amount_milliunits": {
-                            "maximum": 9007199254740991,
-                            "minimum": -9007199254740991,
-                            "type": "integer"
-                          },
-                          "category_id": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "category_name": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "deleted": {
-                            "type": "boolean"
-                          },
-                          "id": {
-                            "type": "string"
-                          },
-                          "memo": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "payee_id": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "payee_name": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "scheduled_transaction_id": {
-                            "type": "string"
-                          },
-                          "transaction_id": {
-                            "type": "string"
-                          },
-                          "transfer_account_id": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "transfer_transaction_id": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "amount"
-                        ],
-                        "type": "object"
-                      },
-                      "type": "array"
-                    }
-                  },
-                  "type": "object"
-                }
-              ]
-            },
-            "transaction_id": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "transaction_id",
-            "before",
-            "after"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "validation": {
-        "const": "passed",
-        "type": "string"
-      },
-      "warnings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "count": {
-              "type": "number"
-            },
-            "message": {
-              "type": "string"
-            },
-            "sample_ids": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            }
-          },
-          "required": [
-            "code",
-            "count",
-            "message"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "dry_run",
-      "action",
-      "validation",
-      "summary",
-      "transactions_preview",
-      "note"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": {},
-    "properties": {
-      "message": {
-        "type": "string"
-      },
-      "mode": {
-        "enum": [
-          "full",
-          "summary",
-          "ids_only"
-        ],
-        "type": "string"
-      },
-      "results": {
-        "items": {
-          "additionalProperties": {},
-          "properties": {
-            "correlation_key": {
-              "type": "string"
-            },
-            "error": {
-              "type": "string"
-            },
-            "error_code": {
-              "type": "string"
-            },
-            "request_index": {
-              "type": "number"
-            },
-            "status": {
-              "enum": [
-                "created",
-                "duplicate",
-                "updated",
-                "failed"
-              ],
-              "type": "string"
-            },
-            "transaction_id": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "request_index",
-            "status",
-            "correlation_key"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "results_omitted": {
-        "type": "boolean"
-      },
-      "server_knowledge": {
-        "type": "number"
-      },
-      "success": {
-        "type": "boolean"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "created": {
-            "type": "number"
-          },
-          "duplicates": {
-            "type": "number"
-          },
-          "failed": {
-            "type": "number"
-          },
-          "total_requested": {
-            "type": "number"
-          },
-          "updated": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total_requested",
-          "failed"
-        ],
-        "type": "object"
-      },
-      "transactions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "account_id": {
-              "type": "string"
-            },
-            "account_name": {
-              "type": "string"
-            },
-            "amount": {
-              "description": "Amount in decimal currency units",
-              "type": "number"
-            },
-            "amount_currency": {
-              "type": "number"
-            },
-            "amount_formatted": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "amount_milliunits": {
-              "maximum": 9007199254740991,
-              "minimum": -9007199254740991,
-              "type": "integer"
-            },
-            "approved": {
-              "type": "boolean"
-            },
-            "category_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "category_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "cleared": {
-              "type": "string"
-            },
-            "date": {
-              "type": "string"
-            },
-            "debt_transaction_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "deleted": {
-              "type": "boolean"
-            },
-            "flag_color": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "flag_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "id": {
-              "type": "string"
-            },
-            "import_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "import_payee_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "import_payee_name_original": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "matched_transaction_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "memo": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "parent_transaction_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "payee_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "payee_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "scheduled_transaction_id": {
-              "type": "string"
-            },
-            "subtransactions": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "amount": {
-                    "description": "Amount in decimal currency units",
-                    "type": "number"
-                  },
-                  "amount_currency": {
-                    "type": "number"
-                  },
-                  "amount_formatted": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "amount_milliunits": {
-                    "maximum": 9007199254740991,
-                    "minimum": -9007199254740991,
-                    "type": "integer"
-                  },
-                  "category_id": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "category_name": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "deleted": {
-                    "type": "boolean"
-                  },
-                  "id": {
-                    "type": "string"
-                  },
-                  "memo": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "payee_id": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "payee_name": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "scheduled_transaction_id": {
-                    "type": "string"
-                  },
-                  "transaction_id": {
-                    "type": "string"
-                  },
-                  "transfer_account_id": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "transfer_transaction_id": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  }
-                },
-                "required": [
-                  "amount"
-                ],
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "transaction_id": {
-              "type": "string"
-            },
-            "transfer_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "transfer_transaction_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "type": {
-              "enum": [
-                "transaction",
-                "subtransaction"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "amount",
-            "deleted",
-            "date",
-            "account_id",
-            "cleared",
-            "approved"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "success",
-      "summary",
-      "results"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "ynab_update_transactions",
+        "type": "string"
+      },
+      "confirmation_expires_at": {
+        "description": "Preview only: when confirmation_token expires (ISO 8601).",
+        "format": "date-time",
+        "type": "string"
+      },
+      "confirmation_token": {
+        "description": "Preview only: single-use token that executes this exact request when passed back as confirmation_token.",
+        "type": "string"
+      },
+      "dry_run": {
+        "const": true,
+        "type": "boolean"
+      },
+      "note": {
+        "type": "string"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "accounts_affected": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "fields_to_update": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "total_transactions": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total_transactions",
+          "accounts_affected",
+          "fields_to_update"
+        ],
+        "type": "object"
+      },
+      "transactions_preview": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "after": {
+              "additionalProperties": false,
+              "properties": {
+                "amount": {
+                  "description": "Amount in decimal currency units",
+                  "type": "number"
+                },
+                "amount_milliunits": {
+                  "maximum": 9007199254740991,
+                  "minimum": -9007199254740991,
+                  "type": "integer"
+                },
+                "approved": {
+                  "type": "boolean"
+                },
+                "category_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "cleared": {
+                  "enum": [
+                    "cleared",
+                    "uncleared",
+                    "reconciled"
+                  ],
+                  "type": "string"
+                },
+                "date": {
+                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                  "type": "string"
+                },
+                "flag_color": {
+                  "anyOf": [
+                    {
+                      "enum": [
+                        "red",
+                        "orange",
+                        "yellow",
+                        "green",
+                        "blue",
+                        "purple"
+                      ],
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "memo": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "payee_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "payee_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "subtransactions": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "amount": {
+                        "description": "Amount in decimal currency units",
+                        "type": "number"
+                      },
+                      "amount_currency": {
+                        "type": "number"
+                      },
+                      "amount_formatted": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "amount_milliunits": {
+                        "maximum": 9007199254740991,
+                        "minimum": -9007199254740991,
+                        "type": "integer"
+                      },
+                      "category_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "category_name": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "deleted": {
+                        "type": "boolean"
+                      },
+                      "id": {
+                        "type": "string"
+                      },
+                      "memo": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "payee_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "payee_name": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "scheduled_transaction_id": {
+                        "type": "string"
+                      },
+                      "transaction_id": {
+                        "type": "string"
+                      },
+                      "transfer_account_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "transfer_transaction_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "amount"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "before": {
+              "anyOf": [
+                {
+                  "const": "unavailable",
+                  "type": "string"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "amount": {
+                      "description": "Amount in decimal currency units",
+                      "type": "number"
+                    },
+                    "amount_milliunits": {
+                      "maximum": 9007199254740991,
+                      "minimum": -9007199254740991,
+                      "type": "integer"
+                    },
+                    "approved": {
+                      "type": "boolean"
+                    },
+                    "category_id": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "cleared": {
+                      "enum": [
+                        "cleared",
+                        "uncleared",
+                        "reconciled"
+                      ],
+                      "type": "string"
+                    },
+                    "date": {
+                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                      "type": "string"
+                    },
+                    "flag_color": {
+                      "anyOf": [
+                        {
+                          "enum": [
+                            "red",
+                            "orange",
+                            "yellow",
+                            "green",
+                            "blue",
+                            "purple"
+                          ],
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "memo": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "payee_id": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "payee_name": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "subtransactions": {
+                      "items": {
+                        "additionalProperties": false,
+                        "properties": {
+                          "amount": {
+                            "description": "Amount in decimal currency units",
+                            "type": "number"
+                          },
+                          "amount_currency": {
+                            "type": "number"
+                          },
+                          "amount_formatted": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "amount_milliunits": {
+                            "maximum": 9007199254740991,
+                            "minimum": -9007199254740991,
+                            "type": "integer"
+                          },
+                          "category_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "category_name": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "deleted": {
+                            "type": "boolean"
+                          },
+                          "id": {
+                            "type": "string"
+                          },
+                          "memo": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "payee_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "payee_name": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "scheduled_transaction_id": {
+                            "type": "string"
+                          },
+                          "transaction_id": {
+                            "type": "string"
+                          },
+                          "transfer_account_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "transfer_transaction_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "amount"
+                        ],
+                        "type": "object"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "type": "object"
+                }
+              ]
+            },
+            "transaction_id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "transaction_id",
+            "before",
+            "after"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "validation": {
+        "const": "passed",
+        "type": "string"
+      },
+      "warnings": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "count": {
+              "type": "number"
+            },
+            "message": {
+              "type": "string"
+            },
+            "sample_ids": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "code",
+            "count",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "dry_run",
+      "action",
+      "validation",
+      "summary",
+      "transactions_preview",
+      "note"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": {},
+    "properties": {
+      "confirmation_expires_at": {
+        "description": "Preview only: when confirmation_token expires (ISO 8601).",
+        "format": "date-time",
+        "type": "string"
+      },
+      "confirmation_token": {
+        "description": "Preview only: single-use token that executes this exact request when passed back as confirmation_token.",
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "mode": {
+        "enum": [
+          "full",
+          "summary",
+          "ids_only"
+        ],
+        "type": "string"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": {},
+          "properties": {
+            "correlation_key": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            },
+            "error_code": {
+              "type": "string"
+            },
+            "request_index": {
+              "type": "number"
+            },
+            "status": {
+              "enum": [
+                "created",
+                "duplicate",
+                "updated",
+                "failed"
+              ],
+              "type": "string"
+            },
+            "transaction_id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "request_index",
+            "status",
+            "correlation_key"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "results_omitted": {
+        "type": "boolean"
+      },
+      "server_knowledge": {
+        "type": "number"
+      },
+      "success": {
+        "type": "boolean"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "type": "number"
+          },
+          "duplicates": {
+            "type": "number"
+          },
+          "failed": {
+            "type": "number"
+          },
+          "total_requested": {
+            "type": "number"
+          },
+          "updated": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total_requested",
+          "failed"
+        ],
+        "type": "object"
+      },
+      "transactions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "account_id": {
+              "type": "string"
+            },
+            "account_name": {
+              "type": "string"
+            },
+            "amount": {
+              "description": "Amount in decimal currency units",
+              "type": "number"
+            },
+            "amount_currency": {
+              "type": "number"
+            },
+            "amount_formatted": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "amount_milliunits": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "approved": {
+              "type": "boolean"
+            },
+            "category_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "category_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "cleared": {
+              "type": "string"
+            },
+            "date": {
+              "type": "string"
+            },
+            "debt_transaction_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "deleted": {
+              "type": "boolean"
+            },
+            "flag_color": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "flag_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "id": {
+              "type": "string"
+            },
+            "import_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "import_payee_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "import_payee_name_original": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "matched_transaction_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "memo": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "parent_transaction_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "payee_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "payee_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "scheduled_transaction_id": {
+              "type": "string"
+            },
+            "subtransactions": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "amount": {
+                    "description": "Amount in decimal currency units",
+                    "type": "number"
+                  },
+                  "amount_currency": {
+                    "type": "number"
+                  },
+                  "amount_formatted": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "amount_milliunits": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "category_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "category_name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "deleted": {
+                    "type": "boolean"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "memo": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "payee_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "payee_name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "scheduled_transaction_id": {
+                    "type": "string"
+                  },
+                  "transaction_id": {
+                    "type": "string"
+                  },
+                  "transfer_account_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "transfer_transaction_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "amount"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "transaction_id": {
+              "type": "string"
+            },
+            "transfer_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "transfer_transaction_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "type": {
+              "enum": [
+                "transaction",
+                "subtransaction"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "amount",
+            "deleted",
+            "date",
+            "account_id",
+            "cleared",
+            "approved"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "success",
+      "summary",
+      "results"
+    ],
+    "type": "object"
+  }
+]

Changed5 schema fields changedv0.31.0Oct 29, 2026

addedInput schema / properties / confirmation_token / anyOf

Added value: +[
+  {
+    "minLength": 16,
+    "type": "string"
+  },
+  {
+    "const": ""
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / confirmation_token / description

Previous value: -"Short-lived, single-use token returned by the immediately preceding preview of this exact validated request."New value: +"Short-lived, single-use token returned by the immediately preceding preview of this exact validated request. Omit, or pass null or an empty string, to preview."

removedInput schema / properties / confirmation_token / minLength
```
Removed value: -16
```
removedInput schema / properties / confirmation_token / type
```
Removed value: -"string"
```

changedOutput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "ynab_update_transactions",
-        "type": "string"
-      },
-      "dry_run": {
-        "const": true,
-        "type": "boolean"
-      },
-      "note": {
-        "type": "string"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "accounts_affected": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "fields_to_update": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "total_transactions": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total_transactions",
-          "accounts_affected",
-          "fields_to_update"
-        ],
-        "type": "object"
-      },
-      "transactions_preview": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "after": {
-              "additionalProperties": false,
-              "properties": {
-                "amount": {
-                  "type": "number"
-                },
-                "approved": {
-                  "type": "boolean"
-                },
-                "category_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "cleared": {
-                  "enum": [
-                    "cleared",
-                    "uncleared",
-                    "reconciled"
-                  ],
-                  "type": "string"
-                },
-                "date": {
-                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                  "type": "string"
-                },
-                "flag_color": {
-                  "anyOf": [
-                    {
-                      "enum": [
-                        "red",
-                        "orange",
-                        "yellow",
-                        "green",
-                        "blue",
-                        "purple"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "memo": {
-                  "type": "string"
-                },
-                "payee_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "payee_name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "subtransactions": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "amount": {
-                        "type": "number"
-                      },
-                      "category_id": {
-                        "type": "string"
-                      },
-                      "memo": {
-                        "type": "string"
-                      },
-                      "payee_id": {
-                        "type": "string"
-                      },
-                      "payee_name": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "amount"
-                    ],
-                    "type": "object"
-                  },
-                  "type": "array"
-                }
-              },
-              "type": "object"
-            },
-            "before": {
-              "anyOf": [
-                {
-                  "const": "unavailable",
-                  "type": "string"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "amount": {
-                      "type": "number"
-                    },
-                    "approved": {
-                      "type": "boolean"
-                    },
-                    "category_id": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "cleared": {
-                      "enum": [
-                        "cleared",
-                        "uncleared",
-                        "reconciled"
-                      ],
-                      "type": "string"
-                    },
-                    "date": {
-                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                      "type": "string"
-                    },
-                    "flag_color": {
-                      "anyOf": [
-                        {
-                          "enum": [
-                            "red",
-                            "orange",
-                            "yellow",
-                            "green",
-                            "blue",
-                            "purple"
-                          ],
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "memo": {
-                      "type": "string"
-                    },
-                    "payee_id": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "payee_name": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "subtransactions": {
-                      "items": {
-                        "additionalProperties": false,
-                        "properties": {
-                          "amount": {
-                            "type": "number"
-                          },
-                          "category_id": {
-                            "type": "string"
-                          },
-                          "memo": {
-                            "type": "string"
-                          },
-                          "payee_id": {
-                            "type": "string"
-                          },
-                          "payee_name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "amount"
-                        ],
-                        "type": "object"
-                      },
-                      "type": "array"
-                    }
-                  },
-                  "type": "object"
-                }
-              ]
-            },
-            "transaction_id": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "transaction_id",
-            "before",
-            "after"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "validation": {
-        "const": "passed",
-        "type": "string"
-      },
-      "warnings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "count": {
-              "type": "number"
-            },
-            "message": {
-              "type": "string"
-            },
-            "sample_ids": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            }
-          },
-          "required": [
-            "code",
-            "count",
-            "message"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "dry_run",
-      "action",
-      "validation",
-      "summary",
-      "transactions_preview",
-      "note"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": {},
-    "properties": {
-      "message": {
-        "type": "string"
-      },
-      "mode": {
-        "enum": [
-          "full",
-          "summary",
-          "ids_only"
-        ],
-        "type": "string"
-      },
-      "results": {
-        "items": {
-          "additionalProperties": {},
-          "properties": {
-            "correlation_key": {
-              "type": "string"
-            },
-            "error": {
-              "type": "string"
-            },
-            "error_code": {
-              "type": "string"
-            },
-            "request_index": {
-              "type": "number"
-            },
-            "status": {
-              "enum": [
-                "created",
-                "duplicate",
-                "updated",
-                "failed"
-              ],
-              "type": "string"
-            },
-            "transaction_id": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "request_index",
-            "status",
-            "correlation_key"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "server_knowledge": {
-        "type": "number"
-      },
-      "success": {
-        "type": "boolean"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "created": {
-            "type": "number"
-          },
-          "duplicates": {
-            "type": "number"
-          },
-          "failed": {
-            "type": "number"
-          },
-          "total_requested": {
-            "type": "number"
-          },
-          "updated": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total_requested",
-          "failed"
-        ],
-        "type": "object"
-      },
-      "transactions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "account_id": {
-              "description": "Account ID",
-              "type": "string"
-            },
-            "account_name": {
-              "description": "Account name",
-              "type": "string"
-            },
-            "amount": {
-              "description": "Transaction amount in dollars",
-              "type": "number"
-            },
-            "approved": {
-              "description": "Approved flag",
-              "type": "boolean"
-            },
-            "category_id": {
-              "description": "Category ID",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "category_name": {
-              "description": "Category name",
-              "type": "string"
-            },
-            "cleared": {
-              "description": "Cleared status",
-              "type": "string"
-            },
-            "date": {
-              "description": "Transaction date",
-              "type": "string"
-            },
-            "deleted": {
-              "description": "Deleted flag",
-              "type": "boolean"
-            },
-            "flag_color": {
-              "description": "Flag color",
-              "type": "string"
-            },
-            "id": {
-              "description": "Transaction ID",
-              "type": "string"
-            },
-            "import_id": {
-              "description": "Import ID",
-              "type": "string"
-            },
-            "matched_transaction_id": {
-              "description": "Matched transaction ID",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "memo": {
-              "description": "Transaction memo",
-              "type": "string"
-            },
-            "payee_id": {
-              "description": "Payee ID",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "payee_name": {
-              "description": "Payee name",
-              "type": "string"
-            },
-            "transfer_account_id": {
-              "description": "Transfer account ID",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "transfer_transaction_id": {
-              "description": "Transfer transaction ID",
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "id",
-            "date",
-            "amount",
-            "cleared",
-            "approved",
-            "account_id",
-            "deleted"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "success",
-      "summary",
-      "results"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "ynab_update_transactions",
+        "type": "string"
+      },
+      "dry_run": {
+        "const": true,
+        "type": "boolean"
+      },
+      "note": {
+        "type": "string"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "accounts_affected": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "fields_to_update": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "total_transactions": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total_transactions",
+          "accounts_affected",
+          "fields_to_update"
+        ],
+        "type": "object"
+      },
+      "transactions_preview": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "after": {
+              "additionalProperties": false,
+              "properties": {
+                "amount": {
+                  "description": "Amount in decimal currency units",
+                  "type": "number"
+                },
+                "amount_milliunits": {
+                  "maximum": 9007199254740991,
+                  "minimum": -9007199254740991,
+                  "type": "integer"
+                },
+                "approved": {
+                  "type": "boolean"
+                },
+                "category_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "cleared": {
+                  "enum": [
+                    "cleared",
+                    "uncleared",
+                    "reconciled"
+                  ],
+                  "type": "string"
+                },
+                "date": {
+                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                  "type": "string"
+                },
+                "flag_color": {
+                  "anyOf": [
+                    {
+                      "enum": [
+                        "red",
+                        "orange",
+                        "yellow",
+                        "green",
+                        "blue",
+                        "purple"
+                      ],
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "memo": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "payee_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "payee_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "subtransactions": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "amount": {
+                        "description": "Amount in decimal currency units",
+                        "type": "number"
+                      },
+                      "amount_currency": {
+                        "type": "number"
+                      },
+                      "amount_formatted": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "amount_milliunits": {
+                        "maximum": 9007199254740991,
+                        "minimum": -9007199254740991,
+                        "type": "integer"
+                      },
+                      "category_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "category_name": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "deleted": {
+                        "type": "boolean"
+                      },
+                      "id": {
+                        "type": "string"
+                      },
+                      "memo": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "payee_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "payee_name": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "scheduled_transaction_id": {
+                        "type": "string"
+                      },
+                      "transaction_id": {
+                        "type": "string"
+                      },
+                      "transfer_account_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "transfer_transaction_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "amount"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "before": {
+              "anyOf": [
+                {
+                  "const": "unavailable",
+                  "type": "string"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "amount": {
+                      "description": "Amount in decimal currency units",
+                      "type": "number"
+                    },
+                    "amount_milliunits": {
+                      "maximum": 9007199254740991,
+                      "minimum": -9007199254740991,
+                      "type": "integer"
+                    },
+                    "approved": {
+                      "type": "boolean"
+                    },
+                    "category_id": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "cleared": {
+                      "enum": [
+                        "cleared",
+                        "uncleared",
+                        "reconciled"
+                      ],
+                      "type": "string"
+                    },
+                    "date": {
+                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                      "type": "string"
+                    },
+                    "flag_color": {
+                      "anyOf": [
+                        {
+                          "enum": [
+                            "red",
+                            "orange",
+                            "yellow",
+                            "green",
+                            "blue",
+                            "purple"
+                          ],
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "memo": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "payee_id": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "payee_name": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "subtransactions": {
+                      "items": {
+                        "additionalProperties": false,
+                        "properties": {
+                          "amount": {
+                            "description": "Amount in decimal currency units",
+                            "type": "number"
+                          },
+                          "amount_currency": {
+                            "type": "number"
+                          },
+                          "amount_formatted": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "amount_milliunits": {
+                            "maximum": 9007199254740991,
+                            "minimum": -9007199254740991,
+                            "type": "integer"
+                          },
+                          "category_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "category_name": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "deleted": {
+                            "type": "boolean"
+                          },
+                          "id": {
+                            "type": "string"
+                          },
+                          "memo": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "payee_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "payee_name": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "scheduled_transaction_id": {
+                            "type": "string"
+                          },
+                          "transaction_id": {
+                            "type": "string"
+                          },
+                          "transfer_account_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "transfer_transaction_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "amount"
+                        ],
+                        "type": "object"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "type": "object"
+                }
+              ]
+            },
+            "transaction_id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "transaction_id",
+            "before",
+            "after"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "validation": {
+        "const": "passed",
+        "type": "string"
+      },
+      "warnings": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "count": {
+              "type": "number"
+            },
+            "message": {
+              "type": "string"
+            },
+            "sample_ids": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "code",
+            "count",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "dry_run",
+      "action",
+      "validation",
+      "summary",
+      "transactions_preview",
+      "note"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": {},
+    "properties": {
+      "message": {
+        "type": "string"
+      },
+      "mode": {
+        "enum": [
+          "full",
+          "summary",
+          "ids_only"
+        ],
+        "type": "string"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": {},
+          "properties": {
+            "correlation_key": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            },
+            "error_code": {
+              "type": "string"
+            },
+            "request_index": {
+              "type": "number"
+            },
+            "status": {
+              "enum": [
+                "created",
+                "duplicate",
+                "updated",
+                "failed"
+              ],
+              "type": "string"
+            },
+            "transaction_id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "request_index",
+            "status",
+            "correlation_key"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "results_omitted": {
+        "type": "boolean"
+      },
+      "server_knowledge": {
+        "type": "number"
+      },
+      "success": {
+        "type": "boolean"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "type": "number"
+          },
+          "duplicates": {
+            "type": "number"
+          },
+          "failed": {
+            "type": "number"
+          },
+          "total_requested": {
+            "type": "number"
+          },
+          "updated": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total_requested",
+          "failed"
+        ],
+        "type": "object"
+      },
+      "transactions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "account_id": {
+              "type": "string"
+            },
+            "account_name": {
+              "type": "string"
+            },
+            "amount": {
+              "description": "Amount in decimal currency units",
+              "type": "number"
+            },
+            "amount_currency": {
+              "type": "number"
+            },
+            "amount_formatted": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "amount_milliunits": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "approved": {
+              "type": "boolean"
+            },
+            "category_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "category_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "cleared": {
+              "type": "string"
+            },
+            "date": {
+              "type": "string"
+            },
+            "debt_transaction_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "deleted": {
+              "type": "boolean"
+            },
+            "flag_color": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "flag_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "id": {
+              "type": "string"
+            },
+            "import_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "import_payee_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "import_payee_name_original": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "matched_transaction_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "memo": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "parent_transaction_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "payee_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "payee_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "scheduled_transaction_id": {
+              "type": "string"
+            },
+            "subtransactions": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "amount": {
+                    "description": "Amount in decimal currency units",
+                    "type": "number"
+                  },
+                  "amount_currency": {
+                    "type": "number"
+                  },
+                  "amount_formatted": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "amount_milliunits": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "category_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "category_name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "deleted": {
+                    "type": "boolean"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "memo": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "payee_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "payee_name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "scheduled_transaction_id": {
+                    "type": "string"
+                  },
+                  "transaction_id": {
+                    "type": "string"
+                  },
+                  "transfer_account_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "transfer_transaction_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "amount"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "transaction_id": {
+              "type": "string"
+            },
+            "transfer_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "transfer_transaction_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "type": {
+              "enum": [
+                "transaction",
+                "subtransaction"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "amount",
+            "deleted",
+            "date",
+            "account_id",
+            "cleared",
+            "approved"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "success",
+      "summary",
+      "results"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedv0.29.1Oct 26, 2026

addedInput schema / properties / transactions / items / properties / subtransactions

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "amount": {
+        "description": "Deprecated legacy alias for amount_milliunits on this split line.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "amount_decimal": {
+        "description": "Preferred: amount in decimal currency units (for example, -12.34). Rounded exactly to the nearest YNAB milliunit.",
+        "type": "number"
+      },
+      "amount_milliunits": {
+        "description": "Raw YNAB milliunits. Use only when the value is already converted.",
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "category_id": {
+        "type": "string"
+      },
+      "memo": {
+        "type": "string"
+      },
+      "payee_id": {
+        "type": "string"
+      },
+      "payee_name": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "minItems": 1,
+  "type": "array"
+}

changedOutput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "const": "ynab_update_transactions",
-        "type": "string"
-      },
-      "dry_run": {
-        "const": true,
-        "type": "boolean"
-      },
-      "note": {
-        "type": "string"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "accounts_affected": {
-            "type": "number"
-          },
-          "fields_to_update": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "total_transactions": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total_transactions",
-          "accounts_affected",
-          "fields_to_update"
-        ],
-        "type": "object"
-      },
-      "transactions_preview": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "after": {
-              "additionalProperties": false,
-              "properties": {
-                "amount": {
-                  "type": "number"
-                },
-                "approved": {
-                  "type": "boolean"
-                },
-                "category_id": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "cleared": {
-                  "enum": [
-                    "cleared",
-                    "uncleared",
-                    "reconciled"
-                  ],
-                  "type": "string"
-                },
-                "date": {
-                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                  "type": "string"
-                },
-                "flag_color": {
-                  "anyOf": [
-                    {
-                      "enum": [
-                        "red",
-                        "orange",
-                        "yellow",
-                        "green",
-                        "blue",
-                        "purple"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "memo": {
-                  "type": "string"
-                },
-                "payee_id": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "payee_name": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "before": {
-              "anyOf": [
-                {
-                  "const": "unavailable",
-                  "type": "string"
-                },
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "amount": {
-                      "type": "number"
-                    },
-                    "approved": {
-                      "type": "boolean"
-                    },
-                    "category_id": {
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "cleared": {
-                      "enum": [
-                        "cleared",
-                        "uncleared",
-                        "reconciled"
-                      ],
-                      "type": "string"
-                    },
-                    "date": {
-                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                      "type": "string"
-                    },
-                    "flag_color": {
-                      "anyOf": [
-                        {
-                          "enum": [
-                            "red",
-                            "orange",
-                            "yellow",
-                            "green",
-                            "blue",
-                            "purple"
-                          ],
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "memo": {
-                      "type": "string"
-                    },
-                    "payee_id": {
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "payee_name": {
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    }
-                  },
-                  "type": "object"
-                }
-              ]
-            },
-            "transaction_id": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "transaction_id",
-            "before",
-            "after"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "validation": {
-        "const": "passed",
-        "type": "string"
-      },
-      "warnings": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "count": {
-              "type": "number"
-            },
-            "message": {
-              "type": "string"
-            },
-            "sample_ids": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            }
-          },
-          "required": [
-            "code",
-            "count",
-            "message"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "dry_run",
-      "action",
-      "validation",
-      "summary",
-      "transactions_preview",
-      "note"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": {},
-    "properties": {
-      "message": {
-        "type": "string"
-      },
-      "mode": {
-        "enum": [
-          "full",
-          "summary",
-          "ids_only"
-        ],
-        "type": "string"
-      },
-      "results": {
-        "items": {
-          "additionalProperties": {},
-          "properties": {
-            "correlation_key": {
-              "type": "string"
-            },
-            "error": {
-              "type": "string"
-            },
-            "error_code": {
-              "type": "string"
-            },
-            "request_index": {
-              "type": "number"
-            },
-            "status": {
-              "enum": [
-                "created",
-                "duplicate",
-                "updated",
-                "failed"
-              ],
-              "type": "string"
-            },
-            "transaction_id": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "request_index",
-            "status",
-            "correlation_key"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "server_knowledge": {
-        "type": "number"
-      },
-      "success": {
-        "type": "boolean"
-      },
-      "summary": {
-        "additionalProperties": false,
-        "properties": {
-          "created": {
-            "type": "number"
-          },
-          "duplicates": {
-            "type": "number"
-          },
-          "failed": {
-            "type": "number"
-          },
-          "total_requested": {
-            "type": "number"
-          },
-          "updated": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "total_requested",
-          "failed"
-        ],
-        "type": "object"
-      },
-      "transactions": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "account_id": {
-              "description": "Account ID",
-              "type": "string"
-            },
-            "account_name": {
-              "description": "Account name",
-              "type": "string"
-            },
-            "amount": {
-              "description": "Transaction amount in dollars",
-              "type": "number"
-            },
-            "approved": {
-              "description": "Approved flag",
-              "type": "boolean"
-            },
-            "category_id": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Category ID"
-            },
-            "category_name": {
-              "description": "Category name",
-              "type": "string"
-            },
-            "cleared": {
-              "description": "Cleared status",
-              "type": "string"
-            },
-            "date": {
-              "description": "Transaction date",
-              "type": "string"
-            },
-            "deleted": {
-              "description": "Deleted flag",
-              "type": "boolean"
-            },
-            "flag_color": {
-              "description": "Flag color",
-              "type": "string"
-            },
-            "id": {
-              "description": "Transaction ID",
-              "type": "string"
-            },
-            "import_id": {
-              "description": "Import ID",
-              "type": "string"
-            },
-            "matched_transaction_id": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Matched transaction ID"
-            },
-            "memo": {
-              "description": "Transaction memo",
-              "type": "string"
-            },
-            "payee_id": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Payee ID"
-            },
-            "payee_name": {
-              "description": "Payee name",
-              "type": "string"
-            },
-            "transfer_account_id": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Transfer account ID"
-            },
-            "transfer_transaction_id": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Transfer transaction ID"
-            }
-          },
-          "required": [
-            "id",
-            "date",
-            "amount",
-            "cleared",
-            "approved",
-            "account_id",
-            "deleted"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "success",
-      "summary",
-      "results"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "const": "ynab_update_transactions",
+        "type": "string"
+      },
+      "dry_run": {
+        "const": true,
+        "type": "boolean"
+      },
+      "note": {
+        "type": "string"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "accounts_affected": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "fields_to_update": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "total_transactions": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total_transactions",
+          "accounts_affected",
+          "fields_to_update"
+        ],
+        "type": "object"
+      },
+      "transactions_preview": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "after": {
+              "additionalProperties": false,
+              "properties": {
+                "amount": {
+                  "type": "number"
+                },
+                "approved": {
+                  "type": "boolean"
+                },
+                "category_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "cleared": {
+                  "enum": [
+                    "cleared",
+                    "uncleared",
+                    "reconciled"
+                  ],
+                  "type": "string"
+                },
+                "date": {
+                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                  "type": "string"
+                },
+                "flag_color": {
+                  "anyOf": [
+                    {
+                      "enum": [
+                        "red",
+                        "orange",
+                        "yellow",
+                        "green",
+                        "blue",
+                        "purple"
+                      ],
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "memo": {
+                  "type": "string"
+                },
+                "payee_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "payee_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "subtransactions": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "amount": {
+                        "type": "number"
+                      },
+                      "category_id": {
+                        "type": "string"
+                      },
+                      "memo": {
+                        "type": "string"
+                      },
+                      "payee_id": {
+                        "type": "string"
+                      },
+                      "payee_name": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "amount"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "before": {
+              "anyOf": [
+                {
+                  "const": "unavailable",
+                  "type": "string"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "amount": {
+                      "type": "number"
+                    },
+                    "approved": {
+                      "type": "boolean"
+                    },
+                    "category_id": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "cleared": {
+                      "enum": [
+                        "cleared",
+                        "uncleared",
+                        "reconciled"
+                      ],
+                      "type": "string"
+                    },
+                    "date": {
+                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                      "type": "string"
+                    },
+                    "flag_color": {
+                      "anyOf": [
+                        {
+                          "enum": [
+                            "red",
+                            "orange",
+                            "yellow",
+                            "green",
+                            "blue",
+                            "purple"
+                          ],
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "memo": {
+                      "type": "string"
+                    },
+                    "payee_id": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "payee_name": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "subtransactions": {
+                      "items": {
+                        "additionalProperties": false,
+                        "properties": {
+                          "amount": {
+                            "type": "number"
+                          },
+                          "category_id": {
+                            "type": "string"
+                          },
+                          "memo": {
+                            "type": "string"
+                          },
+                          "payee_id": {
+                            "type": "string"
+                          },
+                          "payee_name": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "amount"
+                        ],
+                        "type": "object"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "type": "object"
+                }
+              ]
+            },
+            "transaction_id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "transaction_id",
+            "before",
+            "after"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "validation": {
+        "const": "passed",
+        "type": "string"
+      },
+      "warnings": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "count": {
+              "type": "number"
+            },
+            "message": {
+              "type": "string"
+            },
+            "sample_ids": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "code",
+            "count",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "dry_run",
+      "action",
+      "validation",
+      "summary",
+      "transactions_preview",
+      "note"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": {},
+    "properties": {
+      "message": {
+        "type": "string"
+      },
+      "mode": {
+        "enum": [
+          "full",
+          "summary",
+          "ids_only"
+        ],
+        "type": "string"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": {},
+          "properties": {
+            "correlation_key": {
+              "type": "string"
+            },
+            "error": {
+              "type": "string"
+            },
+            "error_code": {
+              "type": "string"
+            },
+            "request_index": {
+              "type": "number"
+            },
+            "status": {
+              "enum": [
+                "created",
+                "duplicate",
+                "updated",
+                "failed"
+              ],
+              "type": "string"
+            },
+            "transaction_id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "request_index",
+            "status",
+            "correlation_key"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "server_knowledge": {
+        "type": "number"
+      },
+      "success": {
+        "type": "boolean"
+      },
+      "summary": {
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "type": "number"
+          },
+          "duplicates": {
+            "type": "number"
+          },
+          "failed": {
+            "type": "number"
+          },
+          "total_requested": {
+            "type": "number"
+          },
+          "updated": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "total_requested",
+          "failed"
+        ],
+        "type": "object"
+      },
+      "transactions": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "account_id": {
+              "description": "Account ID",
+              "type": "string"
+            },
+            "account_name": {
+              "description": "Account name",
+              "type": "string"
+            },
+            "amount": {
+              "description": "Transaction amount in dollars",
+              "type": "number"
+            },
+            "approved": {
+              "description": "Approved flag",
+              "type": "boolean"
+            },
+            "category_id": {
+              "description": "Category ID",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "category_name": {
+              "description": "Category name",
+              "type": "string"
+            },
+            "cleared": {
+              "description": "Cleared status",
+              "type": "string"
+            },
+            "date": {
+              "description": "Transaction date",
+              "type": "string"
+            },
+            "deleted": {
+              "description": "Deleted flag",
+              "type": "boolean"
+            },
+            "flag_color": {
+              "description": "Flag color",
+              "type": "string"
+            },
+            "id": {
+              "description": "Transaction ID",
+              "type": "string"
+            },
+            "import_id": {
+              "description": "Import ID",
+              "type": "string"
+            },
+            "matched_transaction_id": {
+              "description": "Matched transaction ID",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "memo": {
+              "description": "Transaction memo",
+              "type": "string"
+            },
+            "payee_id": {
+              "description": "Payee ID",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "payee_name": {
+              "description": "Payee name",
+              "type": "string"
+            },
+            "transfer_account_id": {
+              "description": "Transfer account ID",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "transfer_transaction_id": {
+              "description": "Transfer transaction ID",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "date",
+            "amount",
+            "cleared",
+            "approved",
+            "account_id",
+            "deleted"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "success",
+      "summary",
+      "results"
+    ],
+    "type": "object"
+  }
+]

Changed4 schema fields changedv0.27.1Jul 12, 2026

addedInput schema / properties / confirmation_token

Added value: +{
+  "description": "Short-lived, single-use token returned by the immediately preceding preview of this exact validated request.",
+  "minLength": 16,
+  "type": "string"
+}

addedInput schema / properties / transactions / items / properties / amount / description

Added value: +"Deprecated legacy alias for amount_milliunits. Use amount_decimal for currency input or amount_milliunits for raw YNAB values."

addedInput schema / properties / transactions / items / properties / amount_decimal

Added value: +{
+  "description": "Preferred: amount in decimal currency units (for example, -12.34). Rounded exactly to the nearest YNAB milliunit.",
+  "type": "number"
+}

addedInput schema / properties / transactions / items / properties / amount_milliunits

Added value: +{
+  "description": "Raw YNAB milliunits. Use only when the value is already converted.",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

Addedv0.26.9May 11, 2026

TDQS

A4.5/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations, it discloses the write-safety handshake (preview issues a single-use, short-lived confirmation_token), the 100-item batch ceiling, the exact return shape (summary/updated/failed/results/transactions), and a real domain constraint that YNAB cannot replace lines on an existing split. Those are precisely the behaviors an agent cannot infer from the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The Args/Returns/Examples/Write-safety structure is front-loaded and skimmable, and every section carries content. There is mild redundancy: dry_run is restated in the Args block, the Examples block, and again inside the confirmation_token guidance, which could be tightened into one statement of the preview workflow.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with an output schema, the coverage is complete: it explains the execution workflow, batch limits, payload shape, amount-encoding rules, split limitations, and even restates what the response returns. Nothing an agent needs to call this correctly is absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 25%, so the description carries the burden and does so: it explains budget_id omission semantics, the amount_decimal vs amount_milliunits vs deprecated amount preference order, and the rule for converting a non-split transaction into a split whose subtransactions sum to the parent amount. It also clarifies that omitting, null, or empty-string confirmation_token all mean preview.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence gives a specific verb, resource, and scope: 'Update 1–100 transactions in a single batch with dry-run preview.' The batch scope implicitly separates it from the singular ynab_update_transaction sibling, but it never names that sibling, so the agent must infer the distinction from the word 'batch' alone.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It clearly states the two-step execution contract: call without confirmation_token to preview, then replay the identical validated request with the returned short-lived token. It also gives a concrete dry_run example. What is missing is guidance on choosing this batch tool over ynab_update_transaction or ynab_create_transactions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

ynab_update_transactions

Instructions

Input Schema

Output Schema

Schema Changelog

TDQS

Other Tools