post:
  operationId: createTeam
  description: Create a new team within an organisation.
  summary: Create a team
  tags:
    - Teams
  responses:
    '201':
      description: 201 response
      content:
        application/json:
          schema:
            $ref: ../components/schemas/Team.yaml
          examples:
            main:
              value:
                $ref: ../components/examples/createTeam_response.json
    '400':
      $ref: ../components/standard-responses.yaml#/400
    '401':
      $ref: ../components/standard-responses.yaml#/401
    '403':
      $ref: ../components/standard-responses.yaml#/403
    '404':
      $ref: ../components/standard-responses.yaml#/404
    '422':
      $ref: ../components/standard-responses.yaml#/422
  requestBody:
    content:
      application/json:
        schema:
          type: object
          properties:
            team:
              type: object
              properties:
                name:
                  type: string
                ownerId:
                  type: string
              required:
                - name
          required:
            - team
        examples:
          main:
            value:
              $ref: ../components/examples/createTeam_request.json