v51

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-01245104440.0 KB
Users

Update user

Update an existing user. Only the fields provided in the request body will be modified. Requires MANAGE_USERS access right.

put/v1/users/{user-id}

Path parameters

user-idinteger required

User ID

Request body

namestring

New login name

descriptionstring

User description

fullNamestring

Full name

systemRightsinteger

System access rights bitmask

uiAccessRulesstring

UI access rules

authMethodinteger

Authentication method

minPasswordLengthinteger

Minimum password length

disabledUntilinteger

Disabled until time (Unix timestamp)

certMappingMethodinteger

Certificate mapping method

certMappingDatastring

Certificate mapping data

emailstring

Email address

phoneNumberstring

Phone number

attributesobject

Custom attributes (replaces all existing attributes)

groupMembershipinteger[]

List of group IDs the user should belong to (replaces current membership)

Response

User updated successfully

idinteger

User ID

guidstring uuid

User GUID

namestring

Login name

descriptionstring

User description

systemRightsinteger

System access rights bitmask

uiAccessRulesstring

UI access rules

attributesobject

Custom attributes

ldapDnstring nullable

LDAP distinguished name

ldapIdstring nullable

LDAP unique ID

createdinteger

Account creation time (Unix timestamp)

fullNamestring

Full name

graceLoginsinteger

Remaining grace logins

twoFAGraceLoginsinteger

Remaining two-factor authentication grace logins

authMethodinteger

Authentication method (0=Local, 1=RADIUS, 2=Certificate, 3=Certificate or Local, 4=Certificate or RADIUS, 5=LDAP)

certMappingMethodinteger

Certificate mapping method

certMappingDatastring nullable

Certificate mapping data

disabledUntilinteger

Disabled until time (Unix timestamp, 0 if not temporarily disabled)

lastPasswordChangeinteger

Last password change time (Unix timestamp)

lastLogininteger

Last login time (Unix timestamp)

minPasswordLengthinteger

Minimum password length (-1 for system default)

authFailuresinteger

Consecutive authentication failure count

emailstring

Email address

phoneNumberstring

Phone number

groupsinteger[]

List of group identifiers this user belongs to