openapi: "3.0.3"
info:
  title: KIRA Agency — Public Website API
  version: "1.0"
  description: |
    Public API surface for kiraco.org — Kuwait's leading AI marketing and automation agency.
    Use this to submit service inquiries. For the full tenant platform API (WhatsApp AI, campaigns,
    contacts, analytics), connect to mcp.kiragpt.com with a KIRA tenant API key.
  contact:
    name: KIRA Agency
    url: https://kiraco.org/contact
    email: sales@kiragpt.com
  license:
    name: All rights reserved
    url: https://kiraco.org/terms

servers:
  - url: https://api.kiragpt.com
    description: KIRA API (public endpoints — no auth required for contact)

paths:
  /kiraco/contact:
    post:
      operationId: submitContactInquiry
      summary: Submit a service inquiry to KIRA Agency
      description: |
        Send a new business inquiry. KIRA's team will respond within 1 business day via WhatsApp
        or email. For urgent matters, WhatsApp +965 9786 6044 directly.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ContactInquiry"
            examples:
              mediabuying:
                summary: Media buying inquiry
                value:
                  name: "Ahmad Al-Rashid"
                  company: "Al-Rashid Retail Group"
                  email: "ahmad@alrashid.com"
                  phone: "+96550001234"
                  goal: "Media Buying"
                  message: "Looking to run Meta and Snapchat campaigns for our Kuwait retail stores."
              lojain:
                summary: Lojain WhatsApp AI inquiry
                value:
                  name: "Sara Al-Mutairi"
                  company: "Cafe Bloom"
                  phone: "+96560009999"
                  goal: "Lojain AI (WhatsApp automation)"
                  message: "We want to automate orders and reservations via WhatsApp."
      responses:
        "200":
          description: Inquiry received successfully
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ContactResponse"
        "422":
          description: Validation error — check required fields
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"

components:
  schemas:
    ContactInquiry:
      type: object
      required:
        - name
        - goal
      properties:
        name:
          type: string
          description: Full name of the person making the inquiry
          example: "Ahmad Al-Rashid"
        company:
          type: string
          description: Company or business name
          example: "Al-Rashid Group"
        email:
          type: string
          format: email
          description: Email address (optional if phone provided)
          example: "ahmad@alrashid.com"
        phone:
          type: string
          description: WhatsApp-capable phone number including country code (+965 for Kuwait)
          example: "+96550001234"
        goal:
          type: string
          description: Service of interest
          enum:
            - "Lojain AI (WhatsApp automation)"
            - "Media Buying"
            - "Business Consulting"
            - "Influencer Campaigns"
            - "Digital Loyalty Program"
            - "General inquiry"
          example: "Media Buying"
        message:
          type: string
          description: Details about the business need, budget, or timeline
          example: "Looking to scale Meta Ads campaigns in Kuwait and Saudi Arabia."

    ContactResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: "Your inquiry has been received. Our team will contact you within 1 business day."

    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
          example: "name field is required"

  externalDocs:
    description: Full KIRA tenant platform API (requires KIRA tenant API key)
    url: https://api.kiragpt.com/openapi.json
