get:
  summary: Retrieve a system historical description by ID
  description: |-
    This will return a specific revision of a system description, given its ID.
  tags:
    - System History
  parameters:
    - $ref: ../../../part1/openapi/parameters/systemId.yaml
    - $ref: ../parameters/revId.yaml
    #- $ref: '#/components/parameters/select'
  responses:
    '200':
      $ref: ../../../part1/openapi/responses/system.yaml
    '400':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/400
    '401':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/401
    '403':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/403
    '404':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/404
    '5XX':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/5XX

put:
  summary: Update a system historical description
  description: |-
    This will completely replace a specific revision of a system description.

    The server will reject the update if the `validTime` property of the provided system
    description is different from the original.
  tags:
    - System History
  parameters:
    - $ref: ../../../part1/openapi/parameters/systemId.yaml
    - $ref: ../parameters/revId.yaml
  requestBody:
    $ref: ../../../part1/openapi/requests/system.yaml
  responses:
    '204':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/204_PUT
    '400':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/400
    '401':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/401
    '403':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/403
    '404':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/404
    '5XX':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/5XX

delete:
  summary: Delete a system historical description
  description: |-
    This will delete a specific revision of a system description.
  tags:
    - System History
  parameters:
    - $ref: ../../../part1/openapi/parameters/systemId.yaml
    - $ref: ../parameters/revId.yaml
  responses:
    '204':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/204_DELETE
    '400':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/400
    '401':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/401
    '403':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/403
    '404':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/404
    '409':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/409_DELETE
    '5XX':
      $ref: ../../../part1/openapi/responses/StandardResponses.yaml#/5XX