Delete conected user

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

ParameterTypeRequiredDescription
linkedUserProfileIdinteger (int32)YesThe 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

CodeWhen it happens
400The request is invalid or the specified linkedUserProfileId does not exist
401Token missing, expired, or invalid
403Insufficient permissions — only the partner associated with the connection may delete it
404The specified linkedUserProfileId was not found
500Internal server error

Common Mistakes

  • Providing a linkedUserProfileId that belongs to a different partner's connection — only the authenticating partner's own connections can be deleted.
  • Using a linkedUserProfileId that 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 valid linkedUserProfileId values
  • POST /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"
Path Params
int32
required
Response
200

Success

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here!