Unlink connected application

Unlink Connected Plaid Application

This endpoint allows authorized users to unlink a connected Plaid application from the Netevia banking platform. Once unlinked, the Plaid application's access to the user's financial data is immediately revoked. This gives customers full control over which third-party financial integrations are active on their account.

Endpoint

POST /api/plaidApplications/unlink

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when a customer wants to disconnect a Plaid-linked external account or revoke Plaid's access to their financial information. This is typically triggered from an account settings or connected apps management screen. It is also appropriate to call this endpoint as part of an account closure or data-privacy removal workflow.

Query Parameters

Parameter	Type	Required	Description
applicationId	string	Yes	The unique identifier of the Plaid application to unlink.

Response

200 OK

A successful response confirms that the Plaid application has been unlinked and no longer has access to the user's financial data. The response body is empty or contains a success message.

{
  "message": "Plaid application successfully unlinked."
}

Error Codes

Code	When it happens
400	Missing or invalid `applicationId` query parameter
401	Token missing, expired, or invalid
403	Insufficient permissions — the authenticated user is not authorized to unlink this application
404	No Plaid application found matching the provided `applicationId`
500	Internal server error

Common Mistakes

Omitting the applicationId query parameter, which is required for the platform to identify which application to unlink.
Passing an applicationId that belongs to a different customer's account — the authenticated user must own the application being unlinked.
Attempting to unlink an application that has already been disconnected, which results in a 404 error.

Related Endpoints

POST /api/plaidApplications/link — Initiate the Plaid link flow to connect an external account
GET /api/plaidApplications — List all Plaid applications currently linked to the authenticated user's account
POST /api/auth/v2 — Obtain a Bearer token for authentication

Example

curl -X POST "https://api.banking.netevia.dev/api/plaidApplications/unlink?applicationId=plaid-app-abc123" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"