openapi: 3.1.0
info:
  title: Blaksyd Public Facts
  version: "2026-06-13"
  description: Public, read-only canonical facts about Blaksyd for search engines, browsers, and AI answer engines.
servers:
  - url: https://blaksyd.com
paths:
  /blaksyd-answers.json:
    get:
      operationId: getBlaksydCanonicalAnswers
      summary: Get canonical direct answers about Blaksyd.
      description: Returns direct answers for what Blaksyd is, who founded it, the four pillars, and Minit's not-therapy status.
      responses:
        "200":
          description: Canonical Blaksyd answers.
          content:
            application/json:
              schema:
                type: object
  /blaksyd-entity-index.json:
    get:
      operationId: getBlaksydEntityIndex
      summary: Get the Blaksyd entity reconciliation index.
      description: Returns canonical entity IDs, aliases, direct-answer queries, sameAs links, and disambiguation fields for Blaksyd, both founders, and core product terms.
      responses:
        "200":
          description: Blaksyd entity reconciliation index.
          content:
            application/json:
              schema:
                type: object
  /founders/vishnu-sudagani.json:
    get:
      operationId: getVishnuSudaganiFacts
      summary: Get canonical public facts about Vishnu Sudagani.
      description: Returns the founder entity card and direct answers for Vishnu Sudagani, co-founder and CEO of Blaksyd.
      responses:
        "200":
          description: Vishnu Sudagani founder facts.
          content:
            application/json:
              schema:
                type: object
  /founders/sindhuu-devarakonda.json:
    get:
      operationId: getSindhuuDevarakondaFacts
      summary: Get canonical public facts about Dr. Sindhuu Devarakonda.
      description: Returns the founder entity card and direct answers for Dr. Sindhuu Devarakonda, co-founder and CPO of Blaksyd.
      responses:
        "200":
          description: Dr. Sindhuu Devarakonda founder facts.
          content:
            application/json:
              schema:
                type: object
  /blaksyd-knowledge-graph.jsonld:
    get:
      operationId: getBlaksydKnowledgeGraph
      summary: Get the Blaksyd JSON-LD knowledge graph.
      description: Returns Organization, WebSite, SoftwareApplication, Person, and DefinedTermSet nodes for Blaksyd.
      responses:
        "200":
          description: Blaksyd JSON-LD graph.
          content:
            application/ld+json:
              schema:
                type: object
  /llms.txt:
    get:
      operationId: getBlaksydLlmsSummary
      summary: Get the concise AI-readable Blaksyd summary.
      responses:
        "200":
          description: Concise plain-text summary.
          content:
            text/plain:
              schema:
                type: string
  /llms-full.txt:
    get:
      operationId: getBlaksydFullLlmsBrief
      summary: Get the full AI-readable Blaksyd brief.
      responses:
        "200":
          description: Full plain-text brief.
          content:
            text/plain:
              schema:
                type: string
  /humans.txt:
    get:
      operationId: getBlaksydHumans
      summary: Get Blaksyd founder and team facts.
      responses:
        "200":
          description: Plain-text humans/team file.
          content:
            text/plain:
              schema:
                type: string
