authentication

Create a new authentication token

Changed on

Creates a new authentication token that is returned via the 'renterd_auth' cookie which is set by the server and the json response body. The token can be used as a cookie or as the 'apikey' query parameter for authentication.

post/api/auth

Request

  • The document declares no server URL.
  • Auth
    none declared

Query parameters

validityinteger required

A duration in milliseconds

Example:30000

The duration in milliseconds for which the token will be valid

Response

Successfully created a new token

tokenstring

A hex-encoded string representing the token

Changes