- [Resource: HeldAccount](https://developers.google.com/workspace/vault/reference/rest/v1/matters.holds.accounts#HeldAccount)
  - [JSON representation](https://developers.google.com/workspace/vault/reference/rest/v1/matters.holds.accounts#HeldAccount.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/workspace/vault/reference/rest/v1/matters.holds.accounts#METHODS_SUMMARY)

## Resource: HeldAccount

An account covered by a hold. This structure is immutable. It can be an individual account or a Google Group, depending on the service.

To work with Vault resources, the account must have the [required Vault privileges](https://support.google.com/vault/answer/2799699) and access to the matter. To access a matter, the account must have created the matter, have the matter shared with them, or have the **View All Matters** privilege.

| JSON representation |
|---|
| ``` { "accountId": string, "holdTime": string, "email": string, "firstName": string, "lastName": string } ``` |

| Fields ||
|---|---|
| `accountId` | `string` The account ID, as provided by the [Admin SDK](https://developers.google.com/admin-sdk/). |
| `holdTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. When the account was put on hold. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `email` | `string` The primary email address of the account. If used as an input, this takes precedence over **accountId**. |
| `firstName` | `string` Output only. The first name of the account holder. |
| `lastName` | `string` Output only. The last name of the account holder. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/workspace/vault/reference/rest/v1/matters.holds.accounts/create` | Adds an account to a hold. |
| ### `https://developers.google.com/workspace/vault/reference/rest/v1/matters.holds.accounts/delete` | Removes an account from a hold. |
| ### `https://developers.google.com/workspace/vault/reference/rest/v1/matters.holds.accounts/list` | Lists the accounts covered by a hold. |