---
title: "Update a group"
description: "Rename a group, change your id for it (`externalId`, null clears) or its company description (`context`, null clears: the workspace profile applies again; new mentions are judged with it at once, old ones are not rescored). The default group can be renamed like any other but takes no description: it is the workspace itself and reads the company profile."
canonical: https://docs.mentio.dev/api/groups/update-group
markdown: https://docs.mentio.dev/api/groups/update-group.mdx
---

# Update a group

`PATCH /v1/groups/{id}`

Rename a group, change your id for it (`externalId`, null clears) or its company description (`context`, null clears: the workspace profile applies again; new mentions are judged with it at once, old ones are not rescored). The default group can be renamed like any other but takes no description: it is the workspace itself and reads the company profile.

## Parameters

- `id` (path, required): Group id (grp_...).

## Body

- `name`: The group's name: a customer, a campaign, a product. Unique per workspace.
- `externalId`: Replaces your id for the group; null clears it.
- `context`: Replaces the group's company description; null clears it (the workspace profile applies again). New mentions are judged with it at once; old ones are not rescored. Not on the default group (400 default_group_context): that one is the workspace itself and reads the profile.

## Responses

- 200: The updated group
- 400: A company description on the default group (default_group_context)
- 401: Missing or invalid API key
- 404: No such group in this workspace
- 409: A group with that name or externalId already exists (duplicate_group)

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx