taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

patch-accounts-USERNAME-auth.rst (1263B)

      1 .. http:patch:: /accounts/$USERNAME/auth
      2 
      3   Allows changing the account's password.
      4 
      5 
      6   **Request:**
      7 
      8   .. ts:def:: AccountPasswordChange
      9 
     10     interface AccountPasswordChange {
     11       // Old password. If present it need to match the current
     12       // password before updating.
     13       old_password?: string;
     14       // New password.
     15       new_password: string;
     16     }
     17 
     18   **Response:**
     19 
     20   :http:statuscode:`202 Accepted`:
     21     2FA is required for this operation. This returns the `ChallengeResponse` response. @since **v10**
     22   :http:statuscode:`204 No content`:
     23     Operation successful.
     24   :http:statuscode:`404 Not found`:
     25     The account pointed by ``$USERNAME`` was not found.
     26   :http:statuscode:`401 Unauthorized`:
     27     Invalid or missing credentials.
     28   :http:statuscode:`403 Forbidden`:
     29     Missing rights.
     30   :http:statuscode:`409 Conflict`:
     31     * ``TALER_EC_BANK_NON_ADMIN_PATCH_MISSING_OLD_PASSWORD``: a non-admin user has tried to change their password whihout providing the current one.
     32     * ``TALER_EC_BANK_PATCH_BAD_OLD_PASSWORD`` : provided old password does not match current password.
     33     * ``TALER_EC_BANK_PASSWORD_TOO_SHORT``: new password is shorter than 8 characters.
     34     * ``TALER_EC_BANK_PASSWORD_TOO_LONG``: new password is longer than 64 characters.