openapi: 3.1.0
info:
  title: Barbine Worldwide Assessment Scheduler
  version: 1.1.0
  description: Public API and discovery surface for the Barbine Worldwide assessment builder and scheduling portal.
servers:
  - url: https://assessments.platphormnews.com
paths:
  /api/health:
    get:
      summary: Service health
      responses:
        "200":
          description: Health payload
  /api/v1/health:
    get:
      summary: Versioned service health
      responses:
        "200":
          description: Health payload
  /api/docs:
    get:
      summary: Human-readable API documentation
      responses:
        "200":
          description: HTML documentation
  /api/mcp:
    get:
      summary: MCP endpoint metadata
      responses:
        "200":
          description: MCP metadata
    post:
      summary: MCP JSON-RPC endpoint
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - type: object
                - type: array
      responses:
        "200":
          description: JSON-RPC response
  /llms.txt:
    get:
      summary: Concise AI-readable site summary
      responses:
        "200":
          description: Plain text summary
  /llms-full.txt:
    get:
      summary: Complete AI-readable capability summary
      responses:
        "200":
          description: Plain text capability document
  /llms-index.json:
    get:
      summary: JSON index of AI-readable files and public capabilities
      responses:
        "200":
          description: JSON index
components:
  securitySchemes:
    PlatPhormApiKey:
      type: apiKey
      in: header
      name: X-PlatPhorm-API-Key
    PlatPhormBearer:
      type: http
      scheme: bearer
security: []
