anchor.diff:            description: A response indicating an improperly formatted query
         summary: to register a new metric, send the smartURL to this endpiint
         tags:
  -      - smartURL
  -      
  -      
  -      
  +      - Execute a Maturity Level Evaluation
  +  /evaluations/{evaluationid}/result:
  +    get:
  +      parameters:
  +      - description: evaluation id (the Evaluator's internal id for this evaluation)
  +        example: '5'
  +        in: path
  +        name: evaluationid
  +        required: true
  +        schema:
  +          type: string
  +      responses:
  +        '200':
  +          content:
  +            application/json:
  +              schema:
  +                $ref: '#/components/schemas/evaluation_result'
  +          description: the requested FAIR Metric
  +        '302':
  +          description: 302 redirect
  +          headers:
  +            Location:
  +              schema:
  +                type: string
  +        '404':
  +          description: A response indicating an unknown evaluation id
  +      summary: Retrieve the result of an existing FAIR Evaluation
  +      tags:
  +      - Retrieve an Existing Maturity Level Evaluation
  +  /metrics:
  +    get:
  +      responses:
  +        '200':
  +          content:
  +            application/json:
  +              schema:
  +                $ref: '#/components/schemas/metrics_array'
  +          description: the requested FAIR Metric
  +        '302':
  +          description: 302 redirect
  +          headers:
  +            Location:
  +              schema:
  +                type: string
  +      summary: Retrieve all FAIR Maturity Level Tests
  +      tags:
  +      - Retrieve all Known Maturity Level Tests
  +    post:
  +      requestBody:
  +        content:
  +          application/json:
  +            schema:
  +              $ref: '#/components/schemas/metrics'
  +        description: The URL to the smartAPI descriptor of the Metric
  +      responses:
  +        '200':
  +          content:
  +            application/json:
  +              schema:
  +                $ref: '#/components/schemas/metrics_result'
  +          description: A description of the registered metric
  +        '302':
  +          description: 302 redirect
  +          headers:
  +            Location:
  +              schema:
  +                type: string
  +        '400':
  +          content:
  +            application/json:
  +              schema:
  +                $ref: '#/components/schemas/ErrorResult'
  +          description: A response indicating an improperly formatted query
  +      summary: To register a new test, send the smartURL to this endpiint
  +      tags:
  +      - Register a New Maturity Level Test
     /metrics/{metricid}:
       get:
         parameters:
  
positive.code:         schema:
            type: string
        responses:
          '302':
            description: "302 redirect"
            headers:
              Location:
                schema:
                  type: "string"
          '200':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/metrics_result'
            description: the requested FAIR Metric
          '404':
            description: A response indicating an unknown metric id
        summary: Retrieve FAIR Metrics by their Evaluator-id.
        tags:
        - metrics
  
  
    /collections:
      get:
        responses:
          '302':
            description: "302 redirect"
            headers:
              Location:
                schema:
                  type: "string"
          '200':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/collections_array'
            description: the requested Metric Collection
        summary: Retrieve all Metric Collections
        tags:
        - collections
      post:
        requestBody:
          content:
              application/json:
                schema:
                  $ref: '#/components/schemas/collections'
          description: register a new collection of FAIR Metrics
        responses:
          '302':
            description: "302 redirect"
            headers:
              Location:
                schema:
                  type: "string"
          '200':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/collections_result'
            description: A LDP-Container, in JSON-LD, describing the Metric Collection
          '400':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/ErrorResult'
            description: A response indicating an improperly formatted query
        summary: Create a new collection of Metrics to be used for Evaluations
        tags:
        - Metric Collections
  
  
    /collections/{collectionid}:
      get:
        parameters:
        - description: collection id (the Evaluator's internal id for this Metric Collection)
          example: '5'
          in: path
          name: collectionid
          required: true
          schema:
            type: string
        responses:
          '302':
            description: "302 redirect"
            headers:
              Location:
                schema:
                  type: "string"
          '200':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/collections_result'
            description: the requested FAIR Metric Collection as an LDP Container
          '404':
            description: A response indicating an unknown collection id
        summary: Retrieve FAIR Metrics Collections by their Evaluator-id.
        tags:
        - A Metric Collection
    
  
  
    /collections/{collectionid}/evaluate:
      post:
        parameters:
        - description: the collection being used for the evaluation
          example: '5'
          in: path
          name: collectionid
          required: true
          schema:
            type: string
        requestBody:
          content:
              application/json:
                schema:
                  $ref: '#/components/schemas/evaluate'
          description: The information pertaining to this evaluation
        responses:
          '302':
            description: "302 redirect"
            headers:
              Location:
                schema:
                  type: "string"
          '400':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/ErrorResult'
            description: A response indicating an improperly formatted query
        summary: to register a new metric, send the smartURL to this endpiint
        tags:
        - execute Evaluation
  
    /evaluations/{evaluationid}/result:
      get:
        parameters:
        - description: evaluation id (the Evaluator's internal id for this evaluation)
          example: '5'
          in: path
          name: evaluationid
          required: true
          schema:
            type: string
        responses:
          '302':
            description: "302 redirect"
            headers:
              Location:
                schema:
                  type: "string"      
          '200':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/evaluation_result'
            description: the requested FAIR Metric
          '404':
            description: A response indicating an unknown evaluation id
        summary: Retrieve the result of an existing FAIR Evaluation
        tags:
        - evaluations
  
  
    /searches:
      get:
        responses:
          '200':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/search_schema'
            description: a JSON Schema document for how to post a search query
        summary: Search over Collections and FAIR Maturity Tests
        tags:
        - search
      post:
        requestBody:
          content:
              application/json:
                schema:
                  $ref: '#/components/schemas/searchinput'
          description: submit keywords for a search
        responses:
          '200':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/searchresult'
            description: a block of JSON containing two lists - a list of Maturity Tests, and a list of Collections - that match the search keywords
          '400':
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/ErrorResult'
            description: A response indicating an improperly formatted query
        summary: Execute a search over Maturity Indicator Test descriptions and Collection descriptions
        tags:
        - Metric Collections
  
  
  
  components:
  
    schemas:
  
      search_schema:
        properties:
          properties:
            type: string
  
      searchinput:
        properties:
          keywords:
            type: string
  
      searchresult:
        properties:
          metrics:
            type: array
            items:
              $ref: '#/components/schemas/metrics_result'
          collections:
            type: array
            items:
              $ref: '#/components/schemas/collections_result'
            
  
      metrics:
        properties:
          smarturl:
            type: string
        required:
        - smarturl
        type: object
      metrics_array:
        type: array
        items:
          $ref: '#/components/schemas/metrics_result'
  
      metrics_result:
        properties:
          id:
            type: string
          name:
            type: string
          creator:
            type: string
          email:
            type: string
          smarturl:
            type: string
          created_at:
            type: string
          updated_at:
            type: string
          principle:
            type: string
  
      collections_array:
        type: array
        items:
          $ref: '#/components/schemas/collections_result'
  
      collections:
        properties:
          name:
            type: string
          contact:
            type: string
          organization:
            type: string
          include_metrics:
            $ref: '#/components/schemas/metrics_list'
        required:
        - name
        - contact
        - organization
        - include_metrics
        type: object
      collections_result:
        properties:
          "@id":
            type: string
          "@type":
            $ref: '#/components/schemas/types_list'
          "http://purl.org/dc/elements/1.1/authoredBy":
            $ref: '#/components/schemas/ids'
          "http://purl.org/dc/elements/1.1/license":
            $ref: '#/components/schemas/ids'
          "http://purl.org/dc/elements/1.1/title":
            $ref: '#/components/schemas/values'
          "http://purl.org/dc/elements/1.1/creator":
            $ref: '#/components/schemas/values'
          "http://purl.org/pav/version":
            $ref: '#/components/schemas/values'
          "http://rdfs.org/ns/void#description":
            $ref: '#/components/schemas/values'
          "http://www.w3.org/ns/dcat#entities":
            $ref: '#/components/schemas/values'
          "http://www.w3.org/ns/dcat#contactPoint":
            $ref: '#/components/schemas/ids'
          "http://www.w3.org/ns/dcat#identifier":
            $ref: '#/components/schemas/ids'
          "http://www.w3.org/ns/dcat#publisher":
            $ref: '#/components/schemas/ids'
          "http://www.w3.org/ns/ldp#contains":
            $ref: '#/components/schemas/metrics_list'
      metrics_list:
        type: array
        items:
          $ref: '#/components/schemas/ids'
      types_list:
        type: array
        items:
          $ref: '#/components/schemas/ids'
      ids:
        properties:
          "@id": 
            type: string
      values:
        properties:
          "@id": 
            type: string
  
            
      evaluate:
        properties:
          resource:
            type: string
          executor:
            type: string
          title:
            type: string
  
negative.code:       - executor
        - title
        type: object
      evaluation_result:
        type: string
      ids:
        properties:
          '@id':
            type: string
      metrics:
        properties:
          smarturl:
            type: string
        required:
        - smarturl
        type: object
      metrics_array:
        items:
          $ref: '#/components/schemas/metrics_result'
        type: array
      metrics_list:
        type: array
        items:
          type: string
      metrics_result:
        properties:
          '@id':
            type: string
          '@type':
            type: array
            items:
              type: string
          '@context':
            type: string
          created_at:
            type: string
          creator:
            type: string
          email:
            type: string
          id:
            type: string
          name:
            type: string
          principle:
            type: string
          smarturl:
            type: string
          updated_at:
            type: string
  
      search_schema:
        properties:
          properties:
            type: string
      searchinput:
        properties:
          keywords:
            type: string
      searchresult:
        properties:
          collections:
            items:
              $ref: '#/components/schemas/collections_result'
            type: array
          metrics:
            items:
              $ref: '#/components/schemas/metrics_result'
            type: array
  