[taler-docs] branch master updated: document purse deletion API

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new 5bac85d  document purse deletion API
5bac85d is described below

commit 5bac85ddeee72792d8507f6b67d8ffec9fbb19ea
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Wed Dec 28 12:51:23 2022 +0100

    document purse deletion API
---
 core/api-exchange.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 7fbe6fe..68528fb 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -3930,6 +3930,34 @@ Wallet-to-wallet transfers
     }
 
 
+
+.. http:delete:: /purses/$PURSE_PUB
+
+  Delete a purse that is unmerged and not yet expired. Refunds any money that
+  is already in the purse.
+
+  **Request:**
+
+  The request body must be empty, as recommended for HTTP delete in general.
+  To authorize the request, the header must contain a
+  ``Taler-Purse-Signature: $PURSE_SIG`` where ``$PURSE_SIG`` is the Crockford 
base32-encoded
+  EdDSA signature of purpose TALER_SIGNATURE_WALLET_PURSE_DELETE.
+
+  **Response:**
+
+  :http:statuscode:`204 No Content`:
+    The operation succeeded, the exchange confirms that the purse
+    was deleted.
+  :http:statuscode:`403 Forbidden`:
+    The signature is invalid.
+    This response comes with a standard `ErrorDetail` response.
+  :http:statuscode:`404 Not Found`:
+    The purse is not known. Might have already been deleted previously.
+  :http:statuscode:`409 Conflict`:
+    It is too late to delete the purse, its fate (merge or expiration)
+    was already decided.
+
+
 .. http:POST:: /purses/$PURSE_PUB/merge
 
   Merge purse with account, adding the value of the purse into

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.