/authenticate:
  post:
    tags:
    - user
    description: Authenticate a user by username and password
    operationId: authenticate
    requestBody:
      required: true
      content:
        application/json: 
          schema: 
            $ref: '#/components/schemas/AuthenticateRequest'
    responses:
      200:
        description: successfylly authenticate a user
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthenticateResponse'
      400:
        description: missing either username or password
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ErrorResponse'
      401:
        description: could not authenticate user
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ErrorResponse'