first commit

Made-with: Cursor

internal/api/openapi/specs/base.json

@@ -0,0 +1,41 @@
+{
+  "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" }
+  ],
+  "security": [
+    { "BearerAuth": [] },
+    { "ApiKeyAuth": [] }
+  ]
+}