A newer version of this documentation is available.

View Latest

Change Password

      +
      A local user of Couchbase Server can change their password.

      HTTP Method and URI

      POST /controller/changePassword

      Description

      Changes the current, locally defined user-password to a new user-password.

      Curl Syntax

      curl -X POST http://<ip-address-or-domain-name>:8091/controller/changePassword
        -u <username>:<password>
        -d <new-password>

      The specified new-password must be for a locally defined user, and must conform to the currently established password policy for the cluster. The default policy is described in Password Strength. For instructions on changing the current password policy, see Set Password Policy. For information on local and external domains, see Authentication Domains.

      Responses

      Success returns 200 OK. Failure to authenticate returns 401 Unauthorized. A malformed URI returns 404 Object Not Found.

      Examples

      The following example changes the locally defined password of user localUser from localUserPassword to localUserNewPassword:

      curl -v -X POST http://localhost:8091/controller/changePassword \
      -u localUser:localUserPassword \
      -d password=localUserNewPassword

      See Also

      The default policy is described in Password Strength. For instructions on changing the current password policy, see Set Password Policy. For information on local and external domains, see Authentication Domains.