{
    "openapi": "3.0.3",
    "info": {
        "title": "Linkssi Public API",
        "description": "Machine-discoverable public HTTP APIs for Linkssi Bio (tracking, leads, bookings, newsletter). Authenticated dashboard APIs require a browser session + CSRF and are not listed here.",
        "version": "1.0.0",
        "contact": {
            "name": "Linkssi",
            "url": "https://linkssi.com/contact"
        }
    },
    "servers": [
        {
            "url": "https://linkssi.com"
        }
    ],
    "paths": {
        "/api/health": {
            "get": {
                "summary": "Service health probe",
                "operationId": "health",
                "tags": [
                    "Status"
                ],
                "responses": {
                    "200": {
                        "description": "Healthy"
                    },
                    "503": {
                        "description": "Degraded"
                    }
                }
            }
        },
        "/api/track": {
            "post": {
                "summary": "Record a pageview or click analytics event",
                "operationId": "trackAnalytics",
                "tags": [
                    "Analytics"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "page_token": {
                                        "type": "string"
                                    },
                                    "item_token": {
                                        "type": "string"
                                    },
                                    "action": {
                                        "type": "string",
                                        "enum": [
                                            "pageview",
                                            "click",
                                            "conversion"
                                        ]
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Event accepted"
                    },
                    "429": {
                        "description": "Rate limited"
                    }
                }
            }
        },
        "/api/leads/submit": {
            "post": {
                "summary": "Submit a public lead form",
                "operationId": "submitLead",
                "tags": [
                    "Leads"
                ],
                "responses": {
                    "200": {
                        "description": "Lead accepted"
                    },
                    "429": {
                        "description": "Rate limited"
                    }
                }
            }
        },
        "/api/book": {
            "get": {
                "summary": "List event types or availability",
                "operationId": "bookQuery",
                "tags": [
                    "Bookings"
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            },
            "post": {
                "summary": "Create, reschedule, or cancel a booking",
                "operationId": "bookMutate",
                "tags": [
                    "Bookings"
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "429": {
                        "description": "Rate limited"
                    }
                }
            }
        },
        "/api/newsletter/subscribe": {
            "post": {
                "summary": "Subscribe an email to a page audience list",
                "operationId": "newsletterSubscribe",
                "tags": [
                    "Newsletter"
                ],
                "responses": {
                    "200": {
                        "description": "Subscribed or pending confirmation"
                    },
                    "429": {
                        "description": "Rate limited"
                    }
                }
            }
        }
    },
    "externalDocs": {
        "description": "Product overview for agents (llms.txt)",
        "url": "https://linkssi.com/llms.txt"
    }
}