get:
  operationId: getCompanyById
  tags:
    - companies
  summary: Get a company
  parameters:
    - $ref: '#/components/parameters/companyId'
  responses:
    200:
      description: OK
      content:
        application/json:
          schema:
            $ref: '../schemas/Company.yaml'
put:
  operationId: putCompanyById
  tags:
    - companies
  summary: Updates a company
  parameters:
    - $ref: '#/components/parameters/companyId'
  requestBody:
    required: true
    content:
      application/json:
        schema:
          type: object
          properties:
            name:
              type: string
  responses:
    200:
      description: OK
      content:
        application/json:
          schema:
            $ref: '../schemas/Company.yaml'
delete:
  operationId: deleteCompanyById
  tags:
    - companies
  summary: Deletes a company
  parameters:
    - $ref: '#/components/parameters/companyId'
  responses:
    204:
      description: Deleted

components:
  parameters:
    companyId:
      in: path
      name: companyId
      required: true
      description: Company UUID
      schema:
        type: string
