get:
  summary: List subsystems
  description: |-
    List or search all `System` resources that are subsystems (i.e., components) of a specific parent system.

    Note that individual members can also be retrieved by ID directly at the canonical `System` resources endpoint.
  tags:
    - Systems
  parameters:
    - $ref: ../parameters/systemId.yaml
    - $ref: ../parameters/idList.yaml
    - $ref: ../parameters/bbox.yaml
    - $ref: ../parameters/datetime.yaml
    - $ref: ../parameters/geom.yaml
    - $ref: ../parameters/keyword.yaml
    - $ref: ../parameters/parentIdList.yaml
    - $ref: ../parameters/procedureIdList.yaml
    - $ref: ../parameters/foiIdList.yaml
    - $ref: ../parameters/obsPropIdList.yaml
    - $ref: ../parameters/controlPropIdList.yaml
    - $ref: ../parameters/recursive.yaml
      description: If true, instructs the server to include nested subsystems, recursively.
    #- $ref: '#/components/parameters/select'
    - $ref: ../parameters/limit.yaml
  responses:
    '200':
      $ref: ../responses/systemCollection.yaml
    '400':
      $ref: ../responses/StandardResponses.yaml#/400
    '401':
      $ref: ../responses/StandardResponses.yaml#/401
    '403':
      $ref: ../responses/StandardResponses.yaml#/403
    '404':
      $ref: ../responses/StandardResponses.yaml#/404
    '5XX':
      $ref: ../responses/StandardResponses.yaml#/5XX
      
post:
  summary: Add a subsystem
  tags:
    - Systems
  parameters:
    - $ref: ../parameters/systemId.yaml
  requestBody:
    $ref: ../requests/system.yaml
  responses:
    '201':
      $ref: ../responses/StandardResponses.yaml#/201
    '400':
      $ref: ../responses/StandardResponses.yaml#/400
    '401':
      $ref: ../responses/StandardResponses.yaml#/401
    '403':
      $ref: ../responses/StandardResponses.yaml#/403
    '404':
      $ref: ../responses/StandardResponses.yaml#/404
    '5XX':
      $ref: ../responses/StandardResponses.yaml#/5XX