> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/navixy-api/panel-api/resources/dealer/password.md). # Password API call to update dealer's password. ## API actions API base path: `panel/dealer/password`. *** *required permissions*: `password: "update"`. {% hint style="danger" %} 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." {% endhint %} The complexity rules actually enforced for a given dealer are returned as `password_policy` by [dealer/get\_info](/docs/navixy-api/panel-api/resources/dealer.md#post-panel-dealer-get_info). ## Update dealer password > Change the password of the authorized dealer.\ > \ > \*\*All panel sessions for this dealer are deleted on success, including the one making the request.\*\* The session hash stops working immediately and you must authenticate again to continue.\ > \ > The new password must differ from the current one, must satisfy the dealer's complexity rules, and must not match any recently used password. The enforced rules are returned as \`password\_policy\` by the dealer get info operation. Both values are trimmed and must contain printable characters only. ```json {"openapi":"3.1.0","info":{"title":"Navixy Admin Panel API","version":"1.2.0"},"tags":[{"name":"Dealer","description":"Operations for reading dealer information, managing activation codes, changing the dealer password, and reading or updating panel settings covering service configuration, notification originators, and branding images. All resources under the /panel/dealer/ path."}],"servers":[{"url":"https://api.eu.navixy.com/v2","description":"Navixy production server on European platform"},{"url":"https://api.us.navixy.com/v2","description":"Navixy production server on American platform"},{"url":"https://api.me.navixy.com/v2","description":"Navixy production server on Middle East platform"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","description":"Enter the panel session hash with the \"NVX \" prefix, e.g. \"NVX fa7bf873fab9333144e171372a321b06\". Obtain the hash from the accountAuth operation.","name":"Authorization","in":"header"}},"responses":{"OK":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"`true` if request finished successfully.","readOnly":true}}}}}},"ResponseError":{"description":"Error response object","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Always false."},"status":{"type":"object","description":"Error status. Present only when an error occurred.","properties":{"code":{"type":"integer","description":"An error code in this API (not a HTTP code)"},"description":{"type":"string","description":"An error description"}}},"errors":{"type":"array","description":"Per-parameter detail, returned with validation failures such as error code 7.","items":{"type":"object","properties":{"parameter":{"type":"string","description":"Name of the parameter that failed validation."},"error":{"type":"string","description":"What was wrong with it."}}}}}}}}}}},"paths":{"/panel/dealer/password/update":{"post":{"tags":["Dealer"],"summary":"Update dealer password","description":"Change the password of the authorized dealer.\n\n**All panel sessions for this dealer are deleted on success, including the one making the request.** The session hash stops working immediately and you must authenticate again to continue.\n\nThe new password must differ from the current one, must satisfy the dealer's complexity rules, and must not match any recently used password. The enforced rules are returned as `password_policy` by the dealer get info operation. Both values are trimmed and must contain printable characters only.","operationId":"dealerPasswordUpdate","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["old_password","new_password"],"properties":{"old_password":{"type":"string","description":"Current dealer password. Trimmed before comparison; printable characters only.","format":"password"},"new_password":{"type":"string","description":"New dealer password. Must differ from the current one, satisfy the dealer's password policy, and not match a recently used password.","format":"password"}}}}}},"responses":{"200":{"$ref":"#/components/responses/OK"},"400":{"description":"Bad request. The response body carries the API-level error code in `status.code`. Validation failures also include an `errors` array.","$ref":"#/components/responses/ResponseError"},"403":{"description":"Operation not permitted, error code 13: the session lacks the required permission.","$ref":"#/components/responses/ResponseError"},"default":{"$ref":"#/components/responses/ResponseError"}}}}}} ``` {% hint style="warning" %} On success, every panel session for this dealer is deleted, including the one that made the request. The session hash stops working immediately and you must authenticate again before making further calls. {% endhint %} #### Errors * 12 - Dealer not found - if the dealer record is missing. * 245 - New password must be different - if `old_password` = `new_password`. * 248 - Wrong password - if `old_password` is wrong. * 294 - Password was recently used - if `new_password` matches one of the recently used passwords. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/navixy-api/panel-api/resources/dealer/password.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.