Delete Connected User
This endpoint allows a partner to remove a linked account connection request associated with their account. The connection can be in any status — either pending or already approved — and will be permanently deleted upon a successful request. Only the partner whose credentials are used to authenticate may delete their own connection requests.
Endpoint
DELETE /api/LinkedAccount/user/{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 partner needs to revoke or clean up a linked account connection, whether the connection is still awaiting approval or has already been established. This is useful when an authorized user is removed, a connection was created in error, or access needs to be terminated for compliance or security reasons.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| linkedUserProfileId | integer (int32) | Yes | The ID of the connection request to delete. Obtain this ID from the list of connection requests. |
Response
200 OK
The connection request was successfully deleted. No response body is returned.
Error Codes
| Code | When it happens |
|---|---|
| 400 | The request is invalid or the specified linkedUserProfileId does not exist |
| 401 | Token missing, expired, or invalid |
| 403 | Insufficient permissions — only the partner associated with the connection may delete it |
| 404 | The specified linkedUserProfileId was not found |
| 500 | Internal server error |
Common Mistakes
- Providing a
linkedUserProfileIdthat belongs to a different partner's connection — only the authenticating partner's own connections can be deleted. - Using a
linkedUserProfileIdthat has already been deleted — the ID will no longer exist and a 400 error will be returned. - Passing a non-integer value for
linkedUserProfileId— the field must be a valid 32-bit integer.
Related Endpoints
GET /api/LinkedAccount/user— Retrieve the list of linked account connection requests to obtain validlinkedUserProfileIdvaluesPOST /api/LinkedAccount/user— Create a new linked account connection request
Example
curl -X DELETE https://api.banking.netevia.dev/api/LinkedAccount/user/12345 \
-H "Authorization: Bearer YOUR_TOKEN" 200Success
