post:
  operationId: updateAuthUserPassword
  tags:
    - Auth User
  summary: Auth User Password Update
  description: Update a password of existing user in the authentication system by overwriting the password with new password.
  #  security:
  #    - oauth2: [sp:auth-user-password:update]
  parameters:
    - in: path
      name: id
      description: >-
        Identity ID
      required: true
      schema:
        type: string
  requestBody:
    required: true
    description: |
      Auth User Password Update Request. This overwrites the existing user password in the authentication system.

      Requires security scope of 'sp:auth-user-password:update'
    content:
      application/json:
        schema:
          $ref: '../schemas/PasswordUpdateRequest.yaml'
  responses:
    '200':
      description: Auth user updated.
      content:
        application/json:
          schema:
            $ref: '../schemas/AuthUser.yaml'
    '400':
      $ref: '../../v3/responses/400.yaml'
    '401':
      $ref: '../../v3/responses/401.yaml'
    '403':
      $ref: '../../v3/responses/403.yaml'
    '404':
      $ref: '../../v3/responses/404.yaml'
    '429':
      $ref: '../../v3/responses/429.yaml'
    '500':
      $ref: '../../v3/responses/500.yaml'
