# Update a group in the account

Launch stage: Beta

`PATCH /api/2.0/identity/accounts/{account_id}/groups/{group_id}`

Updates an existing group in the Databricks account. Only the fields named in the update mask
 are modified. Returns the updated Group resource.

 When AIM is enabled and the group is an external identity (its external_id is set), only
 external_id can be updated; its other fields are sourced from your identity provider.
 With AIM and group visibility filters, a new nonempty external_id must identify a visible group.
 Clearing external_id is allowed.

 Authorization: the caller must be an account admin or a manager of the group (holds the
 `roles/group.manager` role on it).

API scopes: identity

## Path parameters

- `account_id` (string, required)
  Required. The account ID for which the group is being updated.
- `group_id` (string, required)
  Required. Internal ID of the group in Databricks.

## Query parameters

- `update_mask` (string, required)
  Optional. The list of fields to update.

## Request body

Required. Group to be updated in Databricks
- `external_id` (string, optional)
  ExternalId of the group in the customer's IdP.
- `group_name` (string, optional)
  Display name of the group.

## Returns

Returns the Group object.

## Response

```json
{
  "account_id": "string",
  "group_id": "string",
  "external_id": "string",
  "group_name": "string"
}
```