Update Transaction

Updates an existing transaction.

View as Markdown

PUT /v1/transactions/{id}

Needs an API key with the update scope.

Path parameters

id string Required

Body parameters

description string

Description of the transaction
transactionTimestamp integer

Epoch timestamp for the transaction date and time. If both of the fields are provided, transactionTimestamp will be used.
transactionDate string

Datetime with timezone for the transaction date and time.
transactionType string

Type of the transaction. If it is an incoming money, use Money In; if it is an outgoing money, use Money Out
mathcingEntityId string

32-character unique ID of the customer or supplier of the transaction's sender or receiver.
mathcingEntityCode string

User-generated custom customer or supplier code of the transaction's sender or receiver.
amount number

Amount of the transaction. It should be a positive decimal number. eg. 1059.34

Returns

The transaction as saved.

401: No usable Authorization: Bearer {token} header (1002).
403: The access token is unknown, or lacks the scope this route needs (1001).

PUT /v1/transactions/{id}

curl -X PUT https://api.nuvio.io/v1/transactions/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -H "Authorization: Bearer $NUVIO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Office supplies",
    "transactionTimestamp": 1,
    "transactionDate": "2026-11-05",
    "transactionType": "string",
    "mathcingEntityId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "mathcingEntityCode": "ACME-01",
    "amount": 100
  }'

const response = await fetch('https://api.nuvio.io/v1/transactions/7c9e6679-7425-40de-944b-e07fc1f90ae7', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.NUVIO_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "description": "Office supplies",
    "transactionTimestamp": 1,
    "transactionDate": "2026-11-05",
    "transactionType": "string",
    "mathcingEntityId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "mathcingEntityCode": "ACME-01",
    "amount": 100
  }),
});
const { data } = await response.json();

import os
import requests

response = requests.put(
    "https://api.nuvio.io/v1/transactions/7c9e6679-7425-40de-944b-e07fc1f90ae7",
    headers={"Authorization": f"Bearer {os.environ['NUVIO_API_TOKEN']}"},
    json={
        "description": "Office supplies",
        "transactionTimestamp": 1,
        "transactionDate": "2026-11-05",
        "transactionType": "string",
        "mathcingEntityId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "mathcingEntityCode": "ACME-01",
        "amount": 100,
    },
)
data = response.json()["data"]

Response

{
  "success": true,
  "errors": null,
  "data": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "accountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "accountName": "Acme Supplies",
    "description": "Office supplies",
    "transactionTimestamp": 1,
    "transactionDate": "2026-11-05",
    "amount": 100,
    "currency": "USD",
    "transactionType": "Money In",
    "matchedEntity": {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "code": "ACME-01"
    },
    "matchedIncomes": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "invoiceId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "matchedAmount": 100
      }
    ],
    "matchedExpenses": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "expenseId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "matchedAmount": 100
      }
    ]
  }
}