---
title: "Update Group Block Role"
method: PATCH
path: "/api/v1/groups/{group_id}/block-role"
tags: ["User APIs", "groups"]
---

# Update Group Block Role

`PATCH /api/v1/groups/{group_id}/block-role`

Set or clear a group's additive Block role (block_user / block_admin).

Reuses the ``UserBlockRoleUpdate`` schema because the shape is
identical — both set ``block_role`` on their entity. The Postgres enum
rejects unknown values, so no extra validation is needed.

## Path parameters

- `group_id` string, uuid, required

## Request body

- UserBlockRoleUpdate — Null clears the block role (user has no additive Block capability).
  - `block_role` 'block_user' | 'block_admin' — Additive Block role values stored directly on ``users.block_role`` and ``groups.block_role`` (``block_role_enum`` Postgres enum). Matches the snake_case value set used elsewhere in the Block domain.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)