Change Thing password

Location /api/apps/{appID}/things/{thingID}/ownership/password
Change the password of existing Thing in the current application.

Request Headers (Applies to all methods)

Authorization
header
Required: Yes

PUT

/api/apps/{appID}/things/{thingID}/ownership/password

Description

Change the password of existing Thing.

Security

Can be performed only by administrator credentials.

Content-Type application/vnd.kii.ChangeThingPasswordRequest+json

The required data to perform the thing password change.

Headers
Name Required? type Description
Authorization Yes string Authorization header. OAuth2 Bearer token
Params
Name Required? Type Description
newPassword Yes string New password of the target thing. The password must follow the pattern ^\\p{Print}{1,200} (the same as the existing validation rule). The password that is the same as the old one is accepted.
Sample Request
{
  "newPassword": "[string]"
}
Responses
204

Content-Type (None)

The thing password has been changed successfully.
Note This response has no contents.
404

Content-Type application/vnd.kii.ThingNotFoundException+json

The thing was not found.
Contents
Name Type Description
errorCode string Error code "THING_NOT_FOUND".
message string The error message.
field string The field used for searching the thing. This can be the "thingID" or "vendorThingID" field.
value string The field value used for searching the thing.
appID string The ID of the application.
401

Content-Type application/vnd.kii.UnauthorizedAccessException+json

Not authorized to change the thing password.
Contents
Name Type Description
errorCode string Error code "UNAUTHORIZED".
message string The error message.
authenticatedAppID string The authenticated appID.
authenticatedPrincipalID string The authenticated principal ID (userID or thingID).
400

Content-Type application/vnd.kii.ValidationException+json

The thing password was invalid.
Contents
Name Type Description
errorCode string Error code "INVALID_INPUT_DATA".
message string The error message.