/api/v1/user/{user_id}/password:
  parameters:
    - $ref: "#/components/parameters/user_id"
  get:
    summary: Get the password entry for a user
    responses:
      '200':
        description: The password entry for a specific user
        content:
          application/json:
            schema:
              type: object
              properties:
                item:
                  $ref: "#/components/schemas/Password"
      '400':
        $ref: "#/components/responses/BadRequest"
      '401':
        $ref: "#/components/responses/Unauthorized"
      '422':
        $ref: "#/components/responses/UnprocessableEntity"
    tags:
      - Users
  post:
    summary: Create a password entry for a user
    requestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Password"
    responses:
      '201':
        $ref: "#/components/responses/Created"
      '400':
        $ref: "#/components/responses/BadRequest"
      '401':
        $ref: "#/components/responses/Unauthorized"
      '409':
        $ref: "#/components/responses/Duplicate"
      '422':
        $ref: "#/components/responses/UnprocessableEntity"
    tags:
      - Users
  put:
    summary: Allows to update the whole password entry for a user
    requestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Password"
    responses:
      '200':
        $ref: "#/components/responses/Message"
      '400':
        $ref: "#/components/responses/BadRequest"
      '401':
        $ref: "#/components/responses/Unauthorized"
      '422':
        $ref: "#/components/responses/UnprocessableEntity"
    tags:
      - Users
  patch:
    summary: Allows to update parts of a password entry of a user
    requestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Password"
    responses:
      '200':
        $ref: "#/components/responses/Message"
      '400':
        $ref: "#/components/responses/BadRequest"
      '401':
        $ref: "#/components/responses/Unauthorized"
      '422':
        $ref: "#/components/responses/UnprocessableEntity"
    tags:
      - Users
  delete:
    summary: Allows to delete a password entry for a user
    responses:
      '204':
        description: Deleted password entry
      '401':
        $ref: "#/components/responses/Unauthorized"
    tags:
      - Users


