{
  "openapi": "3.1.0",
  "info": {
    "title": "Followo Public Agent Metadata API",
    "version": "1.0.0",
    "description": "Public metadata and discovery endpoints for Followo, an AI-native CRM with Voice-to-Lead, follow-up automation, lead summaries, email activity timeline, and sales pipeline automation. This document describes only public discovery surfaces. User CRM data (leads, contacts, emails, tasks, pipeline records, voice notes, subscriptions, account settings) is protected and is not exposed here.",
    "contact": {
      "name": "Followo (Techora AI)",
      "email": "hello@techora.ai",
      "url": "https://followo.app"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://followo.app/legal/terms"
    }
  },
  "servers": [
    {
      "url": "https://followo.app",
      "description": "Followo production website"
    }
  ],
  "paths": {
    "/health.json": {
      "get": {
        "summary": "Service health and contact metadata",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "Service health metadata",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "summary": "Public API and metadata discovery catalog (RFC 9727 linkset)",
        "operationId": "getApiCatalog",
        "responses": {
          "200": {
            "description": "Linkset JSON describing public discovery resources",
            "content": {
              "application/linkset+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "summary": "Agent skills discovery index",
        "operationId": "getAgentSkills",
        "responses": {
          "200": {
            "description": "Index of public agent-readable skill descriptions for Followo",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/mcp/server-card.json": {
      "get": {
        "summary": "Model Context Protocol server discovery card",
        "operationId": "getMcpServerCard",
        "responses": {
          "200": {
            "description": "MCP server card describing public Followo discovery resources",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/auth.md": {
      "get": {
        "summary": "Agent registration and access policy",
        "operationId": "getAuthMd",
        "responses": {
          "200": {
            "description": "Human and agent-readable access policy in Markdown",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {},
  "tags": [
    {
      "name": "discovery",
      "description": "Public agent discovery metadata for Followo CRM"
    }
  ]
}