Delete one account's saved credentials and the account

DELETE

/accounts/{id}/credentials

curl --request DELETE \
  --url https://api.banklink.co.za/v1/accounts/3fa85f64-5717-4562-b3fc-2c963f66afa6/credentials \
  --header 'Authorization: Bearer <token>'

• Production (use an sk_live_ key)
• Sandbox (same URL — use an sk_test_ key)

Requires credentials:delete. Scoped to the authenticated organisation. Removes the account: its encrypted credentials, stored transactions and sync history are permanently deleted, and pulses that used it are switched off. Repeating the call returns 404. Does not bill a credit. Requests already running may finish. Existing backup retention applies.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

UUID of the bank account (bank profile)

Example

3fa85f64-5717-4562-b3fc-2c963f66afa6

Responses

200

Account removed

Media typeapplication/json

object

data

object

success

boolean

deleted

integer

Example ^generated

{
  "data": {
    "success": true,
    "deleted": 1
  }
}

401

Missing or invalid API key

Media typeapplication/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Human-readable error description

string

Example

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

403

Missing credentials:delete scope

404

Resource not found

Media typeapplication/json

object

error

required

object

code

required

Machine-readable error code

string

message

required

Human-readable error description

string

Example

{
  "error": {
    "code": "not_found",
    "message": "Account not found"
  }
}