Skip to main content
POST
https://api.bunship.com
/
api
/
v1
/
auth
/
reset-password
Reset Password
curl --request POST \
  --url https://api.bunship.com/api/v1/auth/reset-password \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "token": "<string>",
  "password": "<string>"
}
'
{
  "message": "Password reset successfully. Please login with your new password."
}
Completes the password reset flow by setting a new password using the token from the reset email. All existing sessions are invalidated after a successful password reset.

​
Auth

None required. The reset token in the request body serves as authentication.

​
Rate Limit

20 requests per minute per IP.

​
Request Body

​
token
string
required
The password reset token from the email link.
​
password
string
required
New password. Minimum 8 characters, maximum 128 characters.

​
Response

​
message
string
Confirmation message.
{
  "message": "Password reset successfully. Please login with your new password."
}

​
Errors

StatusCodeDescription
400VALIDATION_ERRORToken is invalid, expired, or password does not meet requirements

​
Example

curl -X POST https://api.bunship.com/api/v1/auth/reset-password \
  -H "Content-Type: application/json" \
  -d '{
    "token": "rst_abc123def456...",
    "password": "NewSecureP@ssw0rd"
  }'