---
title: "Update Group"
method: PATCH
path: "/api/platform/groups/{group_id}"
tags: ["platform"]
---

# Update Group

`PATCH /api/platform/groups/{group_id}`

Patch a group's display name, description, and optionally organization.

A field absent from the request body leaves the column untouched; a
field set to ``null`` clears ``display_name`` / ``description``.
Reassigning ``organization_id`` additionally requires group ``owner``
plus ``editor`` on the destination organization.

## Path parameters

- `group_id` string, required

## Request body

- UpdatePlatformGroupRequest — Body for patching a group's mutable attributes. All fields are optional so the operator UI can submit a partial diff. A null value explicitly clears ``display_name`` / ``description``; an absent key leaves it untouched. ``organization_id`` moves the group to a different parent org (DB column + FGA org-link tuple). Pydantic can't distinguish "missing" from "null" without help; we use ``model_fields_set`` on the parsed instance to detect what the operator actually sent. See ``service.update_group``.
  - `displayName` string, nullable — New display name; null clears it.
  - `description` string, nullable — New description; null clears it.
  - `organizationId` string, nullable — Move group to this organization.

## Response `200`

Successful Response

- PlatformGroup — A group belonging to an organization, with FGA mirror status.
  - `id` string, required
  - `organizationId` string, required
  - `organizationName` string, nullable
  - `displayName` string, nullable
  - `description` string, nullable
  - `memberCount` integer
  - `isAllMembers` boolean
  - `fgaSyncStatus` string
  - `fgaLastError` string, nullable
  - `fgaLastReconciledAt` string, date-time, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) · [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gocrisp/crisp-app-dock/revisions/e56bd3c1a9db/schema)