---
title: "POST /v1/matters/{matterId}/holds/{holdId}:removeHeldAccounts"
method: POST
path: "/v1/matters/{matterId}/holds/{holdId}:removeHeldAccounts"
tags: ["matters"]
---

# POST /v1/matters/{matterId}/holds/{holdId}:removeHeldAccounts

`POST /v1/matters/{matterId}/holds/{holdId}:removeHeldAccounts`

## Request

- Base URL: `https://vault.googleapis.com`
- URL: `https://vault.googleapis.com/v1/matters/{matterId}/holds/{holdId}:removeHeldAccounts`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/ediscovery`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/ediscovery`
- TypeScript: <https://skmtc.dev/google/apis/vault/docs/v1/matters/:matterId/holds/:holdId:removeHeldAccounts/post.ts> (a function with typed inputs; its response is checked against the schema)

Removes the specified accounts from a hold. Returns a list of statuses in the same order as the request.

## Path parameters

- `matterId` string, required
- `holdId` string, required

## Request body

- RemoveHeldAccountsRequest: Remove a list of accounts from a hold.
  - `accountIds` string[]: The account IDs of the accounts to remove from the hold.

## Response `200`

Successful response

- RemoveHeldAccountsResponse: Response for batch delete held accounts.
  - `statuses` Status[]: A list of statuses for the deleted accounts. Results have the same order as the request.
    - `code` integer: The status code, which should be an enum value of google.rpc.Code.
    - `details` object[]: A list of messages that carry the error details. There is a common set of message types for APIs to use.
    - `message` string: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.

## Changes

- **2026-10-10** `ddd37fff1925`: 2 breaking
  - removed the request body
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/google/apis/vault/changes/v1/matters/:matterId/holds/:holdId:removeHeldAccounts/post.md)

---

[API](https://skmtc.dev/google/apis/vault.md) - [All operations](https://skmtc.dev/google/apis/vault/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/vault/revisions/726c68a20360?raw)