{
    "openapi": "3.1.0",
    "info": {
        "title": "ITSSOSO Agent Gateway API",
        "version": "0.3.8",
        "description": "Read-only public AI/agent API for ITSSOSO live city signals, actions, feeds, tools, schema, freshness, and knowledge catalog."
    },
    "servers": [
        {
            "url": "https://itssoso.com/wp-json/itssoso-agent/v1",
            "description": "ITSSOSO Agent Gateway REST API"
        }
    ],
    "paths": {
        "/manifest": {
            "get": {
                "summary": "Get ITSSOSO AI manifest",
                "responses": {
                    "200": {
                        "description": "Manifest"
                    }
                }
            }
        },
        "/actions": {
            "get": {
                "summary": "Get safe action-start routes",
                "responses": {
                    "200": {
                        "description": "Actions"
                    }
                }
            }
        },
        "/tools": {
            "get": {
                "summary": "List read-only agent tools",
                "responses": {
                    "200": {
                        "description": "Tools"
                    }
                }
            }
        },
        "/compatibility": {
            "get": {
                "summary": "Get AI browser and agent compatibility report",
                "responses": {
                    "200": {
                        "description": "Compatibility report"
                    }
                }
            }
        },
        "/readiness": {
            "get": {
                "summary": "Get AI readiness audit and endpoint validation status",
                "responses": {
                    "200": {
                        "description": "AI readiness audit"
                    }
                }
            }
        },
        "/schema": {
            "get": {
                "summary": "Get schema catalog",
                "responses": {
                    "200": {
                        "description": "Schema catalog"
                    }
                }
            }
        },
        "/a2a": {
            "get": {
                "summary": "Get A2A agent card",
                "responses": {
                    "200": {
                        "description": "A2A card"
                    }
                }
            }
        },
        "/citation-prompts": {
            "get": {
                "summary": "Get AI citation prompt bank",
                "responses": {
                    "200": {
                        "description": "Prompt bank"
                    }
                }
            }
        },
        "/citation-readiness": {
            "get": {
                "summary": "Get AI citation readiness report",
                "responses": {
                    "200": {
                        "description": "Citation readiness"
                    }
                }
            }
        },
        "/share-of-voice": {
            "get": {
                "summary": "Get manual AI share-of-voice metrics",
                "responses": {
                    "200": {
                        "description": "Share of voice"
                    }
                }
            }
        },
        "/agentic-requirements": {
            "get": {
                "summary": "Get agentic readiness requirements",
                "responses": {
                    "200": {
                        "description": "Agentic requirements"
                    }
                }
            }
        },
        "/authority-builder": {
            "get": {
                "summary": "Get AI authority builder plan",
                "responses": {
                    "200": {
                        "description": "Authority builder"
                    }
                }
            }
        },
        "/agent-registry-policy": {
            "get": {
                "summary": "Get agent registry policy",
                "responses": {
                    "200": {
                        "description": "Agent registry policy"
                    }
                }
            }
        },
        "/ai-conversions": {
            "get": {
                "summary": "Get early AI-to-action conversion diagnostics",
                "responses": {
                    "200": {
                        "description": "AI conversions"
                    }
                }
            }
        },
        "/feeds/{feed}": {
            "get": {
                "summary": "Get a named public feed",
                "parameters": [
                    {
                        "name": "feed",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Feed payload"
                    }
                }
            }
        },
        "/tool/{tool}": {
            "get": {
                "summary": "Call a read-only tool",
                "parameters": [
                    {
                        "name": "tool",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Tool payload"
                    }
                }
            }
        }
    },
    "x-itssoso-boundary": "Public read-only feeds and safe action-start URLs only. Private details, access codes, owner data, billing data, and messages are excluded."
}