{
  "name": "Agent Zone API",
  "version": "v1",
  "endpoints": [
    {
      "path": "/health",
      "method": "GET",
      "description": "Health check"
    },
    {
      "path": "/.well-known/agent.json",
      "method": "GET",
      "description": "Agent API discovery"
    },
    {
      "path": "/api/v1",
      "method": "GET",
      "description": "API discovery"
    },
    {
      "path": "/api/v1/knowledge/search",
      "method": "GET",
      "description": "Full-text search",
      "params": [
        "q",
        "category",
        "skill",
        "tool",
        "limit"
      ]
    },
    {
      "path": "/api/v1/knowledge/categories",
      "method": "GET",
      "description": "List categories with counts"
    },
    {
      "path": "/api/v1/knowledge/{id}",
      "method": "GET",
      "description": "Get content by ID"
    },
    {
      "path": "/api/v1/templates",
      "method": "GET",
      "description": "Search/list templates",
      "params": [
        "q",
        "path",
        "tag",
        "limit"
      ]
    },
    {
      "path": "/api/v1/templates/{id}",
      "method": "GET",
      "description": "Get template metadata"
    },
    {
      "path": "/api/v1/templates/{id}/download",
      "method": "GET",
      "description": "Download template bundle"
    },
    {
      "path": "/api/v1/playbooks",
      "method": "GET",
      "description": "Search/list playbooks",
      "params": [
        "q",
        "path",
        "tier",
        "limit"
      ]
    },
    {
      "path": "/api/v1/playbooks/{id}",
      "method": "GET",
      "description": "Get playbook with steps",
      "params": [
        "path"
      ]
    },
    {
      "path": "/api/v1/advisor/select-path",
      "method": "POST",
      "description": "Get recommended validation path"
    },
    {
      "path": "/api/v1/validate/k8s-manifest",
      "method": "POST",
      "description": "Validate Kubernetes manifests"
    },
    {
      "path": "/api/v1/validate/helm-values",
      "method": "POST",
      "description": "Validate Helm values"
    },
    {
      "path": "/api/v1/errors/resolve",
      "method": "POST",
      "description": "Resolve error — paste error text, get diagnosis + fixes",
      "params": [
        "error_text",
        "tool",
        "limit"
      ]
    },
    {
      "path": "/api/v1/errors/search",
      "method": "GET",
      "description": "Search error resolutions",
      "params": [
        "q",
        "category",
        "tool",
        "severity",
        "limit"
      ]
    },
    {
      "path": "/api/v1/errors/{id}",
      "method": "GET",
      "description": "Get error resolution by ID"
    },
    {
      "path": "/api/v1/errors/categories",
      "method": "GET",
      "description": "List error categories with counts"
    },
    {
      "path": "/api/v1/errors/{id}/feedback",
      "method": "POST",
      "description": "Submit error fix feedback",
      "params": [
        "fix_id",
        "feedback_type",
        "context",
        "comment"
      ]
    },
    {
      "path": "/api/v1/feedback",
      "method": "POST",
      "description": "Submit article feedback",
      "params": [
        "content_id",
        "feedback_type",
        "comment"
      ]
    },
    {
      "path": "/api/v1/feedback",
      "method": "GET",
      "description": "List feedback",
      "params": [
        "content_id",
        "feedback_type",
        "limit"
      ]
    },
    {
      "path": "/api/v1/suggestions",
      "method": "POST",
      "description": "Suggest a topic",
      "params": [
        "title",
        "description",
        "related_content_id"
      ]
    },
    {
      "path": "/api/v1/suggestions",
      "method": "GET",
      "description": "List suggestions",
      "params": [
        "status",
        "limit"
      ]
    },
    {
      "path": "/api/v1/submissions",
      "method": "POST",
      "description": "Submit an article",
      "params": [
        "title",
        "body_markdown",
        "description",
        "categories",
        "tags"
      ]
    },
    {
      "path": "/api/v1/submissions",
      "method": "GET",
      "description": "List submissions",
      "params": [
        "status",
        "limit"
      ]
    },
    {
      "path": "/api/v1/submissions/{id}",
      "method": "GET",
      "description": "Get submission detail"
    },
    {
      "path": "/mcp",
      "method": "POST",
      "description": "MCP protocol endpoint (JSON-RPC over HTTP)"
    }
  ]
}