taler-docs

commit 1b46162eb686ab4fef203aac27c32228243f4798
parent 1ffacf11eeb801ad570c49af85b3c0b7cb45558c
Author: Antoine A <>
Date:   Wed, 25 Jun 2025 13:46:16 +0200

corebank: add missing token delete by id endpoint

Diffstat:
M
core/api-corebank.rst
 | 
25
+++++++++++++++++++++----

1 file changed, 21 insertions(+), 4 deletions(-)
diff --git a/core/api-corebank.rst b/core/api-corebank.rst
@@ -208,14 +208,13 @@ The user ``admin`` is a special, hard-coded username. Some requests require the 
   **Request:**
 
   :query limit: *Optional.*
-    At most return the given number of results. Negative for descending by ``row_id``, positive for ascending by ``row_id``. Defaults to ``-20``. Since **v5**.
+    At most return the given number of results. Negative for descending by ``token_id``, positive for ascending by ``token_id``. Defaults to ``-20``. Since **v5**.
   :query offset: *Optional.*
-    Starting ``cashout_id`` for :ref:`pagination <row-id-pagination>`. Since **v5**.
+    Starting ``token_id`` for :ref:`pagination <row-id-pagination>`. Since **v5**.
   :query delta: *Optional.*
     Deprecated since **v5**. Use *limit* instead.
   :query start: *Optional.*
     Deprecated since **v5**. Use *offset* instead.
-
     
   **Response:**
 
@@ -263,10 +262,28 @@ The user ``admin`` is a special, hard-coded username. Some requests require the 
       // Time when the token was last used.
       last_access: Timestamp;
 
-      // Opaque unique ID used for pagination.
+      // ID identifying the token
+      token_id: Integer;
+
+      // deprecated since **v9**. Use *token_id* instead.
       row_id: Integer;
     }
 
+.. http:delete:: /accounts/$USERNAME/tokens/$TOKEN_ID
+
+  Delete an access token.
+
+  **Response:**
+
+  :http:statuscode:`204 No content`:
+    The token have been deleted.
+  :http:statuscode:`404 Not found`:
+    Token ``$TOKEN_ID`` was not found.
+  :http:statuscode:`401 Unauthorized`:
+    Invalid or missing credentials.
+  :http:statuscode:`403 Forbidden`:
+    Missing rights.
+
 Bank Web UI
 -----------