Skip to main content

Manipulating Existing Data

Scopes Required: banking-upload

Update External Accounts​

Update existing account metadata without recreating the account. Use this when information like bank name, balance, or owner changes.

Endpoint: PATCH /users/{user-id}/banking/accounts

What's Possible​

  • Update account metadata (balance, bank name, IBAN, owner, type, supportedPayments, etc.).
  • Update associated transactions in the same request (except IDs and accountNumber).
  • Perform partial updates; omitted fields remain unchanged.

Model​

Identical to Adding Data's Create External Account except for IDs (accountId, accountNumber) which cannot be changed:

Please note that transactions can be updated partially within the same payload.

Journey / Narrative​

Identify accounts that need metadata corrections. Send a PATCH request with updated fields. The Banking module applies updates without overwriting unspecified fields, preserving existing data integrity.

Update Transactions​

Patch individual transactions to correct or enrich data.

Endpoint: PATCH /users/{user-id}/banking/accounts/{account-id}

What's Possible​

  • Update transaction fields like amount, bookingText, purpose, merchantCategoryCode, paymentPartner.
  • Perform partial updates; omitted fields remain unchanged.
  • Overwrite metadata for existing transactionIds only.

Model​

Also, identical to Adding Data's Add Transactions to an Existing Account except for IDs (transactionId, accountId) which cannot be changed.

Journey / Narrative​

Identify the transaction that needs updating. Send a PATCH request with updated fields. The Banking module modifies the transaction while preserving other fields not included in the request.