---
get:
  description: Get all users
  parameters:
    - name: groupIds
      in: query
      required: false
      schema:
        type: array
        items:
          type: integer
    - name: offset
      in: query
      required: false
      schema:
        type: integer
    - name: maxRecords
      in: query
      required: false
      schema:
        type: integer
  responses:
    '200':
      description: users response
      content:
        application/json:
          schema:
            type: object
            properties:
              result:
                type: array
                items:
                  type: object
                  descripton: TODO - document
              count:
                type: integer
post:
  description: Register/create a user
  requestBody:
    required: true
    content:
      application/x-www-form-urlencoded:
        schema:
          type: object
          properties:
            name:
              type: string
            pass:
              type: string
            passAgain:
              type: string
            email:
              type: string
  responses:
    '200':
      description: user registration response
      content:
        application/json:
          schema:
            type: object
            properties:
              result:
                type: object
                description: Contains success message or error messages concerning user validation.
    '403':
      description: forbidden
      content:
        application/json:
          schema:
            $ref: schemas-Error.yaml