authentication

Create a new authentication token

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

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

Changed in 3 of the 50 revisions of this API.22

Jan 16, 20258e78b6754f1411See the full diff
- ▲
  removed the success response with the status 204
  response-success-status-removed
- ○
  added the success response with the status 200
  response-success-status-added
Jan 14, 20257239a7e351de1See the full diff
- ○
  endpoint added
  endpoint-added
Dec 9, 2024f062c35d8f471See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 99 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history