Edit Bank Data

There are two (almost) identical methods which allow to change already stored data. The /update method will only change fields for which data was provided in the request, which means no changes to fields containing null are made. The /replace method will set fields to the provided value, meaning properties missing or containing null will be stored as null.

Request Body Structure of a Update Call

POST /insights/v1/storage/update HTTP/1.1
Content-Type: application/json; charset=utf-8
Authorization: Token <Token>
Host: <Host>
{
    "insights_consumer_id": ?string,
    "account": ?ProvidedAccount,
    "transactions": Array<ProvidedTransactions>,
}

insights_consumer_id String, required

Needed insights_consumer_id to validate the other request data (like account and transactions belonging to this consumer) before update can proceed.

account ProvidedAccount, required

A valid account is needed to validate all transactions from the request data that belongs to this account. The account will be identfied by its insights_account_id.

transactions ProvidedTransactions[], required

The list of transactions to be used for the update. Empty fields will be ignored, meaning no changes to empty fields are made.

Response of a Update Call

If the call has ended it will return an empty body response:

HTTP/1.1 200 OK

Request Body Structure of a Replace Call

POST /insights/v1/storage/replace HTTP/1.1
Content-Type: application/json; charset=utf-8
Authorization: Token <Token>
Host: <Host>
{
    "insights_consumer_id": ?string,
    "account": ?ProvidedAccount,
    "transactions": Array<ProvidedTransactions>,
}

insights_consumer_id String, required

Needed insights_consumer_id to validate the other request data (like account and transactions belonging to this consumer) before update can proceed.

account ProvidedAccount, required

A valid account is needed to validate all transactions from the request data that belongs to this account. The account will be identfied by its insights_account_id.

transactions ProvidedTransactions[], required

The list of transactions to be replaced. Each transaction must be provided with the corresponding transaction_id. All fields will be changed to the provided values.

Response of a Replace Call

If the call has ended it will return an empty body response:

HTTP/1.1 200 OK

results matching ""

    No results matching ""