Skip to content
Developers

API reference / Banks

POST/v1/banks/{id}/disconnect

Disconnect a bank

Requires banks:disconnect. Resource restrictions also apply. Disconnect banks.

Disconnecting removes the bank connection. This action requires whole-bank access.

Request examples

These examples use HTTP directly. Keep API keys on your server.

Shell
curl -X POST 'https://api.bankmcp.app/v1/banks/RESOURCE_ID/disconnect' \
  -H "Authorization: Bearer $BANKING_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{}'
TypeScript
const response = await fetch('https://api.bankmcp.app/v1/banks/RESOURCE_ID/disconnect', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.BANKING_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
if (!response.ok) throw new Error(`Banking returned ${response.status}`);
const data = await response.json();

Parameters

idpathrequired

string — Bank ID from list_banks, e.g. "DE:N26" (country code and bank name).

Request body

Content-Type: application/json

object

Response

200 · application/json

disconnectedstringrequired

Bank ID from list_banks, e.g. "DE:N26" (country code and bank name).

consents_revokedintegerrequired

Range: 0 – unbounded

notestringrequired

Errors

Errors contain error, code and an optional action. Read the error and retry guide.

StatusCode
400INVALID_INPUT
401INVALID_API_KEY
403INSUFFICIENT_PERMISSION
404NOT_FOUND
409CONFLICT
413REQUEST_TOO_LARGE
429RATE_LIMITED
500REQUEST_FAILED
502INVALID_RESPONSE
503UNAVAILABLE

Try this request

Sent directly to https://api.bankmcp.app. Your key stays in this page’s memory and is never saved.

Resource identifier

This sends a real action with your key’s permissions. The selected bank will be disconnected.