---
title: "Update User Block Role"
method: PUT
path: "/api/v1/users/{user_id}/block-role"
tags: ["User APIs", "users"]
---

# Update User Block Role

`PUT /api/v1/users/{user_id}/block-role`

Set or clear the additive Block role (block_user / block_admin) on
a user. ``block_role = null`` unsets it. The enum type on the DB
column rejects any value outside the two valid enum members, so no
extra application-level validation is needed.

## Path parameters

- `user_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)