post:
  tags:
    - Auth
  summary: 'get an access token to make authenticated requests'
  operationId: auth.post
  requestBody:
    description: 'access token request body'
    content:
      'application/json':
        schema:
          $ref: '../schemas/objects/authTokenRequestBody.yaml'
  responses:
    200:
      description: Successful Response
      content:
        application/json:
          schema:
            $ref: '../schemas/objects/authTokenResponseBody.yaml'

    400:
      $ref: '../responses/InvalidInput.yaml'
    401:
      $ref: '../responses/Unauthorized.yaml'
    500:
      $ref: '../responses/InternalError.yaml'