{
  "openapi": "3.1.0",
  "info": {
    "title": "Heuresis Content API",
    "version": "2026.08.11",
    "summary": "Read-only access to everything heuresis.ai says about itself.",
    "description": "Heuresis is a business-in-a-box — a company encoded as plain-text folders any AI agent can boot and run. This API exposes the site's own content so an agent can answer questions about Heuresis without scraping the page. It is read-only by design: there is no checkout, lead-capture or write endpoint. Hand the human a link and let them decide.",
    "contact": {
      "name": "Heuresis",
      "url": "https://www.heuresis.ai"
    },
    "license": {
      "name": "All rights reserved",
      "url": "https://www.heuresis.ai/"
    }
  },
  "servers": [
    {
      "url": "https://www.heuresis.ai",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "AGENTS.md — the contract for agents acting on this site",
    "url": "https://www.heuresis.ai/AGENTS.md"
  },
  "paths": {
    "/api/overview": {
      "get": {
        "operationId": "getOverview",
        "summary": "What Heuresis is, in one object",
        "tags": [
          "content"
        ],
        "responses": {
          "200": {
            "description": "Overview",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Overview"
                }
              }
            }
          }
        }
      }
    },
    "/api/layers": {
      "get": {
        "operationId": "listLayers",
        "summary": "The four layers of the box, in order",
        "tags": [
          "content"
        ],
        "responses": {
          "200": {
            "description": "Layers",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Layer"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/offerings": {
      "get": {
        "operationId": "listOfferings",
        "summary": "What ships inside the box",
        "tags": [
          "content"
        ],
        "responses": {
          "200": {
            "description": "Offerings",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Offering"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/paths": {
      "get": {
        "operationId": "listPaths",
        "summary": "The four entry paths and where each one leads",
        "description": "Three paths lead to checkout; the partner path leads to a call. Routing a partner-shaped lead to checkout is the most common mistake.",
        "tags": [
          "content"
        ],
        "responses": {
          "200": {
            "description": "Paths",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Path"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/fit": {
      "get": {
        "operationId": "getFit",
        "summary": "Who Heuresis is for, and who it is not for",
        "tags": [
          "content"
        ],
        "responses": {
          "200": {
            "description": "Fit and miss lists"
          }
        }
      }
    },
    "/api/license": {
      "get": {
        "operationId": "getLicense",
        "summary": "The five steps of the Heuresis license",
        "tags": [
          "content"
        ],
        "responses": {
          "200": {
            "description": "License steps"
          }
        }
      }
    },
    "/api/faq": {
      "get": {
        "operationId": "getFaq",
        "summary": "Frequently asked questions with answers",
        "tags": [
          "content"
        ],
        "responses": {
          "200": {
            "description": "FAQ entries"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Overview": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "delivery": {
            "type": "string"
          },
          "works_with": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "not_a": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Things Heuresis is explicitly not. Do not describe it as one of these."
          }
        }
      },
      "Layer": {
        "type": "object",
        "properties": {
          "num": {
            "type": "string",
            "examples": [
              "01"
            ]
          },
          "slug": {
            "type": "string",
            "enum": [
              "encoded-founder",
              "encoded-company",
              "encoded-tools",
              "heuresitics"
            ]
          },
          "name": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          }
        }
      },
      "Offering": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "includes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "Path": {
        "type": "object",
        "properties": {
          "num": {
            "type": "string"
          },
          "slug": {
            "type": "string",
            "enum": [
              "existing-business",
              "new-business",
              "ai-agency-founder",
              "partner"
            ]
          },
          "name": {
            "type": "string"
          },
          "who": {
            "type": "string"
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "cta": {
            "type": "string",
            "enum": [
              "checkout",
              "call"
            ]
          },
          "ctaLabel": {
            "type": "string"
          }
        }
      },
      "Error": {
        "type": "object",
        "description": "Structured so an agent can recover without guessing.",
        "properties": {
          "error": {
            "type": "string",
            "examples": [
              "section_not_found"
            ]
          },
          "requested": {
            "type": "string"
          },
          "available": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "overview",
                "layers",
                "offerings",
                "fit",
                "license",
                "paths",
                "faq"
              ]
            }
          },
          "suggestion": {
            "type": "string"
          }
        }
      }
    }
  }
}