Update a specific transaction

PUT

/transactions/{id}

curl --request PUT \
  --url 'http://localhost:8000/api/v1/transactions/1?type=income' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "client_id": "example", "amount": 1, "type": "income", "intent": "regular", "date": "2026-04-15", "party_id": 1, "group_id": 1, "description": "example", "wallet_id": 1, "is_recurring": true, "recurrence_period": "example", "recurrence_interval": 1, "recurrence_ends_at": "example", "categories": [ 1 ], "updated_at": "2026-04-15T12:00:00Z" }'

• Local server
• Development server
• Dynamic server URL

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

integer

ID of the transaction

Query Parameters

type

required

string

Allowed values: income expense

Type of transaction (income/expense)

Request Body ^required

Media type application/json

object

client_id

Unique identifier for your local client

string

amount

required

number format: float

type

string

Allowed values: income expense

intent

string

default: regular

Allowed values: regular loan_received loan_repayment debt_owed debt_settled investment_buy investment_return gift

date

string format: date

party_id

integer

group_id

integer

description

string

wallet_id

integer

is_recurring

Set the transaction as a recurring transaction

boolean

recurrence_period

Set how often the transaction should repeat

string

recurrence_interval

Set how often the transaction should repeat

integer

recurrence_ends_at

When the transaction stops repeating

date-time

categories

Array<integer>

updated_at

required

string format: date-time

Responses

200

Transaction updated successfully

Media type application/json

object

id

ID of the transaction

integer

type

required

Type of the transaction (income or expense)

string

Allowed values: income expense

amount

required

Amount of the transaction

number format: float

description

Description of the transaction

string

datetime

Date and time of the transaction

string format: date

categories

List of categories of the transaction

Array<integer>

is_recurring

Set the transaction as a recurring transaction

boolean

user_id

ID of the user who created the transaction

integer

amount_in_budget_currency

Transaction amount converted to the currency of the budget

string

transfer_id

ID of the associated transfer, if any

integer

wallet_client_generated_id

Client-generated ID of the associated wallet

string format: uuid

party_client_generated_id

Client-generated ID of the associated party

string format: uuid

files

Files attached to the transaction

Array<object>

object

id

ID of the file

integer

path

Path or content of the file

string

link

URL to access the file

string

type

Type of file (image, icon, emoji, pdf)

string

Allowed values: image pdf icon emoji

model

Related model name

string

model_id

ID of the related model

integer

recurring_rules

object

id

ID of the transaction

integer

transaction_id

ID of the transaction

integer

recurrence_period

Set how often the transaction should repeat

string

recurrence_interval

Set how often the transaction should repeat

integer

recurrence_ends_at

When the transaction stops repeating

string format: date-time

next_scheduled_at

When next the transaction should happen

string format: date-time

Example

{
  "type": "income",
  "files": [
    {
      "type": "image"
    }
  ]
}

400

Invalid input

404

Transaction not found