taler-docs

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

delete-private-fountains-FOUNTAIN_ID.rst (751B)

      1 .. http:delete:: [/instances/$INSTANCE]/private/fountains/$FOUNTAIN_ID
      2 
      3   Deletes a fountain and disables future withdrawals with its credential.
      4   Subsequent wallet requests with the fountain secret fail with
      5   ``401 Unauthorized``; tokens already withdrawn remain valid until
      6   their issue key expires.
      7   This endpoint is available since protocol **vTokenFountains**.
      8 
      9   **Required permission:** ``fountains-write``
     10 
     11   **Response:**
     12 
     13   :http:statuscode:`204 No content`:
     14     The fountain was deleted.
     15   :http:statuscode:`404 Not found`:
     16     The fountain or merchant instance is unknown.
     17     Returned with ``TALER_EC_MERCHANT_GENERIC_FOUNTAIN_UNKNOWN``.
     18   :http:statuscode:`500 Internal Server Error`:
     19     The server experienced an internal failure.