openapi: 3.0.0
info:
  title: Thynk FAQ API
  description: Machine-readable API for Thynk's FAQ knowledge base. For AI crawlers like Claude, use /static-faq-feed endpoint for full HTML content.
  version: 1.0.0
  contact:
    email: support@thynk.cloud
servers:
  - url: https://aykopzibxbgqlqebflhj.supabase.co/functions/v1
    description: FAQ API Server
paths:
  /static-faq-feed:
    get:
      summary: Get complete FAQ knowledge base as static HTML (RECOMMENDED FOR AI)
      description: Returns a fully-rendered HTML page with all 500+ FAQs, optimized for AI crawlers and LLMs. No JavaScript required. This is the primary endpoint for Claude.ai and similar AI assistants.
      operationId: getStaticFAQFeed
      responses:
        '200':
          description: Complete HTML page with all FAQs
          content:
            text/html:
              schema:
                type: string
                description: Full HTML document containing all FAQ questions and answers with semantic markup
  /ai-index:
    get:
      summary: Get all FAQs in machine-readable format
      description: Returns structured JSON containing all active FAQs with metadata for AI/LLM consumption
      operationId: getFAQIndex
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      total_faqs:
                        type: integer
                      last_updated:
                        type: string
                        format: date-time
                      version:
                        type: string
                      source:
                        type: string
                  faqs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        question:
                          type: string
                        answer:
                          type: string
                        category:
                          type: string
                        url:
                          type: string
                        lastUpdated:
                          type: string
                        popularity:
                          type: integer
                        relevanceScore:
                          type: number
