{
  "openapi": "3.1.0",
  "info": {
    "title": "Calendar & Contacts API",
    "description": "Production-grade Calendar and Contacts REST API supporting human users, AI agents, and programmatic automation. Features JWT and API key authentication, calendar sharing, recurring events, booking links, ICS import/export, and background reminder processing.",
    "version": "1.0.0",
    "contact": {
      "name": "API Support"
    },
    "license": {
      "name": "MIT"
    }
  },
  "servers": [
    {
      "url": "http://localhost:8080",
      "description": "Local development"
    },
    {
      "url": "https://api.example.com",
      "description": "Production"
    }
  ],
  "tags": [
    { "name": "Auth", "description": "Authentication and session management" },
    { "name": "Users", "description": "User profile management" },
    { "name": "API Keys", "description": "API key management for agents" },
    { "name": "Calendars", "description": "Calendar CRUD and sharing" },
    { "name": "Events", "description": "Event CRUD with recurrence support" },
    { "name": "Reminders", "description": "Event reminder management" },
    { "name": "Attendees", "description": "Event attendee management" },
    { "name": "Contacts", "description": "Contact management" },
    { "name": "Availability", "description": "Calendar availability queries" },
    { "name": "Booking", "description": "Public booking links and reservations" },
    { "name": "ICS", "description": "ICS calendar import and export" },
    { "name": "Subscriptions", "description": "Calendar subscriptions (external iCal feeds)" }
  ],
  "security": [
    { "BearerAuth": [] },
    { "ApiKeyAuth": [] }
  ]
}