Set a new password with a one-time reset link
POST
/auth/password-reset
const url = 'https://example.com/api/v1/auth/password-reset';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"token":"example","newPassword":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/v1/auth/password-reset \ --header 'Content-Type: application/json' \ --data '{ "token": "example", "newPassword": "example" }'Reset links are issued by an administrator. Redeeming one sets the new password and ends every session and API token of the user.
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
token
required
The reset link’s secret, skr_….
string
newPassword
required
string
Examplegenerated
{ "token": "example", "newPassword": "example"}Responses
Section titled “Responses”Password changed.
The request is invalid.
Media typeapplication/problem+json
An RFC 9457 problem with a machine-readable code.
object
type
required
string
title
required
string
status
required
integer
detail
string
code
required
Stable machine-readable error code.
string
Example
{ "type": "about:blank", "title": "Conflict", "status": 409, "code": "conflict"}Shardkeep is free software under the AGPL-3.0. Minecraft is a trademark of Mojang AB; Shardkeep is not affiliated with or endorsed by Mojang or Microsoft.