Skip to main content
PATCH
Updates an external bank account.

Authorizations

Authorization
string
header
required

Application (M2M) OAuth2 access token (client credentials).

Headers

X-Organization-ID
string<uuid>

ID of the organization to perform this operation on behalf of. Required for BANK and PLATFORM app token callers targeting a specific organization. If omitted, the request uses the authenticated caller's own organization. Must be a valid non-empty UUID. Present but malformed values return 400.

Path Parameters

id
string<uuid>
required

The external bank account ID.

Body

The update request.

Request to update an external bank account. Uses Tesouro.Common.Types.Rest.Optional&lt;T&gt; with non-nullable inner types — FIS does not support clearing any of these fields, so absent fields preserve the stored value.

nameOnAccount
string

New name on the external bank account. Absent = preserve.

nickname
string

New nickname for the external bank account. Absent = preserve.

verification
object

Verification status update. Requires 'CanSetExternalBankAccountVerification' permission. Absent = preserve.

Response

External bank account updated.

Response representing an external bank account.

id
string<uuid>
required

Unique identifier for the external bank account.

accountNumber
string
required

Masked account number (last 4 digits visible).

accountStatus
enum<string>
required

Status of the external bank account.

Available options:
ACTIVE,
INACTIVE
nameOnAccount
string
required

Name on the bank account.

nickname
string
required

Nickname for the external bank account.

routingNumber
string
required

Bank routing number (ABA number).

type
enum<string>
required

Type of bank account (checking or savings).

Available options:
CHECKING,
SAVINGS
verificationStatus
enum<string>
required

Verification status of the external bank account.

Available options:
UNVERIFIED,
VERIFICATION_SENT,
VERIFIED,
FAILED