CoAP PUT /iam/users/:username/:setting


This endpoint is used to set/change the settings of a particular user of the device.


PUT /iam/users/:username/:setting

The following settings exists on a user:

  • username - string: Change the username uniquely identifying the user on this device. The username is restricted to the characters a-z, 0-9, _, -, and ..
  • display-name - string: Set a UTF-8 string describing a user with more freedom than the username.
  • fingerprint - string: Set the fingerprint of the client using this user.
  • password - string: Set a password to use for password invite pairing.
  • role - string: Set a role for the user.
  • sct - string: Set a server connect token for the user.


Request body should be the value to set for the particular setting encoded as CBOR. Example of valid username:



CoAP status codes:

  • 204: If the setting was set.
  • 400: The request body was invalid.
  • 403: Blocked by IAM configuration.
  • 404: The accessed username or provided role does not exist.
  • 409: Provided username/fingerprint not unique.


Each setting has its own IAM Action which the user must have access to to use this endpoint:

  • IAM:SetUserName
  • IAM:SetUserDisplayName
  • IAM:SetUserFingerprint
  • IAM:SetUserPassword
  • IAM:SetUserSct
  • IAM:SetUserRole

This endpoint always provide the additional attribute:

  • IAM:Username

Additionally, when setting the role setting the following attribute is provided:

  • IAM:RoleId