transactions

Update existing transaction. For more information, see https://docs.firefly-iii.org/references/firefly-iii/api/specials/

Update an existing transaction.

put/v1/transactions/{id}

Path parameters

idstring required
Example:123

The ID of the transaction.

Headers

X-Trace-Idstring uuid
Example:40c71bbb-c676-4f24-83cf-cc725d7d7a00

Unique identifier associated with this request.

Request body

apply_rulesboolean

Whether or not to apply rules when submitting transaction.

fire_webhooksboolean

Whether or not to fire the webhooks that are related to this event.

group_titlestring string nullable

Title of the transaction if it has been split in more than one piece. Empty otherwise.

Example request

{
  "fire_webhooks": true,
  "group_title": "Split transaction title.",
  "transactions": [
    {
      "transaction_journal_id": "123",
      "type": "withdrawal",
      "date": "2026-08-01T00:00:00+00:00",
      "amount": "123.45",
      "description": "Vegetables",
      "currency_id": "12",
      "currency_code": "EUR",
      "currency_symbol": "$",
      "currency_name": "Euro",
      "currency_decimal_places": 2,
      "foreign_amount": "123.45",
      "foreign_currency_id": "17",
      "foreign_currency_code": "USD",
      "foreign_currency_symbol": "$",
      "foreign_currency_decimal_places": 2,
      "budget_id": "4",
      "budget_name": "Groceries",
      "category_id": "43",
      "category_name": "Groceries",
      "source_id": "2",
      "source_name": "Checking account",
      "source_iban": "NL02ABNA0123456789",
      "destination_id": "2",
      "destination_name": "Buy and Large",
      "destination_iban": "NL02ABNA0123456789",
      "bill_id": "111",
      "bill_name": "Monthly rent",
      "tags": [
        "Barbecue preparation"
      ],
      "notes": "Some example notes"
    }
  ]
}

Response

Updated transaction stored, result in response

Changes