---
title: "Update a realm user"
method: PATCH
path: "/clusters/{cluster_id}/realms/{realm_name}/users/{user_id}"
tags: ["Realm Users"]
---

# Update a realm user

`PATCH /clusters/{cluster_id}/realms/{realm_name}/users/{user_id}`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/clusters/{cluster_id}/realms/{realm_name}/users/{user_id}`
- Auth: API key in header `API-Key`

Partially updates a realm user.

Required scope: `realm-users:write`

## Path parameters

- `cluster_id` string, uuid, required
- `realm_name` string, required: Keycloak realm name (not ID). Must start with a letter; allows letters, digits, and hyphens.
- `user_id` string, required

## Headers

- `API-Version` '2026-06-01.beta', required

## Request body

- UpdateRealmUserRequest: Patch request for updating a realm user. At least one field should be provided.
  - `email` string, email
  - `first_name` string
  - `last_name` string
  - `enabled` boolean: Whether the user can sign in.
  - `email_verified` boolean: Whether the email address has been verified.

## Response `200`

The request has succeeded.

- RealmUser: Public representation of a realm user.
  - `id` string, required
  - `username` string, required: Realm username. Allows letters, digits, dots, hyphens, underscores, and `@`.
  - `email` string, email, required
  - `first_name` string
  - `last_name` string
  - `enabled` boolean, required: Whether the user can sign in.
  - `email_verified` boolean: Whether the email address has been verified.
  - `organization` string: Organization associated with the user, when available.
  - `last_login_at` string, date-time: Most recent successful sign-in time, when available.
  - `created_at` string, date-time: Time when the user was created, when available.

## Other responses

- `401`: Access is unauthorized.
- `403`: Access is forbidden.
- `404`: The server cannot find the requested resource.
- `409`: The request conflicts with the current state of the server.
- `422`: Client error
- `429`: Client error
- `500`: Server error
- `501`: Server error

---

[API](https://skmtc.dev/skycloak/apis/skycloak-public-api.md) · [All operations](https://skmtc.dev/skycloak/apis/skycloak-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skycloak/apis/skycloak-public-api/revisions/33a69e2ce35f?raw)