Reset Password API

Set a new password using the verified reset token from the password recovery process

Public

Reset Password API

Complete the password reset process by setting a new password. Requires a valid reset token obtained from the verification step.

Set New Password

Define your new credentials.

Token Required

Valid reset token needed.

Final Step

Complete recovery process.


Endpoint Overview

MUTATION/graphql

Reset the user's password using a valid token from the password reset email. This is the final step in the password recovery process.

Authentication:No Auth Required

Request Parameters

tokenString!Required

The reset token from the password reset email or verification step.

passwordString!Required

The new password to set for the account.


GraphQL Mutation

mutation resetPassword($token: String!, $password: String!) {
  resetPassword(token: $token, password: $password) {
    success
    message
  }
}

Variables:

{
  "token": "reset_token_abc123xyz",
  "password": "NewSecurePassword123!"
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation resetPassword($token: String!, $password: String!) { resetPassword(token: $token, password: $password) { success message } }",
    "variables": {
      "token": "reset_token_abc123xyz",
      "password": "NewSecurePassword123!"
    }
  }'

Response

200Password Reset Successfully
{
  "data": {
    "resetPassword": {
      "success": true,
      "message": "Password has been reset successfully"
    }
  }
}
400Invalid Token
{
  "errors": [
    {
      "message": "Invalid or expired reset token",
      "path": ["resetPassword"],
      "extensions": {
        "code": "INVALID_TOKEN"
      }
    }
  ],
  "data": null
}
400Weak Password
{
  "errors": [
    {
      "message": "Password does not meet security requirements",
      "path": ["resetPassword"],
      "extensions": {
        "code": "WEAK_PASSWORD"
      }
    }
  ],
  "data": null
}

Password Requirements

Minimum Length

At least 8 characters required.

Mixed Case

Include upper and lowercase letters.

Numbers

Include at least one digit.

Special Characters

Include symbols for strength.


Password Reset Flow

Request Reset

Receive Code

Verify Code

Reset Password


Best Practices

Strong Password

Choose a unique, strong password.

Don't Reuse

Avoid using previous passwords.

Store Safely

Use a password manager.

Login Promptly

Test new password immediately.



Token Expiration

Reset tokens expire after a limited time. If your token has expired, you'll need to request a new password reset.

Password Reset Complete?

Login to your account with your new password.

Login