taler-docs

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

delete-accounts-USERNAME.rst (941B)

      1 .. http:delete:: /accounts/$USERNAME
      2 
      3   Delete the account whose username is ``$USERNAME``.  The deletion
      4   succeeds only if the balance is *zero*.  Typically only available to
      5   the administrator, but can be configured to allow ordinary users too.
      6 
      7   **Response:**
      8 
      9   :http:statuscode:`202 Accepted`:
     10     2FA is required for this operation. This returns the `ChallengeResponse` response. @since **v10**
     11   :http:statuscode:`204 No content`:
     12     The account was successfully deleted.
     13   :http:statuscode:`401 Unauthorized`:
     14     Invalid or missing credentials.
     15   :http:statuscode:`403 Forbidden`:
     16     Missing rights.
     17   :http:statuscode:`404 Not found`:
     18     The account pointed by ``$USERNAME`` was not found.
     19   :http:statuscode:`409 Conflict`:
     20     * ``TALER_EC_BANK_RESERVED_USERNAME_CONFLICT`` : a reserved username was attempted, like ``admin`` or ``bank``.
     21     * ``TALER_EC_BANK_ACCOUNT_BALANCE_NOT_ZERO``: the account balance was not zero.