POST

api

sys

users

startPasswordReset

Start Password Reset

curl --request POST \
  --url https://spaces.nexudus.com/api/sys/users/startPasswordReset \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>"
}
'

import requests

url = "https://spaces.nexudus.com/api/sys/users/startPasswordReset"

payload = { "email": "<string>" }
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: '<string>'})
};

fetch('https://spaces.nexudus.com/api/sys/users/startPasswordReset', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "WasSuccessful": true,
  "Value": {},
  "Status": 123,
  "Message": {},
  "Errors": "<any>",
  "400 Bad Request": {}
}

Start Password Reset

Sends a password-reset email to the customer’s registered email address. The email contains a one-time link that the customer can follow to set a new password. The portal calls this from the “Forgot your password?” flow on the sign-in page.

Authentication

No authentication required. This is a public endpoint.

Request Body

string

required

The email address of the account for which the password reset should be triggered.

number

The numeric identifier of the location the customer belongs to. Providing this ensures the correct branded email template is used.

Response

Returns an ActionConfirmation envelope. The portal treats any successful response as confirmation that the email was sent — it does not reveal whether the email address is registered, to prevent enumeration attacks.

boolean

true when the reset email was dispatched (or when no account was found — the response is intentionally the same to prevent user enumeration).

string | null

Usually null.

number

HTTP-style status code mirrored in the body. 200 on success.

string | null

Human-readable message. Usually null on success.

any

Validation errors. null on success.

Example Response

{
  "WasSuccessful": true,
  "Value": null,
  "Status": 200,
  "Message": null,
  "Errors": null
}

TypeScript Integration

import endpoints from '@/api/endpoints'

const url = endpoints.system.users.startPasswordReset
// => '/api/sys/users/startPasswordReset'

await httpClient.post(url, { email: userEmail, businessId })

Usage in Portal

Context	Source file
Forgot password page / modal	`src/views/auth/ForgotPassword/`

Error Responses

error

The email field is missing or the request body is malformed.

Method	Endpoint	Description
`POST`	`/api/sys/users/completePasswordReset`	Complete the reset flow with the token from the email
`POST`	`/api/token`	Sign in after completing the password reset
`GET`	`/api/sys/users/sendOtp`	Send a one-time password for passwordless sign-in

Complete Password ResetSet a new password for a customer account using the token received in the password-reset email.

Start Password Reset

curl --request POST \
  --url https://spaces.nexudus.com/api/sys/users/startPasswordReset \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>"
}
'

import requests

url = "https://spaces.nexudus.com/api/sys/users/startPasswordReset"

payload = { "email": "<string>" }
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: '<string>'})
};

fetch('https://spaces.nexudus.com/api/sys/users/startPasswordReset', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "WasSuccessful": true,
  "Value": {},
  "Status": 123,
  "Message": {},
  "Errors": "<any>",
  "400 Bad Request": {}
}

​Start Password Reset

​Authentication

​Request Body

​Response

​Example Response

​TypeScript Integration

​Usage in Portal

​Error Responses

​Related Endpoints

Start Password Reset

Authentication

Request Body

Response

Example Response

TypeScript Integration

Usage in Portal

Error Responses

Related Endpoints