Change password

API call to change subpaas password.

API call to change the password of a Subdealer (SubPaaS) account.

API actions

API base path: panel/subpaas/password.

---

required permissions: subpaas: "update".

The current password is not required: a parent dealer can reset a sub-dealer's password directly.

Passwords must be between 12 and 20 characters in length and include at least one uppercase letter, lowercase letter, digit, and special character. To maintain account security, the system tracks password history, so you can't reuse any of your last 10 passwords. If a previous password is detected, the system will return the error "Password was recently used."

Change sub-dealer password

post

/panel/subpaas/password/change

Set a new password for a sub-dealer.

The current password is not required: a parent dealer can reset a sub-dealer's password directly. The new password must satisfy the platform password policy and must not match a recently used one.

Authorizations

AuthorizationstringRequired

Enter the panel session hash with the "NVX " prefix, e.g. "NVX fa7bf873fab9333144e171372a321b06". Obtain the hash from the accountAuth operation.

Body

subpaas_idintegerRequired

Sub-dealer ID.

Example: 97834

new_passwordstring · passwordRequired

New password. Trimmed before validation.

Responses

200

Successful response

application/json

successbooleanRead-onlyOptional

true if request finished successfully.

Example: true

400

Bad request. The response body carries the API-level error code in status.code. Validation failures also include an errors array.

application/json

403

Operation not permitted, error code 13: the session lacks the required permission, or the dealer is not eligible to have sub-dealers.

application/json

default

Error response object

application/json

post/panel/subpaas/password/change

POST /v2/panel/subpaas/password/change HTTP/1.1
Host: api.eu.navixy.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "subpaas_id": 97834,
  "new_password": "password"
}

{
  "success": true
}

Errors

• 13 –

  • The dealer is not paas.

  • The dealer has different status than NOT_BLOCKED.

  • The dealer's tariff does not allow subpaases.

  • Found subpaas is in DELETED status.

• 294 - Password was recently used - if new_password matches one of the recently used passwords.