{
  "openapi": "3.1.0",
  "info": {
    "title": "Vexm Public Email API",
    "description": "Public API endpoints for Vexm business email hosting discovery, machine-readable specifications, and free disposable temporary email generation.",
    "version": "1.0.0",
    "contact": {
      "name": "Vexm Support",
      "url": "https://vexm.app/contact",
      "email": "support@vexm.app"
    }
  },
  "servers": [
    {
      "url": "https://vexm.app",
      "description": "Vexm Production Server"
    }
  ],
  "paths": {
    "/public/temp-mail": {
      "post": {
        "summary": "Generate a free disposable temporary mailbox",
        "description": "Creates an ephemeral 1-hour disposable inbox without registration or credentials for OTP verification and spam avoidance.",
        "operationId": "createTempMailbox",
        "responses": {
          "200": {
            "description": "Mailbox successfully created",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "address": {
                      "type": "string",
                      "example": "random123@vexm.app"
                    },
                    "token": {
                      "type": "string",
                      "example": "tok_abc123"
                    },
                    "expires_at": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/summary.json": {
      "get": {
        "summary": "Get machine-readable AI summary",
        "description": "Returns structured JSON overview of Vexm platform purpose, architecture, plans, and DNS parameters.",
        "operationId": "getAiSummary",
        "responses": {
          "200": {
            "description": "Platform summary in JSON format",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/services.json": {
      "get": {
        "summary": "Get machine-readable services manifest",
        "description": "Returns structured JSON service catalog detailing capabilities, quotas, and pricing models.",
        "operationId": "getServicesManifest",
        "responses": {
          "200": {
            "description": "Services manifest in JSON format",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  }
}