get:
  operationId: GetLecturer
  summary: |
    Get a single lecturer
  security: []
  parameters:
    - $ref: ../../../../components/parameters/lecturer.yaml
  tags:
    - Lecturers
  responses:
    "200":
      $ref: ../../../../components/responses/api/lecturers/{lecturer}/index-get-200.yaml
    "404":
      $ref: ../../../../components/responses/404.yaml

put:
  operationId: PutLecturer
  summary: |
    Update a lecturer. [OPTIONAL:Management]
  description: |
    **THIS IS AN OPTIONAL ENDPOINT**: This endpoint might not be implemented, as it
    requires a server running!
  security:
    - authRequired: []
  parameters:
    - $ref: ../../../../components/parameters/lecturer.yaml
  tags:
    - Lecturers
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../../../components/schemas/api/lecturer.yaml"
  responses:
    "200":
      $ref: ../../../../components/responses/api/lecturers/{lecturer}/index-put-200.yaml
    "401":
      $ref: ../../../../components/responses/401.yaml
    "404":
      $ref: ../../../../components/responses/404.yaml

delete:
  operationId: DeleteLecturer
  summary: |
    Delete a lecturer. [OPTIONAL:Management]
  description: |
    **THIS IS AN OPTIONAL ENDPOINT**: This endpoint might not be implemented, as it
    requires a server running!
  security:
    - authRequired: []
  parameters:
    - $ref: ../../../../components/parameters/lecturer.yaml
  tags:
    - Lecturers
  responses:
    "204":
      $ref: ../../../../components/responses/204.yaml
    # TODO: What about dependencies?
    "401":
      $ref: ../../../../components/responses/401.yaml
    "404":
      $ref: ../../../../components/responses/404.yaml