taler-docs

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

delete-private-tokens-SERIAL.rst (832B)


      1 .. http:delete:: [/instances/$INSTANCE]/private/tokens/$SERIAL
      2 
      3   Delete a token for ``$INSTANCE`` API access by its ``$SERIAL``.
      4 
      5 
      6   @since **v19**
      7 
      8   **Required permission**: ``tokens-write``
      9 
     10   **Response:**
     11 
     12   :http:statuscode:`204 No content`:
     13     Token deleted.
     14   :http:statuscode:`401 Unauthorized`:
     15     Invalid or missing credentials.
     16   :http:statuscode:`403 Forbidden`:
     17     Missing permission.
     18   :http:statuscode:`400 Bad Request`:
     19     The ``$SERIAL`` parameter is malformed.
     20     Returned with ``TALER_EC_GENERIC_PARAMETER_MALFORMED``.
     21   :http:statuscode:`404 Not found`:
     22     The token was not found.
     23     Returned with ``TALER_EC_MERCHANT_GENERIC_ACCESS_TOKEN_UNKNOWN``.
     24   :http:statuscode:`500 Internal Server Error`:
     25     The server experienced an internal failure.
     26     Returned with ``TALER_EC_GENERIC_DB_STORE_FAILED``.