API reference / Banks
POST
/v1/banks/{id}/disconnectDisconnect 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.
curl -X POST 'https://api.bankmcp.app/v1/banks/RESOURCE_ID/disconnect' \
-H "Authorization: Bearer $BANKING_API_KEY" \
-H 'Content-Type: application/json' \
--data '{}'
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
idpathrequiredstring — 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
disconnectedstringrequiredBank ID from list_banks, e.g. "DE:N26" (country code and bank name).
consents_revokedintegerrequiredRange: 0 – unbounded
notestringrequiredErrors
Errors contain error, code and an optional action. Read the error and retry guide.
| Status | Code |
|---|---|
| 400 | INVALID_INPUT |
| 401 | INVALID_API_KEY |
| 403 | INSUFFICIENT_PERMISSION |
| 404 | NOT_FOUND |
| 409 | CONFLICT |
| 413 | REQUEST_TOO_LARGE |
| 429 | RATE_LIMITED |
| 500 | REQUEST_FAILED |
| 502 | INVALID_RESPONSE |
| 503 | UNAVAILABLE |
Try this request
Sent directly to https://api.bankmcp.app. Your key stays in this page’s memory and is never saved.