---
title: "Remove a Linked Account"
method: DELETE
path: "/api/v1/users/:userId/linked-accounts/:linkedAccountId"
tags: ["LinkedAccounts"]
---

# Remove a Linked Account

`DELETE /api/v1/users/:userId/linked-accounts/:linkedAccountId`

## Request

- Base URL: `https://merchant-api.accruesavings.com`
- URL: `https://merchant-api.accruesavings.com/api/v1/users/:userId/linked-accounts/:linkedAccountId`
- Auth: none declared. Required headers: `Client-ID`, `Authorization`
- TypeScript: <https://skmtc.dev/byaccrue/apis/accrue-merchant-api/docs/api/v1/users/:userId/linked-accounts/:linkedAccountId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Removes a linked bank account for one of your users. This has the same effect as the user removing it themselves: any scheduled funding or round-ups using the account are stopped, and the account is deactivated with the bank linking provider. This cannot be undone — the user must link and verify the account again. The request is idempotent: removing an account that is already gone also returns 204, so it is safe to retry after a timeout.

## Path parameters

- `userId` string, uuid, required: The ID of the user who owns the linked account.
- `linkedAccountId` string, uuid, required: The ID of the linked account to remove.

## Headers

- `Client-ID` string, uuid, required: The unique identifier of the client making the request. This header is required to retrieve the client-specific configuration and ensure that the response is tailored to the client's settings and permissions.
- `Authorization` string, uuid, required: Secure secret to access privileged endpoints.

## Response `204`

No Content. Also returned when the linked account was already removed.

## Other responses

- `400`: Bad Request. The user has no wallet with your account.
- `403`: The linked account does not belong to the specified user.
- `404`: Not Found. The user does not exist.
- `409`: The account cannot be removed right now: either a payment funded by it is still in flight, or the account may also be in use outside your integration. Complete or cancel the payment, or ask the user to remove the account from their Accrue account.

---

[API](https://skmtc.dev/byaccrue/apis/accrue-merchant-api.md) - [All operations](https://skmtc.dev/byaccrue/apis/accrue-merchant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/byaccrue/apis/accrue-merchant-api/revisions/3e2d97ef2e6e?raw)