Skip to main content

Reset a user's password

POST 

/users/:username/reset-password

Required role: admin. Only an account or token with the admin role can call this operation.

Example request
curl --request POST \
--header "Authorization: Bearer $HOSERVA_TOKEN" \
--header "Content-Type: application/json" \
--data @body.json \
"https://$HOSERVA_HOST:8008/api/v1/users/{username}/reset-password"

Root-only over the Unix socket. Checked against the peer's uid 0 specifically — the hoserva group and TCP are refused. Audit-logged and announced through every notification channel.

Request​

Responses​

Password reset.