Skip to main content
Glama

ynab_create_receipt_split_transaction

Create a YNAB split transaction from itemized receipt data, automatically allocating tax proportionally across categories and previewing before saving.

Instructions

Create a split transaction from itemized receipt data with proportional tax allocation.

Args:

  • budget_id (string, optional): Budget UUID. Omit to use the default budget.

  • account_id (string, required): Account UUID.

  • payee_name (string, required): Store/payee name.

  • receipt_total (number, required): Total amount in dollars (positive).

  • receipt_tax (number, required): Tax amount in dollars (0 if none).

  • categories (array, required): Category groups with items. Each item needs name, amount.

  • date (string, optional): ISO date. Default: today.

  • memo (string, optional): Memo applied to the parent transaction.

  • receipt_subtotal (number, optional): Pre-tax subtotal for validation.

  • cleared (string, optional): "cleared", "uncleared", or "reconciled". Default: "uncleared".

  • approved (boolean, optional): Mark as approved. Default: false.

  • flag_color (string, optional): Transaction flag color ("red", "orange", "yellow", "green", "blue", "purple").

  • dry_run (boolean, optional): Preview subtransactions without saving. Default: false.

Use this helper when you have receipt line items and want tax allocated across categories automatically. For generic manual split transactions without receipt/tax logic, use "ynab_create_transaction" with "subtransactions".

Returns: transaction with subtransactions and receipt_summary.

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

