Update User
Updates a user's display name. Only name and surname are editable here, and both are required: email and identity number identify the user and are set at creation or through a migration.
Required permission: user:update
Request
PUT /v2/users/{user_id}
Parameters
| Name | Type | In | Description |
|---|---|---|---|
user_id | string | path | Required. User ID (24-character hex) |
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer <access_token> |
Content-Type | Required. application/json |
Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | New first name |
surname | string | Yes | New last name |
Example
curl --request PUT \
--url '{{baseUrl}}/v2/users/6a87455ad5f439809d488ac3' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "New Name",
"surname": "New Surname"
}'
Response
Status Code: 200 OK, empty body.
Errors
| Status | Code | Description |
|---|---|---|
| 400 | 10015 | Validation failed (name or surname missing) — see details |
| 400 | 10016 | user_id is not a valid id |
| 400 | 10001 | User not found (domain 1) |
See Errors for the error format and common codes.