---
title: "Update Company Group"
method: PATCH
path: "/api/companies/{company_uuid}/groups/{group_uuid}"
tags: ["company-groups"]
---

# Update Company Group

`PATCH /api/companies/{company_uuid}/groups/{group_uuid}`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/companies/{company_uuid}/groups/{group_uuid}`
- Auth: HTTP bearer

## Path parameters

- `company_uuid` string, uuid, required
- `group_uuid` string, uuid, required

## Headers

- `X-User-Email` string, nullable
- `X-User-Name` string, nullable
- `X-Teamspace-Uuid` string, uuid, nullable

## Request body

- GroupUpdate: Schema for updating a group's name/description and optional relationship sets. When a UUID list is omitted it is left unchanged. When it is sent (including an empty list) it replaces the current owners, members or legal entities in the same transaction as the scalar fields.
  - `name` string, nullable
  - `description` string, nullable
  - `owner_user_uuids` string[], nullable
  - `member_user_uuids` string[], nullable
  - `legal_entity_uuids` string[], nullable

## Response `200`

Successful Response

- GroupResponse: Response schema for group operations
  - `name` string, required
  - `description` string, nullable
  - `uuid` string, uuid4, required
  - `company_uuid` string, uuid4, required
  - `is_default` boolean
  - `owners` UserBase[]
    - `uuid` string, uuid4, required
    - `name` string, required
    - `phone_number` string, nullable
    - `email` string, email, required
    - `avatar_file_name` string, nullable
    - `ui_language` 'en' | 'pt' | 'es', nullable
    - `avatar_url` string, nullable, required: Get the avatar URL based on the filename if one exists
  - `members` UserBase[]
    - `uuid` string, uuid4, required
    - `name` string, required
    - `phone_number` string, nullable
    - `email` string, email, required
    - `avatar_file_name` string, nullable
    - `ui_language` 'en' | 'pt' | 'es', nullable
    - `avatar_url` string, nullable, required: Get the avatar URL based on the filename if one exists
  - `legal_entities` LegalEntitySummary[]
    - `uuid` string, uuid4, required
    - `legal_name` string, required
    - `jurisdiction` CountryBase, required
      - `id` integer, required
      - `code` string, required
      - `name` string, required
      - `description` string, nullable
      - `report_file_name` string, nullable
      - `report_url` string, nullable, required: Get the report URL based on the filename if one exists
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/regdoor/apis/regdoor-api.md) - [All operations](https://skmtc.dev/regdoor/apis/regdoor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regdoor/apis/regdoor-api/revisions/7642336631af?raw)