PATCH /v1/transactions/{id}

Edit a transaction. Manual and Apple Pay entries can change every field; bank transactions can change only category and note. Sending any other field to a bank transaction returns 400.

Auth. Send the token in the X-Ledger-Token header.

Parameters

Request body

application/json: object

Responses

Example response

{
  "id": 0,
  "source": "manual",
  "external_id": "string",
  "account_id": "string",
  "posted": "2026-10-11",
  "transacted_at": "2026-10-11T00:00:00Z",
  "amount_cents": 0,
  "merchant": "string",
  "payee": "string",
  "memo": "string",
  "category": "string",
  "category_source": "manual",
  "rule_id": 0,
  "note": "string"
}

Code samples

Set KEY to your own token first.

curl

curl \
  -X PATCH \
  -H X-Ledger-Token:$KEY \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 0, "posted": "2026-10-11", "merchant": "string", "payee": "string", "memo": "string", "account_id": "string", "category": "string", "note": "string"}' \
  "https://api.sasek.org/ledger/v1/transactions/{id}"

JavaScript

const res = await fetch("https://api.sasek.org/ledger/v1/transactions/{id}", {
  method: "PATCH",
  headers: { "X-Ledger-Token": KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "amount_cents": 0,
    "posted": "2026-10-11",
    "merchant": "string",
    "payee": "string",
    "memo": "string",
    "account_id": "string",
    "category": "string",
    "note": "string"
  }),
});
const data = await res.json();

Python

import json
import os
import urllib.request

payload = {   'amount_cents': 0,
    'posted': '2026-10-11',
    'merchant': 'string',
    'payee': 'string',
    'memo': 'string',
    'account_id': 'string',
    'category': 'string',
    'note': 'string'}

request = urllib.request.Request(
    "https://api.sasek.org/ledger/v1/transactions/{id}",
    method="PATCH",
    headers={
        "X-Ledger-Token": os.environ["KEY"],
        "Content-Type": "application/json",
    },
    data=json.dumps(payload).encode(),
)
with urllib.request.urlopen(request) as response:
    print(json.load(response))