openapi: 3.0.1
info:
  title: OODARIS website API
  version: "1.0.0"
  description: Read-only endpoints with OODARIS AI's company information and the retail decisions it covers.
servers:
  - url: https://oodaris.ai
paths:
  /api/info:
    get:
      summary: Get company info
      responses:
        '200':
          description: Company information
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  tagline:
                    type: string
                  mission:
                    type: string
                  contact:
                    type: string
  /api/services:
    get:
      summary: List the ten capabilities OODARIS covers
      responses:
        '200':
          description: Array of capabilities, each with its stage and status
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                    stage:
                      type: string
                      enum: [plan, buy, flow, sell]
                    name:
                      type: string
                    description:
                      type: string
  /api/use-cases:
    get:
      summary: List example uses of the read-only API
      responses:
        '200':
          description: Array of use cases
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                    title:
                      type: string
                    endpoint:
                      type: string
                    description:
                      type: string
  /api/contact:
    post:
      summary: Submit website contact form
      description: Captcha-protected endpoint used by the localized website contact form; not intended as a general programmatic Agentic API.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                locale:
                  type: string
                  enum: [en, fr, es, tr, de, it, pt]
                  default: en
                name:
                  type: string
                  minLength: 2
                  maxLength: 120
                email:
                  type: string
                  format: email
                  maxLength: 256
                company:
                  type: string
                  minLength: 2
                  maxLength: 150
                message:
                  type: string
                  minLength: 20
                  maxLength: 2000
                captchaToken:
                  type: string
                  minLength: 10
                  maxLength: 500
                topic:
                  type: string
                experience:
                  type: string
              required:
                - name
                - email
                - company
                - message
      responses:
        '200':
          description: Contact request accepted
          content:
            application/json:
              schema:
                type: object
                required:
                  - ok
                properties:
                  ok:
                    type: boolean
                    enum: [true]
        '400':
          description: Invalid payload or missing captcha token
        '403':
          description: Invalid captcha token
        '422':
          description: Field validation failed
        '429':
          description: Rate limit exceeded
        '500':
          description: Captcha configuration or email delivery failure
        '503':
          description: Email service unavailable