# Update group

`PATCH /v1/organizations/{organization}/groups/{group}`, operation `groups.UpdateGroup`

Changes a group's name or description.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `organization` | path | Yes | `string` | The organization's ID. |
| `group` | path | Yes | `string` | The group's ID. |

## Request body

Content-Type: `application/json` (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `description` | `string` | No | What the group is for. |
| `displayName` | `string` | No | Name shown in user interfaces; unique within the organization, ignoring case. |

## Responses

### 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createTime` | `string (date-time)` | Yes | When the group was created. |
| `description` | `string` | Yes | What the group is for. |
| `displayName` | `string` | Yes | Name shown in user interfaces; unique within the organization, ignoring case. |
| `name` | `string` | Yes | Resource name, organizations/{organization_id}/groups/{group_id}. |
| `updateTime` | `string (date-time)` | Yes | When the group was last updated. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.