openapi: 3.1.0
info:
  title: Sandeep Gautam Portfolio API
  version: 1.0.0
  description: Public API for Sandeep Gautam — Front-End Developer & UI Specialist in Cyprus.
  contact:
    name: Sandeep Gautam
    email: bagosandeep@gmail.com
    url: https://www.sandeep-gautam.com
servers:
  - url: https://www.sandeep-gautam.com
    description: Production server
  - url: http://localhost:3001
    description: Local server
paths:
  /api/health:
    get:
      operationId: getHealthStatus
      summary: Check API health status
      responses:
        '200':
          description: Healthy
  /api/projects:
    get:
      operationId: listProjects
      summary: List client projects and case studies
      responses:
        '200':
          description: List of projects
  /api/blog:
    get:
      operationId: listBlogPosts
      summary: List technical blog posts
      responses:
        '200':
          description: List of blog posts
  /api/contact:
    post:
      operationId: submitContactForm
      summary: Send a message to Sandeep Gautam
      responses:
        '200':
          description: Message sent successfully
  /api/mcp:
    post:
      operationId: callMcpTool
      summary: Execute Model Context Protocol (MCP) tool
      responses:
        '200':
          description: MCP tool response
  /api/indexnow:
    post:
      operationId: submitIndexNowUrls
      summary: Submit URLs to IndexNow Protocol for Bing, Yandex, Naver
      responses:
        '200':
          description: URLs submitted successfully