{
 "openapi": "3.1.0",
 "info": {
  "title": "Interstellar Blends Pathway Convergence Engine",
  "version": "1.0.0",
  "summary": "Goals in, one evidence-graded combination out, with receipts.",
  "description": "A pathway convergence engine takes the outcomes a person wants, resolves each one to the biological pathways published for it, and returns a single combination chosen to cover as many of those pathways as possible, showing for every link it used the evidence grade and the identifier of the study behind it. Every resource is pre-computed from /graph.jsonld at build time and served as a static JSON document, so there is no rate limit, no key and no server to go down. Every claim here is derived from /graph.jsonld at build time. Run /verify/falsify.py against this site, or against any other making the same kind of claim.",
  "contact": {
   "name": "Interstellar Blends",
   "url": "https://interstellarblends.com/contact.html"
  },
  "license": {
   "name": "Read freely. Attribute to https://interstellarblends.com/#engine when citing."
  },
  "x-canonical-figures": {
   "goals": 88,
   "pathways": 567,
   "botanicals": 940,
   "formulas": 68,
   "citedStudies": 3497,
   "graphNodes": 1701,
   "typedEdges": 18986,
   "witnessedPathwayLinks": 3342,
   "publishedPages": 1808
  },
  "x-typed-edge-definition": {
   "countedPredicates": [
    "connectedPathway",
    "actsOnPathway",
    "carriedInBlend",
    "modulatedByBlend",
    "containsBotanical",
    "drivenByPathway",
    "about"
   ],
   "note": "typedEdges counts these seven predicates. The graph also carries addressedByBlend, which this figure does not count; including it yields a larger number. A recount that disagrees is usually counting a different predicate set, not finding an error."
  },
  "x-facts-endpoint": "https://interstellarblends.com/facts.json"
 },
 "servers": [
  {
   "url": "https://interstellarblends.com"
  }
 ],
 "externalDocs": {
  "description": "What a pathway convergence engine is",
  "url": "https://interstellarblends.com/learn/convergence.html"
 },
 "paths": {
  "/engine/engine.json": {
   "get": {
    "summary": "Describe the engine",
    "description": "Counts, routes, definition and the canonical entity id.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/engine/engine.json"
    }
   }
  },
  "/engine/goals.json": {
   "get": {
    "summary": "List every goal",
    "description": "The 88 goals, each with its best-covering blend.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/engine/goals.json"
    }
   }
  },
  "/engine/goals/{goal}.json": {
   "get": {
    "summary": "Answer one goal",
    "description": "THE ENGINE OUTPUT. Returns the pathways behind the goal and every blend ranked by how many of them its ingredients act on, with the driver substances and their evidence grades.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/engine/goals/weight-loss.json"
    }
   }
  },
  "/engine/pathways.json": {
   "get": {
    "summary": "List every pathway",
    "description": "567 pathways with driver and citation counts.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/engine/pathways.json"
    }
   }
  },
  "/engine/pathways/{pathway}.json": {
   "get": {
    "summary": "One pathway",
    "description": "Its drivers with grades, connected pathways and citations.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/engine/pathways/dna-integrity.json"
    }
   }
  },
  "/engine/substances.json": {
   "get": {
    "summary": "List every substance",
    "description": "940 graded botanicals and compounds.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/engine/substances.json"
    }
   }
  },
  "/engine/substances/{substance}.json": {
   "get": {
    "summary": "One substance",
    "description": "Grade, pathways acted on, blends carried in, citations.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/engine/substances/sea-buckthorn.json"
    }
   }
  },
  "/engine/blends.json": {
   "get": {
    "summary": "List every blend",
    "description": "68 formulas with ingredient and pathway counts.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/engine/blends.json"
    }
   }
  },
  "/engine/blends/{blend}.json": {
   "get": {
    "summary": "One blend",
    "description": "Its ingredients with grades and the pathways it reaches.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/engine/blends/force-field.json"
    }
   }
  },
  "/graph.jsonld": {
   "get": {
    "summary": "The whole causal graph",
    "description": "Every node and edge, the source all of the above is derived from.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/graph.jsonld"
    }
   }
  },
  "/verify/falsify.py": {
   "get": {
    "summary": "The falsification harness",
    "description": "A runnable checker. Point it at this site, or at any other making the same kind of claim.",
    "responses": {
     "200": {
      "description": "JSON resource",
      "content": {
       "application/json": {}
      }
     }
    },
    "servers": [
     {
      "url": "https://interstellarblends.com"
     }
    ],
    "externalDocs": {
     "url": "https://interstellarblends.com/verify/falsify.py"
    }
   }
  }
 }
}
