{"openapi":"3.1.0","info":{"title":"Biome Public Pages","version":"1.0.0","description":"Canonical public pages on biome.you. This document exposes no customer-data, account, order, integration, webhook, or write API.","contact":{"name":"Biome support","email":"hello@biome.you","url":"https://biome.you/contact"}},"servers":[{"url":"https://biome.you","description":"Biome website"}],"tags":[{"name":"Public pages","description":"Human-readable pages published on the Biome website."},{"name":"Machine-readable pages","description":"Public indexes and agent guidance published by Biome."}],"paths":{"/":{"get":{"operationId":"getBiomeHomepage","summary":"Read the Biome homepage","description":"Returns Biome's canonical whole-genome sequencing page. Request text/markdown for the agent-readable representation.","tags":["Public pages"],"security":[],"parameters":[{"$ref":"#/components/parameters/AcceptPage"}],"responses":{"200":{"$ref":"#/components/responses/NegotiatedPage"}}}},"/about":{"get":{"operationId":"getBiomeAboutPage","summary":"Read about Biome","description":"Returns Biome's company identity, product scope, health-information boundaries, address, and contact details.","tags":["Public pages"],"security":[],"parameters":[{"$ref":"#/components/parameters/AcceptPage"}],"responses":{"200":{"$ref":"#/components/responses/NegotiatedPage"}}}},"/agents":{"get":{"operationId":"getBiomeAgentGuidance","summary":"Read Biome agent guidance","description":"Returns guidance describing when an AI agent should use Biome sources and where the canonical machine-readable indexes live.","tags":["Machine-readable pages"],"security":[],"parameters":[{"$ref":"#/components/parameters/AcceptPage"}],"responses":{"200":{"$ref":"#/components/responses/NegotiatedPage"}}}},"/contact":{"get":{"operationId":"getBiomeContactPage","summary":"Read Biome contact details","description":"Returns Biome's public support email, mailing address, and medical-emergency boundary.","tags":["Public pages"],"security":[],"parameters":[{"$ref":"#/components/parameters/AcceptPage"}],"responses":{"200":{"$ref":"#/components/responses/NegotiatedPage"}}}},"/privacy":{"get":{"operationId":"getBiomePrivacyPage","summary":"Read the Biome privacy policy","description":"Returns the public policy explaining how Biome collects, uses, stores, safeguards, and shares information.","tags":["Public pages"],"security":[],"responses":{"200":{"$ref":"#/components/responses/HtmlPage"}}}},"/what-we-test":{"get":{"operationId":"getBiomeTestingCatalog","summary":"Read what Biome tests","description":"Returns the public catalog of traits, genes, and DNA markers included in Biome reports.","tags":["Public pages"],"security":[],"responses":{"200":{"$ref":"#/components/responses/HtmlPage"}}}},"/glossary":{"get":{"operationId":"getBiomeGlossary","summary":"Read the Biome genetics glossary","description":"Returns the public index of evidence-rated traits, genes, and DNA markers defined by Biome.","tags":["Public pages"],"security":[],"responses":{"200":{"$ref":"#/components/responses/HtmlPage"}}}},"/blog":{"get":{"operationId":"getBiomeBlog","summary":"Read Biome articles","description":"Returns the public index of Biome articles about genetics, DNA testing, supplements, sleep, and training.","tags":["Public pages"],"security":[],"responses":{"200":{"$ref":"#/components/responses/HtmlPage"}}}},"/llms.txt":{"get":{"operationId":"getBiomeAgentIndex","summary":"Read the Biome agent index","description":"Returns the curated text index of canonical Biome pages and specific when-to-use guidance for AI agents.","tags":["Machine-readable pages"],"security":[],"responses":{"200":{"$ref":"#/components/responses/PlainTextPage"}}}},"/sitemap.xml":{"get":{"operationId":"getBiomeSitemap","summary":"Read the Biome sitemap","description":"Returns the XML sitemap containing canonical public Biome pages, articles, and genetics glossary entries.","tags":["Machine-readable pages"],"security":[],"responses":{"200":{"$ref":"#/components/responses/XmlPage"}}}},"/openapi.json":{"get":{"operationId":"getBiomePublicPageSchema","summary":"Read the Biome public-page schema","description":"Returns this OpenAPI 3.1 document describing only public pages on the Biome website.","tags":["Machine-readable pages"],"security":[],"responses":{"200":{"description":"The OpenAPI document for Biome public pages.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}},"components":{"parameters":{"AcceptPage":{"name":"Accept","in":"header","required":false,"description":"Request text/markdown for an agent-readable page. Browsers and omitted values receive HTML.","schema":{"type":"string","examples":["text/html","text/markdown"]}}},"responses":{"NegotiatedPage":{"description":"The canonical page in the acceptable requested representation.","headers":{"Vary":{"description":"Indicates that the representation varies by Accept.","schema":{"type":"string","const":"Accept, Accept-Encoding"}}},"content":{"text/html":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"HtmlPage":{"description":"The canonical public HTML page.","content":{"text/html":{"schema":{"type":"string"}}}},"PlainTextPage":{"description":"The canonical public plain-text document.","content":{"text/plain":{"schema":{"type":"string"}}}},"XmlPage":{"description":"The canonical public XML document.","content":{"application/xml":{"schema":{"type":"string"}}}}}},"externalDocs":{"description":"Biome resources for AI agents","url":"https://biome.you/agents"},"x-agent-instructions":{"whenToUse":"Use these public pages for canonical Biome information about genome testing, tested traits, privacy, contact details, and agent guidance.","doNotUseFor":"Do not send personal health information, request medical advice, manage orders, or attempt account access. No such API is exposed here."}}