Change Thing password

Location /api/apps/{appID}/things/VENDOR_THING_ID:{vendorThingID}/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/VENDOR_THING_ID:{vendorThingID}/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.