{
    "openapi": "3.1.0",
    "info": {
        "title": "BRX Site API",
        "version": "1.0.0",
        "description": "Public endpoints for brx.sa — business services discovery and contact.",
        "contact": {
            "email": "info@brx.sa",
            "url": "https://brx.sa/"
        },
        "license": {
            "name": "Proprietary"
        }
    },
    "servers": [
        {
            "url": "https://brx.sa",
            "description": "Production"
        }
    ],
    "paths": {
        "/llms.txt": {
            "get": {
                "summary": "LLM-friendly site description",
                "operationId": "getLlmsTxt",
                "tags": [
                    "discovery"
                ],
                "responses": {
                    "200": {
                        "description": "Plain-text site description for LLMs",
                        "content": {
                            "text/plain": []
                        }
                    }
                }
            }
        },
        "/": {
            "get": {
                "summary": "BRX homepage",
                "operationId": "getHomepage",
                "tags": [
                    "content"
                ],
                "parameters": [
                    {
                        "name": "Accept",
                        "in": "header",
                        "schema": {
                            "type": "string",
                            "example": "text/markdown"
                        },
                        "description": "Send text/markdown to receive agent-friendly Markdown response"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "HTML page or Markdown depending on Accept header",
                        "content": {
                            "text/html": [],
                            "text/markdown": []
                        }
                    }
                }
            }
        },
        "/.well-known/api-catalog": {
            "get": {
                "summary": "API catalog (RFC 9727)",
                "operationId": "getApiCatalog",
                "tags": [
                    "discovery"
                ],
                "responses": {
                    "200": {
                        "description": "Linkset JSON catalog of available APIs",
                        "content": {
                            "application/linkset+json": []
                        }
                    }
                }
            }
        },
        "/.well-known/agent-skills/index.json": {
            "get": {
                "summary": "Agent skills discovery index",
                "operationId": "getAgentSkills",
                "tags": [
                    "discovery"
                ],
                "responses": {
                    "200": {
                        "description": "Agent Skills RFC v0.2 index",
                        "content": {
                            "application/json": []
                        }
                    }
                }
            }
        },
        "/wp-json/": {
            "get": {
                "summary": "WordPress REST API root",
                "operationId": "getWpRestRoot",
                "tags": [
                    "api"
                ],
                "responses": {
                    "200": {
                        "description": "WordPress REST API discovery document",
                        "content": {
                            "application/json": []
                        }
                    }
                }
            }
        }
    },
    "tags": [
        {
            "name": "discovery",
            "description": "Agent and API discovery endpoints"
        },
        {
            "name": "content",
            "description": "Site content endpoints"
        },
        {
            "name": "api",
            "description": "Programmatic API endpoints"
        }
    ]
}