openapi: 3.1.0
info:
  title: Kinetic Systems Capability Reference
  version: 0.1.0
  description: Reference interface for Kinetic advanced capability APIs. These routes document the intended demo architecture and do not expose a live sensitive API through the static site.
servers:
  - url: https://kineticsystems.uk
    description: Public website and reference documentation
paths:
  /v1/capabilities:
    get:
      summary: List capability families
      responses:
        '200':
          description: Capability catalog
  /v1/evidence/graph/demo:
    post:
      summary: Build a sample evidence graph from synthetic material
      responses:
        '200':
          description: Source-linked claims, entities, contradictions, missing evidence, review flags, and audit metadata
  /v1/records/redact/demo:
    post:
      summary: Prepare a synthetic records packet for redaction review
      responses:
        '200':
          description: Document classes, suggested redactions, rationale notes, review queue, and release packet metadata
  /v1/triage/no-wrong-door/demo:
    post:
      summary: Route a synthetic issue into next steps and document checklists
      responses:
        '200':
          description: Issue classification, service path, missing documents, and handoff instructions
  /v1/cyber/incident/demo:
    post:
      summary: Structure a defensive cyber incident coordination docket
      responses:
        '200':
          description: Incident timeline, affected systems, indicator normalization, recovery checklist, and reporting packet
  /v1/schemas/{schema_id}:
    get:
      summary: Retrieve a versioned schema definition
      parameters:
        - name: schema_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Schema definition
  /v1/ontologies/{ontology_id}:
    get:
      summary: Retrieve a domain object model
      parameters:
        - name: ontology_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Ontology definition