---
title: "PUT /biome/users/{user_id}"
method: PUT
path: "/biome/users/{user_id}"
tags: ["Biome"]
---

# PUT /biome/users/{user_id}

`PUT /biome/users/{user_id}`

Update a user

This endpoint requires the permission "biome.user.write".

## Path parameters

- `user_id` string, required

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Request body

- object
  - `username` string, required — Existing username of user
  - `hashed_password` string, required — Hashed password to be used for user authentication
  - `new_password` string — Hash of the new password to be used for user authentication
  - `new_key_pairs` BiomeNewUserKey[]
    - `display_name` string — Display name for key
    - `encrypted_private_key` string — Encrypted private key
    - `public_key` string — Public key

## Response `200`

User updated successfully

- object
  - `message` string
  - `data` BiomeUserKey[]
    - `display_name` string — Display name for key
    - `encrypted_private_key` string — Encrypted private key
    - `public_key` string — Public key
    - `user_id` string — Internal unique identifier for the user

## Other responses

- `400` — Request was malformed
- `401` — The client is unauthorized
- `404` — Resource not found
- `500` — Internal server error occurred

## Changes

- **2021-12-16** `bb81d3866f1e` — 3 breaking
  - the `hashed_password` request property type/format changed from ``/`` to `string`/``
  - the `new_password` request property type/format changed from ``/`` to `string`/``
  - the `username` request property type/format changed from ``/`` to `string`/``
- **2021-05-13** `f5e618c6f5df` — 3 breaking
  - the `hashed_password` request property type/format changed from `string`/`` to ``/``
  - the `new_password` request property type/format changed from `string`/`` to ``/``
  - the `username` request property type/format changed from `string`/`` to ``/``

[Change history](https://skmtc.dev/cargill/apis/splinterd-api/changes/biome/users/:user_id/put.md)

---

[API](https://skmtc.dev/cargill/apis/splinterd-api.md) · [All operations](https://skmtc.dev/cargill/apis/splinterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cargill/splinterd-api/revisions/38a272c24bd9/schema)