{
  "openapi": "3.0.3",
  "info": {
    "title": "Umney Connect Business Email API",
    "version": "1.0.0",
    "description": "Public Business Email API (email:send, email:read). Send messages, list activity, upsert marketing contacts. Docs: https://umneyconnect.com/developers/business-email"
  },
  "servers": [
    { "url": "https://umneyconnect.com/api", "description": "Production" },
    { "url": "https://www.staging.umneyconnect.com/api", "description": "Staging" }
  ],
  "tags": [{ "name": "Messages" }, { "name": "Contacts" }, { "name": "Status" }],
  "components": {
    "securitySchemes": {
      "ApiKeyBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "umk_live_email_…" },
      "ApiKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key" }
    },
    "parameters": {
      "MessageId": { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }
    }
  },
  "security": [{ "ApiKeyBearer": [] }, { "ApiKeyHeader": [] }],
  "paths": {
    "/v1/email/status": {
      "get": { "tags": ["Status"], "summary": "Provider readiness (no secrets)", "operationId": "getEmailStatus", "responses": { "200": { "description": "OK" } } }
    },
    "/v1/email/messages": {
      "get": { "tags": ["Messages"], "summary": "List send activity logs", "operationId": "listEmailMessages", "responses": { "200": { "description": "OK" } } },
      "post": { "tags": ["Messages"], "summary": "Send transactional email", "operationId": "sendEmailMessage", "responses": { "200": { "description": "Send results" } } }
    },
    "/v1/email/messages/{id}": {
      "get": { "tags": ["Messages"], "summary": "Get one activity log row", "operationId": "getEmailMessage", "parameters": [{ "$ref": "#/components/parameters/MessageId" }], "responses": { "200": { "description": "OK" } } }
    },
    "/v1/email/contacts": {
      "post": { "tags": ["Contacts"], "summary": "Upsert marketing contact to configured providers", "operationId": "upsertEmailContact", "responses": { "200": { "description": "Per-provider results" } } }
    }
  }
}