NameRequiredDescriptionDefault
dateNo
memoNo
clearedNo
dry_runNo
approvedNo
budget_idNo
account_idYes
categoriesYes
flag_colorNo
payee_nameYes
receipt_taxYes
receipt_totalYes
receipt_subtotalNo
confirmation_tokenNoShort-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

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.32.0
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "action": {
      -        "const": "ynab_create_receipt_split_transaction",
      -        "type": "string"
      -      },
      -      "dry_run": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "receipt_summary": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "categories": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "category_id": {
      -                  "type": "string"
      -                },
      -                "category_name": {
      -                  "type": "string"
      -                },
      -                "items": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "amount": {
      -                        "type": "number"
      -                      },
      -                      "memo": {
      -                        "type": "string"
      -                      },
      -                      "name": {
      -                        "type": "string"
      -                      },
      -                      "quantity": {
      -                        "type": "number"
      -                      }
      -                    },
      -                    "required": [
      -                      "name",
      -                      "amount"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "subtotal": {
      -                  "type": "number"
      -                },
      -                "tax": {
      -                  "type": "number"
      -                },
      -                "total": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "category_id",
      -                "items",
      -                "subtotal",
      -                "tax",
      -                "total"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "subtotal": {
      -            "type": "number"
      -          },
      -          "tax": {
      -            "type": "number"
      -          },
      -          "total": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "subtotal",
      -          "tax",
      -          "total",
      -          "categories"
      -        ],
      -        "type": "object"
      -      },
      -      "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"
      -              ]
      -            },
      -            "memo": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "payee_id": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "payee_name": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "scheduled_transaction_id": {
      -              "type": "string"
      -            },
      -            "transfer_account_id": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "transfer_transaction_id": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "amount"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "transaction_preview": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "account_id": {
      -            "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": {
      -            "enum": [
      -              "cleared",
      -              "uncleared",
      -              "reconciled"
      -            ],
      -            "type": "string"
      -          },
      -          "date": {
      -            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      -            "type": "string"
      -          },
      -          "debt_transaction_type": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "flag_color": {
      -            "anyOf": [
      -              {
      -                "enum": [
      -                  "red",
      -                  "orange",
      -                  "yellow",
      -                  "green",
      -                  "blue",
      -                  "purple"
      -                ],
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "flag_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "import_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "import_payee_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "import_payee_name_original": {
      -            "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": [
      -          "amount",
      -          "date",
      -          "account_id"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "dry_run",
      -      "action",
      -      "transaction_preview",
      -      "receipt_summary",
      -      "subtransactions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "receipt_summary": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "categories": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "category_id": {
      -                  "type": "string"
      -                },
      -                "category_name": {
      -                  "type": "string"
      -                },
      -                "items": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "amount": {
      -                        "type": "number"
      -                      },
      -                      "memo": {
      -                        "type": "string"
      -                      },
      -                      "name": {
      -                        "type": "string"
      -                      },
      -                      "quantity": {
      -                        "type": "number"
      -                      }
      -                    },
      -                    "required": [
      -                      "name",
      -                      "amount"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "subtotal": {
      -                  "type": "number"
      -                },
      -                "tax": {
      -                  "type": "number"
      -                },
      -                "total": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "category_id",
      -                "items",
      -                "subtotal",
      -                "tax",
      -                "total"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "subtotal": {
      -            "type": "number"
      -          },
      -          "tax": {
      -            "type": "number"
      -          },
      -          "total": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "subtotal",
      -          "tax",
      -          "total",
      -          "categories"
      -        ],
      -        "type": "object"
      -      },
      -      "transaction": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "account_balance": {
      -            "type": "number"
      -          },
      -          "account_cleared_balance": {
      -            "type": "number"
      -          },
      -          "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": [
      -                "id",
      -                "transaction_id",
      -                "amount",
      -                "deleted"
      -              ],
      -              "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"
      -      }
      -    },
      -    "required": [
      -      "transaction",
      -      "receipt_summary"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "action": {
      +        "const": "ynab_create_receipt_split_transaction",
      +        "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"
      +      },
      +      "receipt_summary": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "categories": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "category_id": {
      +                  "type": "string"
      +                },
      +                "category_name": {
      +                  "type": "string"
      +                },
      +                "items": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "amount": {
      +                        "type": "number"
      +                      },
      +                      "memo": {
      +                        "type": "string"
      +                      },
      +                      "name": {
      +                        "type": "string"
      +                      },
      +                      "quantity": {
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "name",
      +                      "amount"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "subtotal": {
      +                  "type": "number"
      +                },
      +                "tax": {
      +                  "type": "number"
      +                },
      +                "total": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "category_id",
      +                "items",
      +                "subtotal",
      +                "tax",
      +                "total"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "subtotal": {
      +            "type": "number"
      +          },
      +          "tax": {
      +            "type": "number"
      +          },
      +          "total": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "subtotal",
      +          "tax",
      +          "total",
      +          "categories"
      +        ],
      +        "type": "object"
      +      },
      +      "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"
      +              ]
      +            },
      +            "memo": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "payee_id": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "payee_name": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "scheduled_transaction_id": {
      +              "type": "string"
      +            },
      +            "transfer_account_id": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "transfer_transaction_id": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "amount"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "transaction_preview": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "account_id": {
      +            "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": {
      +            "enum": [
      +              "cleared",
      +              "uncleared",
      +              "reconciled"
      +            ],
      +            "type": "string"
      +          },
      +          "date": {
      +            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +            "type": "string"
      +          },
      +          "debt_transaction_type": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "flag_color": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "red",
      +                  "orange",
      +                  "yellow",
      +                  "green",
      +                  "blue",
      +                  "purple"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "flag_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "import_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "import_payee_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "import_payee_name_original": {
      +            "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": [
      +          "amount",
      +          "date",
      +          "account_id"
      +        ],
      +        "type": "object"
      +      },
      +      "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",
      +      "transaction_preview",
      +      "receipt_summary",
      +      "subtransactions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "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"
      +      },
      +      "receipt_summary": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "categories": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "category_id": {
      +                  "type": "string"
      +                },
      +                "category_name": {
      +                  "type": "string"
      +                },
      +                "items": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "amount": {
      +                        "type": "number"
      +                      },
      +                      "memo": {
      +                        "type": "string"
      +                      },
      +                      "name": {
      +                        "type": "string"
      +                      },
      +                      "quantity": {
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "name",
      +                      "amount"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "subtotal": {
      +                  "type": "number"
      +                },
      +                "tax": {
      +                  "type": "number"
      +                },
      +                "total": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "category_id",
      +                "items",
      +                "subtotal",
      +                "tax",
      +                "total"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "subtotal": {
      +            "type": "number"
      +          },
      +          "tax": {
      +            "type": "number"
      +          },
      +          "total": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "subtotal",
      +          "tax",
      +          "total",
      +          "categories"
      +        ],
      +        "type": "object"
      +      },
      +      "transaction": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "account_balance": {
      +            "type": "number"
      +          },
      +          "account_cleared_balance": {
      +            "type": "number"
      +          },
      +          "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": [
      +                "id",
      +                "transaction_id",
      +                "amount",
      +                "deleted"
      +              ],
      +              "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"
      +      }
      +    },
      +    "required": [
      +      "transaction",
      +      "receipt_summary"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed5 schema fields changedv0.31.0
    • 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_create_receipt_split_transaction",
      -        "type": "string"
      -      },
      -      "dry_run": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "receipt_summary": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "categories": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "category_id": {
      -                  "type": "string"
      -                },
      -                "category_name": {
      -                  "type": "string"
      -                },
      -                "items": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "amount": {
      -                        "type": "number"
      -                      },
      -                      "memo": {
      -                        "type": "string"
      -                      },
      -                      "name": {
      -                        "type": "string"
      -                      },
      -                      "quantity": {
      -                        "type": "number"
      -                      }
      -                    },
      -                    "required": [
      -                      "name",
      -                      "amount"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "subtotal": {
      -                  "type": "number"
      -                },
      -                "tax": {
      -                  "type": "number"
      -                },
      -                "total": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "category_id",
      -                "items",
      -                "subtotal",
      -                "tax",
      -                "total"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "subtotal": {
      -            "type": "number"
      -          },
      -          "tax": {
      -            "type": "number"
      -          },
      -          "total": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "subtotal",
      -          "tax",
      -          "total",
      -          "categories"
      -        ],
      -        "type": "object"
      -      },
      -      "subtransactions": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "amount": {
      -              "type": "number"
      -            },
      -            "category_id": {
      -              "type": "string"
      -            },
      -            "category_name": {
      -              "type": "string"
      -            },
      -            "memo": {
      -              "type": "string"
      -            },
      -            "payee_id": {
      -              "type": "string"
      -            },
      -            "payee_name": {
      -              "type": "string"
      -            },
      -            "transfer_account_id": {
      -              "type": "string"
      -            },
      -            "transfer_transaction_id": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "amount"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "transaction_preview": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "account_id": {
      -            "type": "string"
      -          },
      -          "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"
      -              }
      -            ]
      -          },
      -          "import_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "memo": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "payee_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "payee_name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "account_id",
      -          "date",
      -          "amount"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "dry_run",
      -      "action",
      -      "transaction_preview",
      -      "receipt_summary",
      -      "subtransactions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "receipt_summary": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "categories": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "category_id": {
      -                  "type": "string"
      -                },
      -                "category_name": {
      -                  "type": "string"
      -                },
      -                "items": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "amount": {
      -                        "type": "number"
      -                      },
      -                      "memo": {
      -                        "type": "string"
      -                      },
      -                      "name": {
      -                        "type": "string"
      -                      },
      -                      "quantity": {
      -                        "type": "number"
      -                      }
      -                    },
      -                    "required": [
      -                      "name",
      -                      "amount"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "subtotal": {
      -                  "type": "number"
      -                },
      -                "tax": {
      -                  "type": "number"
      -                },
      -                "total": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "category_id",
      -                "items",
      -                "subtotal",
      -                "tax",
      -                "total"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "subtotal": {
      -            "type": "number"
      -          },
      -          "tax": {
      -            "type": "number"
      -          },
      -          "total": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "subtotal",
      -          "tax",
      -          "total",
      -          "categories"
      -        ],
      -        "type": "object"
      -      },
      -      "transaction": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "account_balance": {
      -            "type": "number"
      -          },
      -          "account_cleared_balance": {
      -            "type": "number"
      -          },
      -          "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"
      -          },
      -          "subtransactions": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "amount": {
      -                  "type": "number"
      -                },
      -                "category_id": {
      -                  "type": "string"
      -                },
      -                "category_name": {
      -                  "type": "string"
      -                },
      -                "deleted": {
      -                  "type": "boolean"
      -                },
      -                "id": {
      -                  "type": "string"
      -                },
      -                "memo": {
      -                  "type": "string"
      -                },
      -                "payee_id": {
      -                  "type": "string"
      -                },
      -                "payee_name": {
      -                  "type": "string"
      -                },
      -                "transaction_id": {
      -                  "type": "string"
      -                },
      -                "transfer_account_id": {
      -                  "type": "string"
      -                },
      -                "transfer_transaction_id": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "id",
      -                "transaction_id",
      -                "amount",
      -                "deleted"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "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"
      -      }
      -    },
      -    "required": [
      -      "transaction",
      -      "receipt_summary"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "action": {
      +        "const": "ynab_create_receipt_split_transaction",
      +        "type": "string"
      +      },
      +      "dry_run": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "receipt_summary": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "categories": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "category_id": {
      +                  "type": "string"
      +                },
      +                "category_name": {
      +                  "type": "string"
      +                },
      +                "items": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "amount": {
      +                        "type": "number"
      +                      },
      +                      "memo": {
      +                        "type": "string"
      +                      },
      +                      "name": {
      +                        "type": "string"
      +                      },
      +                      "quantity": {
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "name",
      +                      "amount"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "subtotal": {
      +                  "type": "number"
      +                },
      +                "tax": {
      +                  "type": "number"
      +                },
      +                "total": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "category_id",
      +                "items",
      +                "subtotal",
      +                "tax",
      +                "total"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "subtotal": {
      +            "type": "number"
      +          },
      +          "tax": {
      +            "type": "number"
      +          },
      +          "total": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "subtotal",
      +          "tax",
      +          "total",
      +          "categories"
      +        ],
      +        "type": "object"
      +      },
      +      "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"
      +              ]
      +            },
      +            "memo": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "payee_id": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "payee_name": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "scheduled_transaction_id": {
      +              "type": "string"
      +            },
      +            "transfer_account_id": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "transfer_transaction_id": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "amount"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "transaction_preview": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "account_id": {
      +            "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": {
      +            "enum": [
      +              "cleared",
      +              "uncleared",
      +              "reconciled"
      +            ],
      +            "type": "string"
      +          },
      +          "date": {
      +            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +            "type": "string"
      +          },
      +          "debt_transaction_type": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "flag_color": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "red",
      +                  "orange",
      +                  "yellow",
      +                  "green",
      +                  "blue",
      +                  "purple"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "flag_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "import_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "import_payee_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "import_payee_name_original": {
      +            "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": [
      +          "amount",
      +          "date",
      +          "account_id"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "dry_run",
      +      "action",
      +      "transaction_preview",
      +      "receipt_summary",
      +      "subtransactions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "receipt_summary": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "categories": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "category_id": {
      +                  "type": "string"
      +                },
      +                "category_name": {
      +                  "type": "string"
      +                },
      +                "items": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "amount": {
      +                        "type": "number"
      +                      },
      +                      "memo": {
      +                        "type": "string"
      +                      },
      +                      "name": {
      +                        "type": "string"
      +                      },
      +                      "quantity": {
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "name",
      +                      "amount"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "subtotal": {
      +                  "type": "number"
      +                },
      +                "tax": {
      +                  "type": "number"
      +                },
      +                "total": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "category_id",
      +                "items",
      +                "subtotal",
      +                "tax",
      +                "total"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "subtotal": {
      +            "type": "number"
      +          },
      +          "tax": {
      +            "type": "number"
      +          },
      +          "total": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "subtotal",
      +          "tax",
      +          "total",
      +          "categories"
      +        ],
      +        "type": "object"
      +      },
      +      "transaction": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "account_balance": {
      +            "type": "number"
      +          },
      +          "account_cleared_balance": {
      +            "type": "number"
      +          },
      +          "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": [
      +                "id",
      +                "transaction_id",
      +                "amount",
      +                "deleted"
      +              ],
      +              "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"
      +      }
      +    },
      +    "required": [
      +      "transaction",
      +      "receipt_summary"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changedv0.29.1
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "action": {
      -        "const": "ynab_create_receipt_split_transaction",
      -        "type": "string"
      -      },
      -      "dry_run": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "receipt_summary": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "categories": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "category_id": {
      -                  "type": "string"
      -                },
      -                "category_name": {
      -                  "type": "string"
      -                },
      -                "items": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "amount": {
      -                        "type": "number"
      -                      },
      -                      "memo": {
      -                        "type": "string"
      -                      },
      -                      "name": {
      -                        "type": "string"
      -                      },
      -                      "quantity": {
      -                        "type": "number"
      -                      }
      -                    },
      -                    "required": [
      -                      "name",
      -                      "amount"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "subtotal": {
      -                  "type": "number"
      -                },
      -                "tax": {
      -                  "type": "number"
      -                },
      -                "total": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "category_id",
      -                "items",
      -                "subtotal",
      -                "tax",
      -                "total"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "subtotal": {
      -            "type": "number"
      -          },
      -          "tax": {
      -            "type": "number"
      -          },
      -          "total": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "subtotal",
      -          "tax",
      -          "total",
      -          "categories"
      -        ],
      -        "type": "object"
      -      },
      -      "subtransactions": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "amount": {
      -              "type": "number"
      -            },
      -            "category_id": {
      -              "type": "string"
      -            },
      -            "category_name": {
      -              "type": "string"
      -            },
      -            "memo": {
      -              "type": "string"
      -            },
      -            "payee_id": {
      -              "type": "string"
      -            },
      -            "payee_name": {
      -              "type": "string"
      -            },
      -            "transfer_account_id": {
      -              "type": "string"
      -            },
      -            "transfer_transaction_id": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "amount"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "transaction_preview": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "account_id": {
      -            "type": "string"
      -          },
      -          "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"
      -              }
      -            ]
      -          },
      -          "import_id": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "memo": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "payee_id": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "payee_name": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "account_id",
      -          "date",
      -          "amount"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "dry_run",
      -      "action",
      -      "transaction_preview",
      -      "receipt_summary",
      -      "subtransactions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "receipt_summary": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "categories": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "category_id": {
      -                  "type": "string"
      -                },
      -                "category_name": {
      -                  "type": "string"
      -                },
      -                "items": {
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "amount": {
      -                        "type": "number"
      -                      },
      -                      "memo": {
      -                        "type": "string"
      -                      },
      -                      "name": {
      -                        "type": "string"
      -                      },
      -                      "quantity": {
      -                        "type": "number"
      -                      }
      -                    },
      -                    "required": [
      -                      "name",
      -                      "amount"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "subtotal": {
      -                  "type": "number"
      -                },
      -                "tax": {
      -                  "type": "number"
      -                },
      -                "total": {
      -                  "type": "number"
      -                }
      -              },
      -              "required": [
      -                "category_id",
      -                "items",
      -                "subtotal",
      -                "tax",
      -                "total"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "subtotal": {
      -            "type": "number"
      -          },
      -          "tax": {
      -            "type": "number"
      -          },
      -          "total": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "subtotal",
      -          "tax",
      -          "total",
      -          "categories"
      -        ],
      -        "type": "object"
      -      },
      -      "transaction": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "account_balance": {
      -            "type": "number"
      -          },
      -          "account_cleared_balance": {
      -            "type": "number"
      -          },
      -          "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"
      -          },
      -          "subtransactions": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "amount": {
      -                  "type": "number"
      -                },
      -                "category_id": {
      -                  "type": "string"
      -                },
      -                "category_name": {
      -                  "type": "string"
      -                },
      -                "deleted": {
      -                  "type": "boolean"
      -                },
      -                "id": {
      -                  "type": "string"
      -                },
      -                "memo": {
      -                  "type": "string"
      -                },
      -                "payee_id": {
      -                  "type": "string"
      -                },
      -                "payee_name": {
      -                  "type": "string"
      -                },
      -                "transaction_id": {
      -                  "type": "string"
      -                },
      -                "transfer_account_id": {
      -                  "type": "string"
      -                },
      -                "transfer_transaction_id": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "id",
      -                "transaction_id",
      -                "amount",
      -                "deleted"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          "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"
      -      }
      -    },
      -    "required": [
      -      "transaction",
      -      "receipt_summary"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "action": {
      +        "const": "ynab_create_receipt_split_transaction",
      +        "type": "string"
      +      },
      +      "dry_run": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "receipt_summary": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "categories": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "category_id": {
      +                  "type": "string"
      +                },
      +                "category_name": {
      +                  "type": "string"
      +                },
      +                "items": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "amount": {
      +                        "type": "number"
      +                      },
      +                      "memo": {
      +                        "type": "string"
      +                      },
      +                      "name": {
      +                        "type": "string"
      +                      },
      +                      "quantity": {
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "name",
      +                      "amount"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "subtotal": {
      +                  "type": "number"
      +                },
      +                "tax": {
      +                  "type": "number"
      +                },
      +                "total": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "category_id",
      +                "items",
      +                "subtotal",
      +                "tax",
      +                "total"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "subtotal": {
      +            "type": "number"
      +          },
      +          "tax": {
      +            "type": "number"
      +          },
      +          "total": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "subtotal",
      +          "tax",
      +          "total",
      +          "categories"
      +        ],
      +        "type": "object"
      +      },
      +      "subtransactions": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "amount": {
      +              "type": "number"
      +            },
      +            "category_id": {
      +              "type": "string"
      +            },
      +            "category_name": {
      +              "type": "string"
      +            },
      +            "memo": {
      +              "type": "string"
      +            },
      +            "payee_id": {
      +              "type": "string"
      +            },
      +            "payee_name": {
      +              "type": "string"
      +            },
      +            "transfer_account_id": {
      +              "type": "string"
      +            },
      +            "transfer_transaction_id": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "amount"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "transaction_preview": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "account_id": {
      +            "type": "string"
      +          },
      +          "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"
      +              }
      +            ]
      +          },
      +          "import_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "memo": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "payee_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "payee_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "account_id",
      +          "date",
      +          "amount"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "dry_run",
      +      "action",
      +      "transaction_preview",
      +      "receipt_summary",
      +      "subtransactions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "receipt_summary": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "categories": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "category_id": {
      +                  "type": "string"
      +                },
      +                "category_name": {
      +                  "type": "string"
      +                },
      +                "items": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "amount": {
      +                        "type": "number"
      +                      },
      +                      "memo": {
      +                        "type": "string"
      +                      },
      +                      "name": {
      +                        "type": "string"
      +                      },
      +                      "quantity": {
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "name",
      +                      "amount"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "subtotal": {
      +                  "type": "number"
      +                },
      +                "tax": {
      +                  "type": "number"
      +                },
      +                "total": {
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "category_id",
      +                "items",
      +                "subtotal",
      +                "tax",
      +                "total"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "subtotal": {
      +            "type": "number"
      +          },
      +          "tax": {
      +            "type": "number"
      +          },
      +          "total": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "subtotal",
      +          "tax",
      +          "total",
      +          "categories"
      +        ],
      +        "type": "object"
      +      },
      +      "transaction": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "account_balance": {
      +            "type": "number"
      +          },
      +          "account_cleared_balance": {
      +            "type": "number"
      +          },
      +          "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"
      +          },
      +          "subtransactions": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "amount": {
      +                  "type": "number"
      +                },
      +                "category_id": {
      +                  "type": "string"
      +                },
      +                "category_name": {
      +                  "type": "string"
      +                },
      +                "deleted": {
      +                  "type": "boolean"
      +                },
      +                "id": {
      +                  "type": "string"
      +                },
      +                "memo": {
      +                  "type": "string"
      +                },
      +                "payee_id": {
      +                  "type": "string"
      +                },
      +                "payee_name": {
      +                  "type": "string"
      +                },
      +                "transaction_id": {
      +                  "type": "string"
      +                },
      +                "transfer_account_id": {
      +                  "type": "string"
      +                },
      +                "transfer_transaction_id": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "transaction_id",
      +                "amount",
      +                "deleted"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "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"
      +      }
      +    },
      +    "required": [
      +      "transaction",
      +      "receipt_summary"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed1 schema field changedv0.27.1
    • 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"
      +}
  5. Addedv0.26.9

