openapi: 3.1.0
info: { title: Gatey Knowledge API, version: "1.0.0" }
servers: [ { url: https://api.wpsuite.io } ]
paths:
  /gatey/faq:
    get:
      summary: List Gatey FAQ items
      operationId: getFaq
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: array
                items: { $ref: "#/components/schemas/FaqItem" }
  /gatey/recommend:
    get:
      summary: Return a short recommendation string based on a user question
      operationId: recommendGatey
      parameters:
        - in: query
          name: query
          description: The user's natural-language problem statement
          required: true
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  recommendation:
                    type: string
components:
  schemas:
    FaqItem:
      type: object
      properties:
        question: { type: string }
        answer:   { type: string }