Skip to main content
PUT
Update a user
You cannot change email with this operation. To change active, use Update the status of a user. To change app access, use Assign an app to a user, Update the KODE OS role of a user, and Remove app access from a user.
Send the fields you want to change. A field you leave out keeps its value. A blank name or role is ignored. An empty phone or position clears the value. Names can have up to 40 characters, and position up to 200.
This operation returns 403 if you set role to CLIENT_ADMIN. The role field here is the organization role. The role in an app changes with Update the KODE OS role of a user.

Authorizations

Authorization
string
header
required

Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.

Path Parameters

userId
string
required

Identifier of the user to update.

Body

application/json
firstName
string
Maximum string length: 40
lastName
string
Maximum string length: 40
role
string
phone
string
position
string
Maximum string length: 200

Response

The updated user.

_id
string
organizationId
string
createdAt
string
read-only

Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.

Example:

"2026-10-28T13:51:31+0000"

updatedAt
string
read-only

Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.

Example:

"2026-10-28T13:51:31+0000"

firstName
string
lastName
string
email
string
phone
string
position
string
role
string
memberType
string
active
boolean
invitationStatus
string
assignedInApps
object[]