Skip to main content
DELETE
/
api
/
partner
/
v2
/
banks
/
users
/
{userId}
/
accounts
/
{userBankInfoId}
cURL
curl --request DELETE \
  --url https://staging-api.capa.fi/api/partner/v2/banks/users/{userId}/accounts/{userBankInfoId} \
  --header 'partner-api-key: <partner-api-key>'
Deletes a bank account for a user by userId and userBankInfoId. This performs a soft delete by setting the disabled field to true.

​
Error Codes

​
Common Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”API Key is missing”
401UNAUTHORIZED”Invalid API Key format”
401UNAUTHORIZED”Invalid API Key”
403INVALID_PARTNER_FLOW”The partner has an invalid flow.”

​
User Ownership Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”Partner information is required for this operation”
401UNAUTHORIZED”User is not associated with the partner”

​
Endpoint-Specific Errors

HTTP StatusCodeMessage
400INVALID_USER_INPUT_ERROR”Invalid User Input”
403USER_BANK_INFO_ACCESS_DENIED”The bank information does not belong to the specified user.”
403USER_BANK_INFO_ACCESS_DENIED”The bank information belongs to a different partner.”
404USER_BANK_INFO_NOT_FOUND”User bank information not found.”

Headers

​
partner-api-key
string
required

Api key for the affiliated partner that is performing the request

Path Parameters

​
userId
string
required

The user ID

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

​
userBankInfoId
string
required

The user bank info ID to delete

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

Response

200

Deletes a bank account for a user by userId and userBankInfoId. This performs a soft delete by setting the disabled field to true.