post:
  operationId: PostUsersUserPassword
  summary: Set the password for a User.
  description: Sets the password for a User given the correct token.
  x-authenticated: true
  requestBody:
    content:
      application/json:
        schema:
          required:
            - token
            - password
          properties:
            email:
              description: The Users email.
              type: string
              format: email
            token:
              description: The token generated from the 'password-token' endpoint.
              type: string
            password:
              description: The Users new password.
              type: string
              format: password
  tags:
    - User
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            properties:
              user:
                $ref: ../components/schemas/user.yaml