{
  "openapi": "3.1.0",
  "info": {
    "title": "Precision Concrete Coating Public Knowledge API",
    "version": "1.0.0",
    "summary": "Read-only access to Precision Concrete Coating's approved public business knowledge.",
    "description": "The Precision AI Developer Platform exposes the company's approved, publicly visible knowledge to external AI assistants and developers.\n\nThis API is **read-only** and requires no authentication. It contains no customer data, no internal operational data and no write operations.\n\nEvery response is derived from the single published Approved Knowledge payload, the same source that powers the company website, llms.txt and the MCP server.",
    "contact": {
      "name": "Precision Concrete Coating",
      "url": "https://www.precision-concretecoating.com"
    },
    "license": {
      "name": "Proprietary — public read-only use permitted",
      "identifier": "LicenseRef-Precision-Public-Read-Only"
    }
  },
  "servers": [
    {
      "url": "https://app.precision-concretecoating.com",
      "description": "Production"
    }
  ],
  "tags": [
    {
      "name": "Company",
      "description": "Company identity and current business status."
    },
    {
      "name": "Coverage",
      "description": "Where Precision Concrete Coating works."
    },
    {
      "name": "Knowledge",
      "description": "Approved public knowledge, FAQ and pricing statements."
    },
    {
      "name": "Warranty",
      "description": "Approved public warranty knowledge."
    },
    {
      "name": "Platform",
      "description": "Self-documenting platform description for AI agents and developers."
    }
  ],
  "paths": {
    "/api/public/v1/company": {
      "get": {
        "operationId": "getCompanyInformation",
        "summary": "Company information",
        "description": "Returns the approved public profile of Precision Concrete Coating: organization identity, owner, services and verified context records. Sourced from the Approved Knowledge database.\n\nAll responses share a common envelope: `ok`, `schema_version`, `payload_version`, `generated_at` and `data`.",
        "tags": [
          "Company"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Company information — successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "data"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "schema_version": {
                      "type": "string"
                    },
                    "payload_version": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "organization": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "legal_name": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "url": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "phone": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "email": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "description": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "headquarters": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "primary_city": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "primary_state": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "service_region": {
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          }
                        },
                        "owner": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "role": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "description": {
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          }
                        },
                        "services": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "region": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        },
                        "expertise": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "region": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        },
                        "coating_systems": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "region": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        },
                        "preparation_methods": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "region": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        },
                        "trust_signals": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "region": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        },
                        "community_involvement": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "region": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "default": {
                    "summary": "Company information example",
                    "value": {
                      "ok": true,
                      "schema_version": "1.4",
                      "payload_version": 3,
                      "generated_at": "2026-07-29T12:00:00.000Z",
                      "data": {
                        "organization": {
                          "name": "Precision Concrete Coating",
                          "primary_city": "Fort Worth",
                          "primary_state": "Texas",
                          "phone": "(817) 000-0000"
                        },
                        "owner": {
                          "name": "William",
                          "role": "Owner"
                        },
                        "services": [
                          {
                            "name": "Garage Floor Coating",
                            "slug": "garage-floor-coating",
                            "url": null,
                            "description": null
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No approved knowledge payload has been published yet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "The knowledge source is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/business-status": {
      "get": {
        "operationId": "getBusinessStatus",
        "summary": "Current business availability",
        "description": "Returns the current scheduling availability of the business plus the standard project turnaround statements. Reflects the Current Availability control in Approved Knowledge.\n\nAll responses share a common envelope: `ok`, `schema_version`, `payload_version`, `generated_at` and `data`.",
        "tags": [
          "Company"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Current business availability — successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "data"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "schema_version": {
                      "type": "string"
                    },
                    "payload_version": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "availability_status": {
                          "type": "string",
                          "enum": [
                            "normal",
                            "booking_ahead",
                            "limited"
                          ]
                        },
                        "availability_label": {
                          "type": "string"
                        },
                        "statement": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "turnaround": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "accepting_new_projects": {
                          "type": "boolean"
                        },
                        "last_updated_at": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "payload_version": {
                          "type": "integer"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "default": {
                    "summary": "Current business availability example",
                    "value": {
                      "ok": true,
                      "schema_version": "1.4",
                      "payload_version": 3,
                      "generated_at": "2026-07-29T12:00:00.000Z",
                      "data": {
                        "availability_status": "normal",
                        "availability_label": "Normal",
                        "statement": "Precision Concrete Coating is currently accepting new residential and commercial projects…",
                        "turnaround": [
                          "Estimates are typically provided within 24 hours after the on-site inspection."
                        ],
                        "accepting_new_projects": true,
                        "payload_version": 3
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No approved knowledge payload has been published yet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "The knowledge source is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/service-areas": {
      "get": {
        "operationId": "getServiceAreas",
        "summary": "Service areas",
        "description": "Returns the approved service areas together with the headquarters, primary city, state, county and overall service region.\n\nAll responses share a common envelope: `ok`, `schema_version`, `payload_version`, `generated_at` and `data`.",
        "tags": [
          "Coverage"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Service areas — successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "data"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "schema_version": {
                      "type": "string"
                    },
                    "payload_version": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "primary_city": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "primary_state": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "primary_county": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "service_region": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "headquarters": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "service_areas": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "region": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "default": {
                    "summary": "Service areas example",
                    "value": {
                      "ok": true,
                      "schema_version": "1.4",
                      "payload_version": 3,
                      "generated_at": "2026-07-29T12:00:00.000Z",
                      "data": {
                        "primary_city": "Fort Worth",
                        "primary_state": "Texas",
                        "service_region": "Dallas–Fort Worth metroplex",
                        "service_areas": [
                          {
                            "name": "Southlake",
                            "slug": "southlake",
                            "url": null,
                            "description": null,
                            "region": "Tarrant County"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No approved knowledge payload has been published yet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "The knowledge source is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/faq": {
      "get": {
        "operationId": "getFaq",
        "summary": "Frequently asked questions",
        "description": "Returns every approved public question-and-answer pair collected from Approved Knowledge, the Warranty Center, Installation Standards and Inspection Standards.\n\nAll responses share a common envelope: `ok`, `schema_version`, `payload_version`, `generated_at` and `data`.",
        "tags": [
          "Knowledge"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Frequently asked questions — successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "data"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "schema_version": {
                      "type": "string"
                    },
                    "payload_version": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "faq": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "question": {
                                "type": "string"
                              },
                              "answer": {
                                "type": "string"
                              },
                              "source": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "default": {
                    "summary": "Frequently asked questions example",
                    "value": {
                      "ok": true,
                      "schema_version": "1.4",
                      "payload_version": 3,
                      "generated_at": "2026-07-29T12:00:00.000Z",
                      "data": {
                        "faq": [
                          {
                            "question": "How long does a garage floor coating take?",
                            "answer": "Most residential installations are completed in 1–2 days.",
                            "source": "Frequently Asked Questions (FAQ)"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No approved knowledge payload has been published yet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "The knowledge source is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/pricing": {
      "get": {
        "operationId": "getPricing",
        "summary": "Pricing information",
        "description": "Returns approved public pricing statements and the services they apply to. No quoted amounts are generated: Precision Concrete Coating prices every project after an on-site inspection.\n\nAll responses share a common envelope: `ok`, `schema_version`, `payload_version`, `generated_at` and `data`.",
        "tags": [
          "Knowledge"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Pricing information — successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "data"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "schema_version": {
                      "type": "string"
                    },
                    "payload_version": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "disclaimer": {
                          "type": "string"
                        },
                        "pricing_facts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "label": {
                                "type": "string"
                              },
                              "value": {
                                "type": "string"
                              },
                              "source": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        },
                        "services": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "region": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "default": {
                    "summary": "Pricing information example",
                    "value": {
                      "ok": true,
                      "schema_version": "1.4",
                      "payload_version": 3,
                      "generated_at": "2026-07-29T12:00:00.000Z",
                      "data": {
                        "disclaimer": "Precision Concrete Coating prices every project after an on-site inspection.",
                        "pricing_facts": [
                          {
                            "label": "Estimate Policy",
                            "value": "Estimates are free and provided after an on-site inspection.",
                            "source": "company"
                          }
                        ],
                        "services": []
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No approved knowledge payload has been published yet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "The knowledge source is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/warranty": {
      "get": {
        "operationId": "getWarranty",
        "summary": "Warranty information",
        "description": "Returns the approved public warranty knowledge graph: the derived summary plus coverage, exclusions, maintenance requirements, claims process, transfer policy and warranty FAQ records.\n\nAll responses share a common envelope: `ok`, `schema_version`, `payload_version`, `generated_at` and `data`.",
        "tags": [
          "Warranty"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Warranty information — successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "data"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "schema_version": {
                      "type": "string"
                    },
                    "payload_version": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "available": {
                          "type": "boolean"
                        },
                        "summary": {
                          "type": [
                            "object",
                            "null"
                          ]
                        },
                        "relationships": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {}
                          }
                        },
                        "sections": {
                          "type": "object",
                          "properties": {},
                          "additionalProperties": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {}
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "default": {
                    "summary": "Warranty information example",
                    "value": {
                      "ok": true,
                      "schema_version": "1.4",
                      "payload_version": 3,
                      "generated_at": "2026-07-29T12:00:00.000Z",
                      "data": {
                        "available": true,
                        "summary": {
                          "residential_workmanship_length": "15 Years"
                        },
                        "sections": {
                          "coverage": [
                            {
                              "title": "Coating adhesion",
                              "coverage_item": "Delamination from the concrete substrate"
                            }
                          ]
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No approved knowledge payload has been published yet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "The knowledge source is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/knowledge": {
      "get": {
        "operationId": "searchKnowledge",
        "summary": "Search approved knowledge",
        "description": "Full-text style search across every published Approved Knowledge record — company, services, service areas, warranty, installation, inspection and failure-analysis knowledge. Omit the query to receive the full index.\n\nAll responses share a common envelope: `ok`, `schema_version`, `payload_version`, `generated_at` and `data`.",
        "tags": [
          "Knowledge"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Search terms. When omitted the complete published record index is returned.",
            "schema": {
              "type": "string"
            },
            "example": "moisture testing"
          },
          {
            "name": "module",
            "in": "query",
            "required": false,
            "description": "Restrict results to a single knowledge module.",
            "schema": {
              "type": "string",
              "enum": [
                "company",
                "services",
                "service_areas",
                "approved_knowledge",
                "warranty",
                "installation_standards",
                "inspection_standards",
                "failure_analysis"
              ]
            },
            "example": "warranty"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of results (1–50). Defaults to 10.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 10
            },
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "Search approved knowledge — successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "data"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "schema_version": {
                      "type": "string"
                    },
                    "payload_version": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "query": {
                          "type": "string"
                        },
                        "total_records": {
                          "type": "integer"
                        },
                        "result_count": {
                          "type": "integer"
                        },
                        "results": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "module": {
                                "type": "string"
                              },
                              "section": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "title": {
                                "type": "string"
                              },
                              "body": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "score": {
                                "type": "number"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "default": {
                    "summary": "Search approved knowledge example",
                    "value": {
                      "ok": true,
                      "schema_version": "1.4",
                      "payload_version": 3,
                      "generated_at": "2026-07-29T12:00:00.000Z",
                      "data": {
                        "query": "moisture testing",
                        "total_records": 214,
                        "result_count": 2,
                        "results": [
                          {
                            "module": "inspection_standards",
                            "section": "concrete_testing",
                            "title": "Moisture testing",
                            "body": "Moisture is evaluated within manufacturer limits before any coating is applied.",
                            "url": null,
                            "score": 1
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No approved knowledge payload has been published yet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "The knowledge source is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/relationships": {
      "get": {
        "operationId": "getKnowledgeRelationships",
        "summary": "Knowledge graph relationships",
        "description": "Returns the directional relationships between published Precision knowledge records — for example which installation standard prevents which coating failure, or which warranty covers which service. Only relationships whose records are both approved and public are returned.\n\nAll responses share a common envelope: `ok`, `schema_version`, `payload_version`, `generated_at` and `data`.",
        "tags": [
          "Knowledge"
        ],
        "parameters": [
          {
            "name": "subject",
            "in": "query",
            "required": false,
            "description": "Filter to relationships whose subject or object matches this text.",
            "schema": {
              "type": "string"
            },
            "example": "moisture"
          },
          {
            "name": "relationship",
            "in": "query",
            "required": false,
            "description": "Filter to a single relationship type, e.g. prevents, covered_by, verifies.",
            "schema": {
              "type": "string"
            },
            "example": "prevents"
          }
        ],
        "responses": {
          "200": {
            "description": "Knowledge graph relationships — successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "data"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "schema_version": {
                      "type": "string"
                    },
                    "payload_version": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "node_count": {
                          "type": "integer"
                        },
                        "checksum": {
                          "type": "string"
                        },
                        "generated_at": {
                          "type": "string"
                        },
                        "total_relationships": {
                          "type": "integer"
                        },
                        "relationship_count": {
                          "type": "integer"
                        },
                        "relationships": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "subject": {
                                "type": "string"
                              },
                              "subject_module": {
                                "type": "string"
                              },
                              "relationship": {
                                "type": "string"
                              },
                              "relationship_label": {
                                "type": "string"
                              },
                              "object": {
                                "type": "string"
                              },
                              "object_module": {
                                "type": "string"
                              },
                              "statement": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "default": {
                    "summary": "Knowledge graph relationships example",
                    "value": {
                      "ok": true,
                      "schema_version": "1.4",
                      "payload_version": 3,
                      "generated_at": "2026-07-29T12:00:00.000Z",
                      "data": {
                        "node_count": 128,
                        "checksum": "1a2b3c4d5e6f7a8b",
                        "generated_at": "2026-07-30T00:00:00.000Z",
                        "total_relationships": 1,
                        "relationship_count": 1,
                        "relationships": [
                          {
                            "subject": "Moisture testing",
                            "subject_module": "installation",
                            "relationship": "prevents",
                            "relationship_label": "Prevents",
                            "object": "Moisture-driven delamination",
                            "object_module": "failure",
                            "statement": "Moisture testing prevents Moisture-driven delamination."
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No approved knowledge payload has been published yet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "The knowledge source is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/platform": {
      "get": {
        "operationId": "describePlatform",
        "summary": "Describe the platform",
        "description": "Self-documenting endpoint. Returns everything an AI agent or developer needs to use Precision OS correctly: platform identity and versions, authentication and read-only status, transports and capabilities, the complete auto-generated documentation for every registered tool, plus best practices, limitations, security model, privacy guarantees and data freshness. Generated dynamically from the live tool registry, so it never goes out of date.\n\nAll responses share a common envelope: `ok`, `schema_version`, `payload_version`, `generated_at` and `data`.",
        "tags": [
          "Platform"
        ],
        "parameters": [
          {
            "name": "tool",
            "in": "query",
            "required": false,
            "description": "Return the documentation for a single registered tool instead of the whole catalog.",
            "schema": {
              "type": "string"
            },
            "example": "search_knowledge"
          }
        ],
        "responses": {
          "200": {
            "description": "Describe the platform — successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "data"
                  ],
                  "properties": {
                    "ok": {
                      "const": true
                    },
                    "schema_version": {
                      "type": "string"
                    },
                    "payload_version": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "platform": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "description": {
                              "type": "string"
                            },
                            "platform_version": {
                              "type": "string"
                            },
                            "api_version": {
                              "type": "string"
                            },
                            "openapi_version": {
                              "type": "string"
                            },
                            "mcp_protocol_version": {
                              "type": "string"
                            },
                            "supported_mcp_protocol_versions": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "read_only": {
                              "type": "boolean"
                            },
                            "authentication": {
                              "type": "string"
                            },
                            "authentication_required": {
                              "type": "boolean"
                            },
                            "total_tools": {
                              "type": "integer"
                            },
                            "transports": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string"
                                  },
                                  "url": {
                                    "type": [
                                      "string",
                                      "null"
                                    ]
                                  },
                                  "description": {
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "capabilities": {
                              "type": "object",
                              "properties": {},
                              "additionalProperties": true
                            },
                            "endpoints": {
                              "type": "object",
                              "properties": {},
                              "additionalProperties": true
                            },
                            "last_updated": {
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          }
                        },
                        "tools": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "title": {
                                "type": "string"
                              },
                              "description": {
                                "type": "string"
                              },
                              "purpose": {
                                "type": "string"
                              },
                              "read_only": {
                                "type": "boolean"
                              },
                              "rest_endpoint": {
                                "type": "string"
                              },
                              "operation_id": {
                                "type": "string"
                              },
                              "input_parameters": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string"
                                    },
                                    "type": {
                                      "type": "string"
                                    },
                                    "required": {
                                      "type": "boolean"
                                    },
                                    "description": {
                                      "type": "string"
                                    },
                                    "example": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    }
                                  }
                                }
                              },
                              "output_description": {
                                "type": "string"
                              },
                              "output_schema": {
                                "type": "object",
                                "properties": {},
                                "additionalProperties": true
                              },
                              "example_prompt": {
                                "type": "string"
                              },
                              "use_cases": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "limitations": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            }
                          }
                        },
                        "guidance": {
                          "type": "object",
                          "properties": {
                            "best_practices": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "known_limitations": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "unsupported_operations": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "security_model": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "privacy_guarantees": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "data_freshness": {
                              "type": "object",
                              "properties": {
                                "source": {
                                  "type": "string"
                                },
                                "schema_version": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "payload_version": {
                                  "type": [
                                    "integer",
                                    "null"
                                  ]
                                },
                                "knowledge_last_updated": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "cache_policy": {
                                  "type": "string"
                                },
                                "update_cadence": {
                                  "type": "string"
                                }
                              }
                            },
                            "version_compatibility": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "human_summary": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "default": {
                    "summary": "Describe the platform example",
                    "value": {
                      "ok": true,
                      "schema_version": "1.4",
                      "payload_version": 3,
                      "generated_at": "2026-07-29T12:00:00.000Z",
                      "data": {
                        "platform": {
                          "name": "Precision OS — Precision AI Developer Platform",
                          "platform_version": "1.0.0",
                          "mcp_protocol_version": "2025-06-18",
                          "openapi_version": "3.1.0",
                          "read_only": true,
                          "authentication": "none",
                          "total_tools": 8
                        },
                        "tools": [
                          {
                            "name": "search_knowledge",
                            "purpose": "Answer any free-form question from Precision's approved knowledge base.",
                            "example_prompt": "What does Precision say about moisture testing before coating?",
                            "read_only": true
                          }
                        ],
                        "guidance": {
                          "best_practices": [
                            "Call describe_platform once at the start of a session."
                          ]
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No approved knowledge payload has been published yet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "The knowledge source is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "ok",
          "error"
        ],
        "properties": {
          "ok": {
            "const": false
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  },
  "x-precision": {
    "source": "Approved Knowledge (single source of truth)",
    "read_only": true,
    "authentication": "none",
    "payload_version": 15,
    "knowledge_schema_version": "1.4",
    "generated_at": "2026-07-30T07:45:07.703Z",
    "mcp_tools": [
      "get_company_information",
      "get_business_status",
      "get_service_areas",
      "get_faq",
      "get_pricing",
      "get_warranty",
      "search_knowledge",
      "get_knowledge_relationships",
      "describe_platform"
    ]
  }
}