((p "An access token is only valid for a certain duration." " " "Since the " (a (@ (href . "00001012050200")) "authentication process") " will need some processing time, there is a way to renew the token without providing full authentication data.") (p "Send a HTTP PUT request to the " (a (@ (href . "00001012920000")) "endpoint") " " (kbd "/a") " and include the current access token in the " (kbd "Authorization") " header:") (pre (code (@ (class . "language-sh")) "# curl -X PUT -H 'Authorization: Bearer TOKEN' http://127.0.0.1:23123/a\n(\"Bearer\" \"eyJhbGciOiJIUzUxMiJ9.eyJfdGsiOjEsImV4cCI6MTY4MTMwNDA4NiwiaWF0IjoxNjgxMzA0MDI2LCJzdWIiOiJvd25lciIsInppZCI6IjIwMjEwNjI5MTYzMzAwIn0.kZd3prYc79dt9efDsrYVHtKrjWyOWvfByjeeUB3hf_vs43V3SNJqmb8k-zTHVNWOK0-5orVPrg2tIAqbXqmkhg\" 456)")) (p "You may receive a new access token, or the current one if it was obtained not a long time ago." " " "However, the lifetime of the returned " (a (@ (href . "00001012921000")) "access token") " is accurate.") (p "If " (a (@ (href . "00001010040100")) "authentication is not enabled") " and you send a renew request, no checking is done and you receive an artificial token immediate, without any delay:") (pre (code (@ (class . "language-sh")) "# curl -X PUT -H 'Authorization: Bearer freeaccess' http://127.0.0.1:23123/a\n(\"Bearer\" \"freeaccess\" 316224000)")) (p "In this case, it is even possible to omit the access token.") (h2 (@ (id . "http-status-codes")) "HTTP Status codes") (dl (dt (kbd "200")) (dd (p "Renew process was successful, the body contains a " (a (@ (href . "00001012921000")) "list") " with the relevant data.")) (dt (kbd "400")) (dd (p "The renew process was not successful." " " "There are several reasons for this." " " "Maybe access bearer token was not valid.") (p "Probably you should " (a (@ (href . "00001012050200")) "authenticate") " again with user identification and password."))))