Delete conected account

Delete Connected Account

This endpoint allows a bank client to delete their connection request to a linked (remote) account. The deletion applies regardless of the current status of the connection — whether it is approved or still pending. The operation is scoped to the authenticated client's own connection requests.

Endpoint

DELETE /api/LinkedAccount/{linkedUserProfileId}

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 remove a linked external account connection from their profile. This is applicable whether the link was recently requested and is still pending approval, or has already been fully approved and active. Only the authenticated customer can delete their own linked account entries.

Path Parameters

Response

200 OK

The connection request was successfully deleted. No response body is returned.

Error Codes

Common Mistakes

• Providing a linkedUserProfileId that belongs to a different customer — only the authenticated client's own connection requests can be deleted.
• Using an invalid or non-integer value for linkedUserProfileId — the field must be a valid integer.
• Attempting to delete an already-deleted or non-existent connection request, which will result in a 400 Bad Request response.

Related Endpoints

• GET /api/LinkedAccount — Retrieve the list of linked account connection requests (use this to obtain valid linkedUserProfileId values)
• POST /api/LinkedAccount — Create a new linked account connection request

Example

curl -X DELETE https://api.banking.netevia.dev/api/LinkedAccount/12345 \
  -H "Authorization: Bearer YOUR_TOKEN"