Skip to content

Confirm and create transactions from reviewed suggestions

POST
/import/confirm
curl --request POST \
--url http://localhost:8000/api/v1/import/confirm \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "session_id": 1, "accepted": [ { "index": 1, "wallet_id": 1, "party_id": 1, "category_id": 1, "amount": 1, "type": "income", "description": "example", "date": "2026-04-15" } ], "auto_create_wallets": false, "auto_create_parties": false, "auto_create_categories": false }'

Each accepted item should reference existing wallet/party/category rows by ID. When an ID is omitted and the matching auto_create_* flag is true, the analyzer’s suggested name is used to create the resource (wallets additionally need a currency).

Media type application/json
object
session_id
required
integer
accepted
required
Array<object>
object
index
required

Zero-based position of the suggestion in the session.

integer
wallet_id

Existing wallet owned by the caller. Required unless auto_create_wallets is true and the suggestion has a wallet name and currency.

integer
nullable
party_id

Existing party owned by the caller.

integer
nullable
category_id

Existing category owned by the caller.

integer
nullable
amount

Override the suggested amount.

number format: float
nullable
type
string
nullable
Allowed values: income expense
description
string
nullable
date
string format: date
nullable
auto_create_wallets

Create a wallet from the suggestion when wallet_id is omitted.

boolean
auto_create_parties

Create a party from the suggestion when party_id is omitted.

boolean
auto_create_categories

Create a category from the suggestion when category_id is omitted.

boolean

Transactions created

Some suggestions failed (see errors)

Session not found

Validation error