- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- AddHeldAccountResult
- Try it!
Adds accounts to a hold. Returns a list of accounts that have been successfully added. Accounts can be added only to an existing account-based hold.
HTTP request
POST https://vault.googleapis.com/v1/matters/{matterId}/holds/{holdId}:addHeldAccounts
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
matterId
|
The matter ID. |
holdId
|
The hold ID. |
Request body
The request body contains data with the following structure:
| JSON representation |
|---|
{ "emails" : [ string ] , "accountIds" : [ string ] } |
| Fields | |
|---|---|
emails[]
|
A comma-separated list of the emails of the accounts to add to the hold. Specify either emailsor accountIds, but not both. |
accountIds[]
|
A comma-separated list of the account IDs of the accounts to add to the hold. Specify either emailsor accountIds, but not both. |
Response body
Response for batch create held accounts.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"responses"
:
[
{
object (
|
| Fields | |
|---|---|
responses[]
|
The list of responses, in the same order as the batch request. |
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/ediscovery
For more information, see the Authorization guide .
AddHeldAccountResult
The status of each account creation, and the HeldAccount, if successful.
| JSON representation |
|---|
{ "account" : { object ( |
| Fields | |
|---|---|
account
|
Returned when the account was successfully created. |
status
|
Reports the request status. If it failed, returns an error message. |

