Set Password

Changed on

Set or change the account's login password.

  • Accounts WITHOUT a usable password (phone-OTP-only → password_hash NULL, or WeChat-only → "wechat-only" sentinel) set one for the first time and do NOT need current_password. This is what lets a phone-OTP user enable email/phone + password login from Settings.
  • Accounts that already have a password must supply the correct current_password to change it.
post/api/auth/password

Request

  • Base URL: https://api.omicos.cn (the document declares no server; this is the origin it was published from)
  • URL: https://api.omicos.cn/api/auth/password
  • Auth: none declared

Headers

authorizationstring nullable
x-omicos-devicestring nullable
x-omicos-device-kindstring nullable
x-omicos-device-namestring nullable

Request body

new_passwordstring required
current_passwordstring nullable

Response

Successful Response

object required

Changes

  • ef3006b6f052Revision changes
    • info

      added the new optional header request parameter x-omicos-device

    • info

      added the new optional header request parameter x-omicos-device-kind

    • info

      added the new optional header request parameter x-omicos-device-name