---
title: "Update a group"
description: "Changes a group's name, your `externalId` for it or its company description in `context`. Null clears externalId. Null clears context too, so the workspace profile applies again. New mentions use the new context right away, and older ones are not scored again. You can rename the default group, but it takes no description, because it is the workspace itself and uses the company profile."
canonical: https://docs.rumoro.dev/api/groups/update-group
markdown: https://docs.rumoro.dev/api/groups/update-group.mdx
---

# Update a group

`PATCH /v1/groups/{id}`

Changes a group's name, your `externalId` for it or its company description in `context`. Null clears externalId. Null clears context too, so the workspace profile applies again. New mentions use the new context right away, and older ones are not scored again. You can rename the default group, but it takes no description, because it is the workspace itself and uses the company profile.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The group's id (grp_...). |

## Body

| Field | Required | Description |
| --- | --- | --- |
| `name` |  | The group's name, such as a client, campaign or product. Must be unique in the workspace. |
| `externalId` |  | Sets a new external id. Null removes it. |
| `context` |  | Sets a new company description for the group. Null removes it, and the workspace profile applies again. New mentions use it right away, and older ones are not scored again. The default group cannot have one (400 default_group_context), because it is the workspace itself and uses the profile. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The group after the change |
| 400 | The default group cannot have a company description (default_group_context) |
| 401 | The API key is missing or not valid |
| 404 | This workspace has no group with this id |
| 409 | This name or externalId is already used by a group (duplicate_group) |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).