@jrpool/kilotest 59.1.3 → 60.0.0

package/openapi-3.0.yaml

@@ -0,0 +1,1847 @@
+openapi: 3.0.3
+info:
+  title: Kilotest API
+  description: 'Kilotest is an ensemble testing and reporting service for front-end web quality. It uses an ensemble of 12 rule engines to test web pages for front-end quality (accessibility, usability, and web standards, including HTML, CSS, ARIA, and WCAG). Kilotest acts as a web server for human users, an MCP server for AI platforms, and an API for programmatic access. With this API you can request that a page be tested or retested, discover available reports, incrementally retrieve facts from a report: from what reports are available, to what issues were reported in one report, to what elements violated one issue, to what diagnoses rule engines gave for one violation.'
+  version: 59.1.4
+  license:
+    name: MIT
+    url: https://github.com/jrpool/kilotest/blob/main/LICENSE
+  contact:
+    name: Kilotest
+    url: https://github.com/jrpool/kilotest
+    email: info@kilotest.com
+servers:
+  - url: https://kilotest.com
+    description: Kilotest production server
+security: []
+paths:
+  /api/listPages:
+    get:
+      operationId: listPages
+      summary: List all tested pages
+      responses:
+        '200':
+          description: List all tested pages
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - GET
+                      URL:
+                        type: string
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    $ref: '#/components/schemas/SimilarWebRequests'
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      basics about all tested pages:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            tested web page:
+                              type: object
+                              properties:
+                                description:
+                                  type: string
+                                URL:
+                                  type: string
+                              required:
+                                - description
+                                - URL
+                              additionalProperties: false
+                            number of reports about the page:
+                              type: number
+                            basics about the latest report:
+                              type: object
+                              properties:
+                                identifier:
+                                  type: string
+                                  description: 'Identifier of the report (example: 260503T0432-x9z).'
+                                completion date and time:
+                                  type: string
+                                days since the report was completed:
+                                  type: number
+                                  nullable: true
+                              required:
+                                - identifier
+                                - completion date and time
+                                - days since the report was completed
+                              additionalProperties: false
+                            how to get details about the latest report:
+                              type: object
+                              properties:
+                                method:
+                                  type: string
+                                  enum:
+                                    - GET
+                                URL:
+                                  type: string
+                              required:
+                                - method
+                                - URL
+                              additionalProperties: false
+                            web users can get details about the latest report at:
+                              type: string
+                          required:
+                            - tested web page
+                            - number of reports about the page
+                            - basics about the latest report
+                            - how to get details about the latest report
+                            - web users can get details about the latest report at
+                          additionalProperties: false
+                      how to request that a page with no report be tested:
+                        type: object
+                        properties:
+                          method:
+                            type: string
+                            enum:
+                              - POST
+                          URL:
+                            type: string
+                          request body:
+                            type: object
+                            properties:
+                              description:
+                                type: string
+                              URL:
+                                type: string
+                              reason:
+                                type: string
+                            required:
+                              - description
+                              - URL
+                              - reason
+                            additionalProperties: false
+                          how to check whether the request has been fulfilled:
+                            type: string
+                        required:
+                          - method
+                          - URL
+                          - request body
+                          - how to check whether the request has been fulfilled
+                        additionalProperties: false
+                      how a web user can request that the page be tested:
+                        type: object
+                        properties:
+                          URL:
+                            type: string
+                        required:
+                          - URL
+                        additionalProperties: false
+                    required:
+                      - basics about all tested pages
+                      - how to request that a page with no report be tested
+                      - how a web user can request that the page be tested
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/listIssues/{reportID}:
+    get:
+      operationId: listIssues
+      summary: List basics about the issues in one report
+      parameters:
+        - in: path
+          name: reportID
+          schema:
+            type: string
+            description: 'Identifier of the report (example: 260503T0432-x9z)'
+          required: true
+          description: 'Identifier of the report (example: 260503T0432-x9z)'
+      responses:
+        '200':
+          description: List basics about the issues in one report
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - GET
+                      URL:
+                        type: string
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    $ref: '#/components/schemas/SimilarWebRequests'
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      basics about the report:
+                        $ref: '#/components/schemas/ReportBasicsOrError'
+                      history of reports about the page:
+                        description: All reports about the same page, from oldest to latest, or null if the report is unavailable.
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            identifier:
+                              type: string
+                              description: 'Identifier of the report (example: 260503T0432-x9z).'
+                            completion date and time:
+                              type: string
+                            days since the report was completed:
+                              type: number
+                              nullable: true
+                            whether it is the oldest report about the page:
+                              type: boolean
+                            whether it is the latest report about the page:
+                              type: boolean
+                            whether it is the report described in this response:
+                              type: boolean
+                            how to get details about the report:
+                              type: object
+                              properties:
+                                method:
+                                  type: string
+                                  enum:
+                                    - GET
+                                URL:
+                                  type: string
+                              required:
+                                - method
+                                - URL
+                              additionalProperties: false
+                            web users can get details about the report at:
+                              type: string
+                          required:
+                            - identifier
+                            - completion date and time
+                            - days since the report was completed
+                            - whether it is the oldest report about the page
+                            - whether it is the latest report about the page
+                            - whether it is the report described in this response
+                            - how to get details about the report
+                            - web users can get details about the report at
+                          additionalProperties: false
+                        nullable: true
+                      details about the report:
+                        type: object
+                        properties:
+                          job definition:
+                            type: object
+                            properties:
+                              whether the job prohibited redirection:
+                                description: Copied from the report (strict); type not guaranteed.
+                              whether the native results of rule engines are reported:
+                                type: boolean
+                              whether standardized results are reported:
+                                type: boolean
+                              device emulated by the job:
+                                description: Device object copied verbatim from the report; shape may vary.
+                              browser type used by the job:
+                                description: Copied from the report (browserID); type not guaranteed.
+                            required:
+                              - whether the job prohibited redirection
+                              - whether the native results of rule engines are reported
+                              - whether standardized results are reported
+                              - device emulated by the job
+                              - browser type used by the job
+                            additionalProperties: false
+                          test results:
+                            type: object
+                            properties:
+                              rule engines that tried to test the page:
+                                type: array
+                                items:
+                                  $ref: '#/components/schemas/RuleEngineFacts'
+                              rule engines that could not test the page:
+                                type: array
+                                items:
+                                  type: object
+                                  properties:
+                                    name:
+                                      type: string
+                                      nullable: true
+                                    reason for failure:
+                                      description: Copied verbatim from the Testaro report; shape may vary.
+                                  required:
+                                    - name
+                                    - reason for failure
+                                  additionalProperties: false
+                              names of rule engines that reported rule violations:
+                                type: array
+                                items:
+                                  type: string
+                                  nullable: true
+                              counts of issues by priority:
+                                type: object
+                                properties:
+                                  highest:
+                                    type: number
+                                  high:
+                                    type: number
+                                  low:
+                                    type: number
+                                  lowest:
+                                    type: number
+                                required:
+                                  - highest
+                                  - high
+                                  - low
+                                  - lowest
+                                additionalProperties: false
+                              number of elements reported as violators:
+                                type: number
+                            required:
+                              - rule engines that tried to test the page
+                              - rule engines that could not test the page
+                              - names of rule engines that reported rule violations
+                              - counts of issues by priority
+                              - number of elements reported as violators
+                            additionalProperties: false
+                        required:
+                          - job definition
+                          - test results
+                        additionalProperties: false
+                        nullable: true
+                      how to request that the page be retested:
+                        anyOf:
+                          - anyOf:
+                              - type: object
+                                properties:
+                                  notice:
+                                    type: string
+                                required:
+                                  - notice
+                                additionalProperties: false
+                              - type: object
+                                properties:
+                                  method:
+                                    type: string
+                                    enum:
+                                      - POST
+                                  URL:
+                                    type: string
+                                  request body:
+                                    type: object
+                                    properties:
+                                      reason:
+                                        type: string
+                                    required:
+                                      - reason
+                                    additionalProperties: false
+                                  how to check whether the request has been fulfilled:
+                                    type: string
+                                required:
+                                  - method
+                                  - URL
+                                  - request body
+                                  - how to check whether the request has been fulfilled
+                                additionalProperties: false
+                          - type: object
+                            nullable: true
+                      how a web user can request that the page be retested:
+                        type: object
+                        properties:
+                          URL:
+                            type: string
+                        required:
+                          - URL
+                        additionalProperties: false
+                        nullable: true
+                      how to get the full report in JSON:
+                        type: object
+                        properties:
+                          size of the report in bytes:
+                            type: number
+                          method:
+                            type: string
+                            enum:
+                              - GET
+                          URL:
+                            type: string
+                        required:
+                          - size of the report in bytes
+                          - method
+                          - URL
+                        additionalProperties: false
+                        nullable: true
+                      how a web user can get the full report in JSON:
+                        type: object
+                        properties:
+                          URL:
+                            type: string
+                        required:
+                          - URL
+                        additionalProperties: false
+                        nullable: true
+                      basics about all issues reported in the report:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            identifier:
+                              type: string
+                            summary:
+                              type: string
+                            impact on a user:
+                              type: string
+                            priority:
+                              type: string
+                              enum:
+                                - lowest
+                                - low
+                                - high
+                                - highest
+                            rule engines with any violations belonging to the issue:
+                              type: array
+                              items:
+                                type: string
+                                nullable: true
+                            how to get details about the issue:
+                              type: object
+                              properties:
+                                method:
+                                  type: string
+                                  enum:
+                                    - GET
+                                URL:
+                                  type: string
+                              required:
+                                - method
+                                - URL
+                              additionalProperties: false
+                            web users can get details about the issue at:
+                              type: string
+                          required:
+                            - identifier
+                            - summary
+                            - impact on a user
+                            - priority
+                            - rule engines with any violations belonging to the issue
+                            - how to get details about the issue
+                            - web users can get details about the issue at
+                          additionalProperties: false
+                        nullable: true
+                    required:
+                      - basics about the report
+                      - history of reports about the page
+                      - details about the report
+                      - how to request that the page be retested
+                      - how a web user can request that the page be retested
+                      - how to get the full report in JSON
+                      - how a web user can get the full report in JSON
+                      - basics about all issues reported in the report
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/listViolators/{issueID}/{reportID}:
+    get:
+      operationId: listViolators
+      summary: List elements reported as exhibiting one issue
+      parameters:
+        - in: path
+          name: issueID
+          schema:
+            type: string
+            description: 'Issue identifier (example: contrastPoor)'
+          required: true
+          description: 'Issue identifier (example: contrastPoor)'
+        - in: path
+          name: reportID
+          schema:
+            type: string
+            description: 'Identifier of the report (example: 260503T0432-x9z)'
+          required: true
+          description: 'Identifier of the report (example: 260503T0432-x9z)'
+      responses:
+        '200':
+          description: List elements reported as exhibiting one issue
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - GET
+                      URL:
+                        type: string
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    $ref: '#/components/schemas/SimilarWebRequests'
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      basics about the report:
+                        $ref: '#/components/schemas/ReportBasicsOrError'
+                      basics about the issue:
+                        $ref: '#/components/schemas/IssueBasicsOrError'
+                      details about the issue:
+                        type: object
+                        properties:
+                          rule engines reporting violations belonging to the issue:
+                            type: array
+                            items:
+                              $ref: '#/components/schemas/RuleEngineFacts'
+                        required:
+                          - rule engines reporting violations belonging to the issue
+                        additionalProperties: false
+                        nullable: true
+                      basics about all elements exhibiting the issue:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            identifier:
+                              description: Catalog index of the element in the report; a string or number, copied verbatim.
+                              oneOf:
+                                - type: string
+                                - type: number
+                            tag name:
+                              description: Copied from the report catalog entry; type not guaranteed.
+                            inner text:
+                              description: Copied from the report catalog entry; type not guaranteed.
+                            count of rule engines reporting that the element exhibited the issue:
+                              type: number
+                            how to get details about the element:
+                              type: object
+                              properties:
+                                URL:
+                                  type: string
+                                request method:
+                                  type: string
+                                  enum:
+                                    - GET
+                              required:
+                                - URL
+                                - request method
+                              additionalProperties: false
+                            web users can get details about the element at:
+                              type: string
+                          required:
+                            - identifier
+                            - tag name
+                            - inner text
+                            - count of rule engines reporting that the element exhibited the issue
+                            - how to get details about the element
+                            - web users can get details about the element at
+                          additionalProperties: false
+                        nullable: true
+                    required:
+                      - basics about the report
+                      - basics about the issue
+                      - details about the issue
+                      - basics about all elements exhibiting the issue
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/listDiagnoses/{catalogIndex}/{issueID}/{reportID}:
+    get:
+      operationId: listDiagnoses
+      summary: List diagnoses of how one element exhibited one issue
+      parameters:
+        - in: path
+          name: catalogIndex
+          schema:
+            type: string
+            description: 'Identifier of the issue-exhibiting element in the catalog of elements on the page (example: 372)'
+          required: true
+          description: 'Identifier of the issue-exhibiting element in the catalog of elements on the page (example: 372)'
+        - in: path
+          name: issueID
+          schema:
+            type: string
+            description: 'Issue identifier (example: contrastPoor)'
+          required: true
+          description: 'Issue identifier (example: contrastPoor)'
+        - in: path
+          name: reportID
+          schema:
+            type: string
+            description: 'Identifier of the report (example: 260503T0432-x9z)'
+          required: true
+          description: 'Identifier of the report (example: 260503T0432-x9z)'
+      responses:
+        '200':
+          description: List diagnoses of how one element exhibited one issue
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - GET
+                      URL:
+                        type: string
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    $ref: '#/components/schemas/SimilarWebRequests'
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      basics about the report:
+                        $ref: '#/components/schemas/ReportBasicsOrError'
+                      basics about the issue:
+                        $ref: '#/components/schemas/IssueBasicsOrError'
+                      basics about the element:
+                        anyOf:
+                          - anyOf:
+                              - type: object
+                                properties:
+                                  identifier:
+                                    type: string
+                                  tag name:
+                                    description: Copied from the report catalog entry; type not guaranteed.
+                                  inner text:
+                                    description: Copied from the report catalog entry; type not guaranteed.
+                                required:
+                                  - identifier
+                                  - tag name
+                                  - inner text
+                                additionalProperties: false
+                              - type: object
+                                properties:
+                                  error:
+                                    type: string
+                                required:
+                                  - error
+                                additionalProperties: false
+                          - type: object
+                            nullable: true
+                      details about the element:
+                        type: object
+                        properties:
+                          start tag:
+                            description: Copied from the report catalog entry; type not guaranteed.
+                          XPath:
+                            description: Copied from the report catalog entry; type not guaranteed.
+                          x, y, width, and height of bounding box:
+                            description: Copied from the report catalog entry; type not guaranteed.
+                        required:
+                          - start tag
+                          - XPath
+                          - x, y, width, and height of bounding box
+                        additionalProperties: false
+                        nullable: true
+                      diagnoses of how the element exhibited the issue:
+                        anyOf:
+                          - anyOf:
+                              - type: array
+                                items:
+                                  type: object
+                                  properties:
+                                    identifier of the violated rule:
+                                      description: Copied from the report instance (ruleID); type not guaranteed.
+                                    description of the violation:
+                                      description: Copied from the report instance (what); type not guaranteed.
+                                    severity of the violation on a 0-to-3 scale:
+                                      description: Copied from the report instance (ordinalSeverity); type not guaranteed.
+                                    count of violations of the rule by the element:
+                                      type: number
+                                  required:
+                                    - identifier of the violated rule
+                                    - description of the violation
+                                    - severity of the violation on a 0-to-3 scale
+                                    - count of violations of the rule by the element
+                                  additionalProperties: false
+                              - type: object
+                                properties:
+                                  error:
+                                    type: string
+                                required:
+                                  - error
+                                additionalProperties: false
+                          - type: object
+                            nullable: true
+                    required:
+                      - basics about the report
+                      - basics about the issue
+                      - basics about the element
+                      - details about the element
+                      - diagnoses of how the element exhibited the issue
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/getReport/{reportID}:
+    get:
+      operationId: getReport
+      summary: Get one full report in JSON
+      parameters:
+        - in: path
+          name: reportID
+          schema:
+            type: string
+            description: 'Identifier of the report (example: 260503T0432-x9z)'
+          required: true
+          description: 'Identifier of the report (example: 260503T0432-x9z)'
+      responses:
+        '200':
+          description: Get one full report in JSON
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - GET
+                      URL:
+                        type: string
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    $ref: '#/components/schemas/SimilarWebRequests'
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      size of the report in bytes:
+                        oneOf:
+                          - type: number
+                          - type: string
+                      full report:
+                        description: The full raw Testaro/Testilo report JSON, copied verbatim, or an error object if it could not be retrieved.
+                    required:
+                      - size of the report in bytes
+                      - full report
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/requestNewTest:
+    post:
+      operationId: requestNewTest
+      summary: Request that a page be tested
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                description:
+                  type: string
+                  description: 1- to 100-character description of the page conforming to the naming convention used in the listPages output
+                URL:
+                  type: string
+                  description: 12- to 300-character URL of the page, including the https:// scheme and any query
+                reason:
+                  type: string
+                  description: 20- to 100-character reason why the page should be tested
+              required:
+                - description
+                - URL
+                - reason
+      responses:
+        '200':
+          description: Request that a page be tested
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - POST
+                      URL:
+                        type: string
+                      body:
+                        type: object
+                        properties:
+                          description:
+                            type: string
+                            description: 1- to 100-character description of the page conforming to the naming convention used in the listPages output
+                          URL:
+                            type: string
+                            description: 12- to 300-character URL of the page, including the https:// scheme and any query
+                          reason:
+                            type: string
+                            description: 20- to 100-character reason why the page should be tested
+                        required:
+                          - description
+                          - URL
+                          - reason
+                        additionalProperties: false
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - body
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    $ref: '#/components/schemas/SimilarWebRequests'
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      details about your request:
+                        anyOf:
+                          - type: object
+                            properties:
+                              error:
+                                type: string
+                            required:
+                              - error
+                            additionalProperties: false
+                          - type: object
+                            properties:
+                              date and time received:
+                                type: string
+                              page to be tested:
+                                type: object
+                                properties:
+                                  description:
+                                    type: string
+                                  URL:
+                                    type: string
+                                required:
+                                  - description
+                                  - URL
+                                additionalProperties: false
+                              reason why the page should be tested:
+                                type: string
+                            required:
+                              - date and time received
+                              - page to be tested
+                              - reason why the page should be tested
+                            additionalProperties: false
+                      disposition of your request:
+                        type: object
+                        properties:
+                          what happens next:
+                            type: string
+                          how you can check for completion:
+                            type: string
+                          how a web user can check for completion:
+                            type: string
+                        required:
+                          - what happens next
+                          - how you can check for completion
+                          - how a web user can check for completion
+                        additionalProperties: false
+                        nullable: true
+                    required:
+                      - details about your request
+                      - disposition of your request
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/requestRetest/{reportID}:
+    post:
+      operationId: requestRetest
+      summary: Request that a page be retested
+      parameters:
+        - in: path
+          name: reportID
+          schema:
+            type: string
+            description: 'Identifier of the latest report about the page (example: 260503T0432-x9z)'
+          required: true
+          description: 'Identifier of the latest report about the page (example: 260503T0432-x9z)'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                reason:
+                  type: string
+                  description: 20- to 100-character reason why the page should be retested
+              required:
+                - reason
+      responses:
+        '200':
+          description: Request that a page be retested
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - POST
+                      URL:
+                        type: string
+                      body:
+                        type: object
+                        properties:
+                          reason:
+                            type: string
+                            description: 20- to 100-character reason why the page should be retested
+                        required:
+                          - reason
+                        additionalProperties: false
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - body
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    $ref: '#/components/schemas/SimilarWebRequests'
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      details about your request:
+                        anyOf:
+                          - type: object
+                            properties:
+                              error:
+                                type: string
+                            required:
+                              - error
+                            additionalProperties: false
+                          - type: object
+                            properties:
+                              date and time received:
+                                type: string
+                              page to be retested:
+                                type: object
+                                properties:
+                                  description:
+                                    type: string
+                                  URL:
+                                    type: string
+                                required:
+                                  - description
+                                  - URL
+                                additionalProperties: false
+                              reason why the page should be retested:
+                                type: string
+                            required:
+                              - date and time received
+                              - page to be retested
+                              - reason why the page should be retested
+                            additionalProperties: false
+                      disposition of your request:
+                        type: object
+                        properties:
+                          what happens next:
+                            type: string
+                          how you can check for completion:
+                            type: string
+                          how a web user can check for completion:
+                            type: string
+                        required:
+                          - what happens next
+                          - how you can check for completion
+                          - how a web user can check for completion
+                        additionalProperties: false
+                        nullable: true
+                    required:
+                      - details about your request
+                      - disposition of your request
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/requestFeature:
+    post:
+      operationId: requestFeature
+      summary: Request a feature improvement or new feature
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                feature:
+                  type: string
+                  description: 20- to 1000-character description of requested feature improvement or new feature
+              required:
+                - feature
+      responses:
+        '200':
+          description: Request a feature improvement or new feature
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - POST
+                      URL:
+                        type: string
+                      body:
+                        type: object
+                        properties:
+                          feature:
+                            type: string
+                            description: 20- to 1000-character description of requested feature improvement or new feature
+                        required:
+                          - feature
+                        additionalProperties: false
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - body
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    type: object
+                    nullable: true
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      details about your request:
+                        anyOf:
+                          - type: object
+                            properties:
+                              error:
+                                type: string
+                            required:
+                              - error
+                            additionalProperties: false
+                          - type: object
+                            properties:
+                              date and time received:
+                                type: string
+                              disposition:
+                                type: string
+                            required:
+                              - date and time received
+                              - disposition
+                            additionalProperties: false
+                    required:
+                      - details about your request
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/orderNewTest:
+    post:
+      operationId: orderNewTest
+      summary: Order that a page be tested immediately, without manual approval
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                description:
+                  type: string
+                  description: 1- to 100-character description of the page conforming to the naming convention used in the listPages output
+                URL:
+                  type: string
+                  description: 12- to 300-character URL of the page, including the https:// scheme and any query
+                reason:
+                  type: string
+                  description: 20- to 100-character reason why the page should be tested
+              required:
+                - description
+                - URL
+                - reason
+      responses:
+        '200':
+          description: Order that a page be tested immediately, without manual approval
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - POST
+                      URL:
+                        type: string
+                      body:
+                        type: object
+                        properties:
+                          description:
+                            type: string
+                            description: 1- to 100-character description of the page conforming to the naming convention used in the listPages output
+                          URL:
+                            type: string
+                            description: 12- to 300-character URL of the page, including the https:// scheme and any query
+                          reason:
+                            type: string
+                            description: 20- to 100-character reason why the page should be tested
+                        required:
+                          - description
+                          - URL
+                          - reason
+                        additionalProperties: false
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - body
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    type: object
+                    properties:
+                      this request:
+                        type: object
+                        nullable: true
+                      closest ancestor request:
+                        type: string
+                        nullable: true
+                    required:
+                      - this request
+                      - closest ancestor request
+                    additionalProperties: false
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      details about your order:
+                        anyOf:
+                          - type: object
+                            properties:
+                              error:
+                                type: string
+                            required:
+                              - error
+                            additionalProperties: false
+                          - type: object
+                            properties:
+                              date and time received:
+                                type: string
+                              page to be tested:
+                                type: object
+                                properties:
+                                  description:
+                                    type: string
+                                  URL:
+                                    type: string
+                                required:
+                                  - description
+                                  - URL
+                                additionalProperties: false
+                              reason why the page should be tested:
+                                type: string
+                            required:
+                              - date and time received
+                              - page to be tested
+                              - reason why the page should be tested
+                            additionalProperties: false
+                      disposition of your order:
+                        type: object
+                        properties:
+                          what happens next:
+                            type: string
+                          report identifier:
+                            type: string
+                            description: 'Identifier of the report, to pass to listIssues once the report is ready (example: 260503T0432-x9z).'
+                            nullable: true
+                          how you can check for completion:
+                            type: string
+                          do you want to wait for completion:
+                            type: string
+                        required:
+                          - what happens next
+                          - report identifier
+                          - how you can check for completion
+                          - do you want to wait for completion
+                        additionalProperties: false
+                        nullable: true
+                    required:
+                      - details about your order
+                      - disposition of your order
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/orderRetest/{reportID}:
+    post:
+      operationId: orderRetest
+      summary: Order that a page be retested immediately, without manual approval
+      parameters:
+        - in: path
+          name: reportID
+          schema:
+            type: string
+            description: 'Identifier of the latest report about the page (example: 260503T0432-x9z)'
+          required: true
+          description: 'Identifier of the latest report about the page (example: 260503T0432-x9z)'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                reason:
+                  type: string
+                  description: 20- to 100-character reason why the page should be retested
+              required:
+                - reason
+      responses:
+        '200':
+          description: Order that a page be retested immediately, without manual approval
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - POST
+                      URL:
+                        type: string
+                      body:
+                        type: object
+                        properties:
+                          reason:
+                            type: string
+                            description: 20- to 100-character reason why the page should be retested
+                        required:
+                          - reason
+                        additionalProperties: false
+                      closest ancestor request:
+                        allOf:
+                          - $ref: '#/components/schemas/RequestReference'
+                        type: object
+                        nullable: true
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - body
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    type: object
+                    properties:
+                      this request:
+                        type: object
+                        nullable: true
+                      closest ancestor request:
+                        type: string
+                        nullable: true
+                    required:
+                      - this request
+                      - closest ancestor request
+                    additionalProperties: false
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      details about your order:
+                        anyOf:
+                          - type: object
+                            properties:
+                              error:
+                                type: string
+                            required:
+                              - error
+                            additionalProperties: false
+                          - type: object
+                            properties:
+                              date and time received:
+                                type: string
+                              page to be retested:
+                                type: object
+                                properties:
+                                  description:
+                                    type: string
+                                  URL:
+                                    type: string
+                                required:
+                                  - description
+                                  - URL
+                                additionalProperties: false
+                              reason why the page should be retested:
+                                type: string
+                            required:
+                              - date and time received
+                              - page to be retested
+                              - reason why the page should be retested
+                            additionalProperties: false
+                      disposition of your order:
+                        type: object
+                        properties:
+                          what happens next:
+                            type: string
+                          report identifier:
+                            type: string
+                            description: 'Identifier of the report, to pass to listIssues once the report is ready (example: 260503T0432-x9z).'
+                            nullable: true
+                          how you can check for completion:
+                            type: string
+                          do you want to wait for completion:
+                            type: string
+                        required:
+                          - what happens next
+                          - report identifier
+                          - how you can check for completion
+                          - do you want to wait for completion
+                        additionalProperties: false
+                        nullable: true
+                    required:
+                      - details about your order
+                      - disposition of your order
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+  /api/awaitTest/{reportID}:
+    post:
+      operationId: awaitTest
+      summary: Wait for a job ordered via orderNewTest or orderRetest to complete
+      parameters:
+        - in: path
+          name: reportID
+          schema:
+            type: string
+            description: 'Report identifier returned by orderNewTest or orderRetest (example: 260503T0432-x9z)'
+          required: true
+          description: 'Report identifier returned by orderNewTest or orderRetest (example: 260503T0432-x9z)'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties: {}
+      responses:
+        '200':
+          description: Wait for a job ordered via orderNewTest or orderRetest to complete
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tool collection:
+                    $ref: '#/components/schemas/ToolsFacts'
+                  tool name:
+                    type: string
+                  this request:
+                    type: object
+                    properties:
+                      description:
+                        type: string
+                      method:
+                        type: string
+                        enum:
+                          - POST
+                      URL:
+                        type: string
+                      closest ancestor request:
+                        minItems: 2
+                        maxItems: 2
+                        type: array
+                        items:
+                          $ref: '#/components/schemas/RequestReference'
+                    required:
+                      - description
+                      - method
+                      - URL
+                      - closest ancestor request
+                    additionalProperties: false
+                  URLs of similar requests for web users:
+                    type: object
+                    properties:
+                      this request:
+                        type: object
+                        nullable: true
+                      closest ancestor request:
+                        type: object
+                        nullable: true
+                    required:
+                      - this request
+                      - closest ancestor request
+                    additionalProperties: false
+                  response metadata:
+                    $ref: '#/components/schemas/ResponseMetadata'
+                  response content:
+                    type: object
+                    properties:
+                      details about your wait:
+                        anyOf:
+                          - type: object
+                            properties:
+                              error:
+                                type: string
+                            required:
+                              - error
+                            additionalProperties: false
+                          - type: object
+                            properties:
+                              report identifier:
+                                type: string
+                                description: 'Identifier of the report, to pass to listIssues once the report is ready (example: 260503T0432-x9z).'
+                            required:
+                              - report identifier
+                            additionalProperties: false
+                      disposition of your wait:
+                        type: object
+                        properties:
+                          outcome:
+                            type: string
+                            enum:
+                              - completed
+                              - failed
+                              - timedOut
+                          what happened:
+                            type: string
+                          how you can check for completion:
+                            type: string
+                        required:
+                          - outcome
+                          - what happened
+                          - how you can check for completion
+                        additionalProperties: false
+                        nullable: true
+                    required:
+                      - details about your wait
+                      - disposition of your wait
+                    additionalProperties: false
+                required:
+                  - tool collection
+                  - tool name
+                  - this request
+                  - URLs of similar requests for web users
+                  - response metadata
+                  - response content
+                additionalProperties: false
+components:
+  schemas:
+    ToolsFacts:
+      type: object
+      properties:
+        name:
+          type: string
+        description:
+          type: object
+          properties:
+            what Kilotest does:
+              type: string
+            how to retrieve findings:
+              type: object
+              properties:
+                level 1:
+                  type: string
+                level 2:
+                  type: string
+                level 3:
+                  type: string
+                level 4:
+                  type: string
+              required:
+                - level 1
+                - level 2
+                - level 3
+                - level 4
+              additionalProperties: false
+            how to generate more findings:
+              type: object
+              properties:
+                new testing:
+                  type: string
+                retesting:
+                  type: string
+                latency:
+                  type: string
+                confirmation:
+                  type: string
+              required:
+                - new testing
+                - retesting
+                - latency
+                - confirmation
+              additionalProperties: false
+          required:
+            - what Kilotest does
+            - how to retrieve findings
+            - how to generate more findings
+          additionalProperties: false
+          description: Explanation of what Kilotest does and how to use its tools.
+        URL:
+          type: string
+          description: URL of the Kilotest MCP server.
+        web users can obtain similar functionalities at:
+          type: string
+      required:
+        - name
+        - description
+        - URL
+        - web users can obtain similar functionalities at
+      additionalProperties: false
+    RequestReference:
+      type: object
+      properties:
+        tool name:
+          type: string
+        description:
+          type: string
+        method:
+          type: string
+          enum:
+            - GET
+            - POST
+        URL:
+          type: string
+      required:
+        - tool name
+        - description
+        - method
+        - URL
+      additionalProperties: false
+    SimilarWebRequests:
+      type: object
+      properties:
+        this request:
+          type: string
+          description: URL of the equivalent web UI page for this request.
+        closest ancestor request:
+          type: string
+          nullable: true
+      required:
+        - this request
+        - closest ancestor request
+      additionalProperties: false
+    ResponseMetadata:
+      type: object
+      properties:
+        identifier:
+          type: string
+          description: Unique identifier of this response (timestamp and random suffix).
+        date and time:
+          type: string
+          description: UTC date and time when the response was generated, in ISO 8601 format.
+      required:
+        - identifier
+        - date and time
+      additionalProperties: false
+    ReportBasicsOrError:
+      anyOf:
+        - $ref: '#/components/schemas/ReportBasics'
+        - type: object
+          properties:
+            error:
+              type: string
+          required:
+            - error
+          additionalProperties: false
+    ReportBasics:
+      type: object
+      properties:
+        identifier:
+          type: string
+          description: 'Identifier of the report (example: 260503T0432-x9z).'
+        completion date and time:
+          type: string
+        days since the report was completed:
+          type: number
+          nullable: true
+        tested web page:
+          type: object
+          properties:
+            description:
+              type: string
+            URL:
+              type: string
+          required:
+            - description
+            - URL
+          additionalProperties: false
+        whether a later report about the same page exists:
+          type: boolean
+      required:
+        - identifier
+        - completion date and time
+        - days since the report was completed
+        - tested web page
+        - whether a later report about the same page exists
+      additionalProperties: false
+    RuleEngineFacts:
+      type: object
+      properties:
+        identifier:
+          type: string
+        name:
+          type: string
+          nullable: true
+        sponsor:
+          type: string
+          nullable: true
+      required:
+        - identifier
+        - name
+        - sponsor
+      additionalProperties: false
+    IssueBasicsOrError:
+      anyOf:
+        - type: object
+          properties:
+            identifier:
+              type: string
+            summary:
+              type: string
+            impact on a user:
+              type: string
+            priority:
+              type: string
+              enum:
+                - lowest
+                - low
+                - high
+                - highest
+            related WCAG standard:
+              type: object
+              properties:
+                layer:
+                  type: string
+                  enum:
+                    - success criterion
+                    - guideline
+                identifier:
+                  type: string
+              required:
+                - layer
+                - identifier
+              additionalProperties: false
+          required:
+            - identifier
+            - summary
+            - impact on a user
+            - priority
+            - related WCAG standard
+          additionalProperties: false
+        - type: object
+          properties:
+            error:
+              type: string
+          required:
+            - error
+          additionalProperties: false