---
title: "Rename or re-describe a group"
method: PATCH
path: "/api/organizations/{organization_id}/groups/{group_id}"
tags: ["organization-management"]
---

# Rename or re-describe a group

`PATCH /api/organizations/{organization_id}/groups/{group_id}`

## Request

- Base URL: `https://app.gocrisp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.gocrisp.com/api/organizations/{organization_id}/groups/{group_id}`
- Auth: OAuth 2
  - Authorization code: `https://login.gocrisp.com/authorize`
  - Token URL: `https://login.gocrisp.com/oauth/token`

## Path parameters

- `organization_id` string, required
- `group_id` string, required

## Request body

- UpdateGroupRequest: Fields left out are untouched. Organization reassignment is not exposed.
  - `displayName` string, nullable
  - `description` string, nullable

## Response `200`

Successful response, including any rejected FGA tuple operations.

- PlatformGroupWithFgaWriteReport
  - `id` string, required
  - `organizationId` string, required
  - `organizationName` string, nullable
  - `displayName` string, nullable
  - `description` string, nullable
  - `readonly` boolean
  - `deletionProtected` boolean
  - `memberCount` integer
  - `isAllMembers` boolean
  - `fgaSyncStatus` string
  - `fgaLastError` string, nullable
  - `fgaLastReconciledAt` string, date-time, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable
  - `rejectedTuples` RejectedTuple[]: Tuple operations rejected by Auth0 FGA during this request.
    - `operation` 'write' | 'delete', required
    - `tuple` RejectedTupleKey, required: Public tuple identity for a rejected write operation.
      - `user` string, required
      - `relation` string, required
      - `object` string, required
    - `reason` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-23** `359eb8319891`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gocrisp/apis/crisp-app-dock/changes/api/organizations/:organization_id/groups/:group_id/patch.md)

---

[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.dev/gocrisp/apis/crisp-app-dock/revisions/28638f87e7d4?raw)