Open Platform
Skip to content

Change the super passcode ​

https://cnapi.ttlock.com/v3/lock/changeAdminKeyboardPwd

Super passcode, which only belongs to the administrator, can be entered on the keypad to unlock.

There is only one super passcode for a lock and it can't be deleted.

Alert:If the lock is not connected to any gateway, you should firstly Modify admin passcode via APP SDK before requesting this API(set changeType=1)。

1 Request example ​

POST, ContentType:application/x-www-form-urlencoded

javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/lock/changeAdminKeyboardPwd' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockId=163377' \
--data-urlencode 'password=45675' \
--data-urlencode 'changeType=2' \
--data-urlencode 'date=1625025703000'

2 Request parameters ​

NameTypeRequiredDescription
clientIdStringYclient_id from Create application
accessTokenStringYAccess token,refer to: Get access token
lockIdIntYLock ID, generated by Lock init
passwordStringYNew super passcode
changeTypeIntNMethod: 1-via phone bluetooth,must call APP SDK method first, 2-via gateway or WiFi lock, if it's a WiFi lock or it's connected to gateway, you can call this api directly, The default value is 1.
dateLongYCurrent time (timestamp in millisecond)

3 Response and example ​

ParameterTypeDescription
errcodeIntError code
errmsgStringError message
{
    "errcode": 0, 
    "errmsg": "none error message"
}
CopyRight © 2012-2026 TTLock.All Rights Reserved