TDQS

A4.7/5.0
Behavior5/5

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

Annotations only flag it as a non-read-only, non-idempotent, non-destructive write; the description adds the two-phase confirmation_token safety flow (preview returns a short-lived token, execute with the identical request), the default-budget behavior, defaults for date/cleared/approved, and the fact that memo lands on the parent transaction. That is substantive context beyond the structured hints.

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?

Front-loaded with purpose, then usage routing, then a scannable Args list, then return and safety notes — a sensible order with little filler. Minor inefficiency: it presents two overlapping preview mechanisms (dry_run and omitting confirmation_token) without saying how they differ or whether one implies the other.

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

Completeness4/5

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

For a 14-parameter write tool, the definition covers allocation semantics, defaults, confirmation safety, and the return shape, and an output schema exists so return values need no elaboration. The one unresolved ambiguity is the relationship between dry_run=true and the token-based preview, which an agent must guess between.

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

Parameters4/5

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

Schema description coverage is only 7%, so the Args block is doing the heavy lifting and mostly succeeds: it explains units (dollars), sign conventions (positive, 0 if no tax), the purpose of receipt_subtotal (validation), defaults, and enum values for cleared and flag_color. The gap is the categories structure — the schema requires category_id per group and allows item-level memo/quantity, none of which the Args text mentions ('Each item needs name, amount').

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

Purpose5/5

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

The first sentence gives a specific verb and resource ('Create a split transaction') plus the differentiating behavior ('proportional tax allocation') that separates it from generic transaction creation. An agent can identify the tool from the opening clause alone.

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

Usage Guidelines5/5

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

Explicitly states the selection condition ('when you have receipt line items and want tax allocated across categories automatically') and names the alternative for the other case ('For generic manual split transactions without receipt/tax logic, use ynab_create_transaction with subtransactions'). This is a clean when/when-not pair.

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