{
  "openapi": "3.1.0",
  "info": {
    "title": "Tiza Search API",
    "version": "1.0.0",
    "description": "Discovery layer for AI agents: search public agents, MCP servers, A2A agents, and callable tools — each tested with live protocol probes. Use this API directly (no MCP required).",
    "contact": {
      "url": "https://tiza.cc"
    }
  },
  "servers": [
    {
      "url": "https://tiza.cc"
    }
  ],
  "paths": {
    "/api/search": {
      "post": {
        "operationId": "searchAgents",
        "summary": "Search for agents, MCP servers, A2A agents, and tools",
        "description": "Semantic + lexical search over every indexed, live-tested agent interface. Describe what you need in plain English.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SearchRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ranked results",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "total": {
                      "type": "integer"
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SearchResult"
                      }
                    }
                  },
                  "required": [
                    "total",
                    "results"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "500": {
            "description": "Search failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/entities/{id}": {
      "get": {
        "operationId": "getEntity",
        "summary": "Get full details for one entity",
        "description": "Fetch the full record (usage, endpoints, packages, versions, operability) for an entity id returned by search.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Entity id (e.g. ent_…) from a search result."
          }
        ],
        "responses": {
          "200": {
            "description": "Entity detail",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntityDetail"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Database unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "operationId": "health",
        "summary": "Health check",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "status"
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "SearchRequest": {
        "type": "object",
        "required": [
          "query"
        ],
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500,
            "description": "Plain-English description of the agent/tool you need."
          },
          "protocols": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "mcp",
                "a2a",
                "agntcy",
                "openapi",
                "asyncapi",
                "graphql",
                "llms_txt",
                "legacy_plugin",
                "unknown"
              ]
            },
            "description": "Restrict to these protocols (e.g. [\"mcp\"], [\"a2a\"])."
          },
          "filters": {
            "type": "object",
            "description": "Optional operability/source filters.",
            "properties": {
              "auth": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "verified": {
                "type": "boolean"
              },
              "sourceTypes": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "mcp_registry",
                    "mcp_directory",
                    "a2a_directory",
                    "agntcy_directory",
                    "llms_txt_directory",
                    "github",
                    "focused_web",
                    "manual"
                  ]
                }
              },
              "readiness": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "ready",
                    "agent_onboarding",
                    "user_onboarding",
                    "credentials_required",
                    "local_required",
                    "not_usable",
                    "unknown"
                  ]
                }
              },
              "security": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "secure",
                    "local",
                    "insecure",
                    "unknown"
                  ]
                }
              },
              "deployment": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "remote",
                    "local_package",
                    "local_container",
                    "local_source",
                    "local_manual",
                    "unknown"
                  ]
                }
              },
              "authentication": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "none",
                    "oauth",
                    "credential",
                    "manual",
                    "unknown"
                  ]
                }
              },
              "onboarding": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "not_required",
                    "agent_self_serve",
                    "user_self_serve",
                    "external_account_required",
                    "vendor_gated",
                    "unknown"
                  ]
                }
              },
              "connectivity": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "live",
                    "metadata_only",
                    "unreachable",
                    "not_tested"
                  ]
                }
              }
            }
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 10
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000,
            "default": 0
          }
        }
      },
      "SearchResult": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable entity id (e.g. ent_…). Pass to GET /api/entities/{id}."
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "agent",
              "tool",
              "mcp_server",
              "a2a_agent",
              "api",
              "registry",
              "unknown"
            ]
          },
          "description": {
            "type": "string"
          },
          "protocols": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "mcp",
                "a2a",
                "agntcy",
                "openapi",
                "asyncapi",
                "graphql",
                "llms_txt",
                "legacy_plugin",
                "unknown"
              ]
            }
          },
          "sourceUrl": {
            "type": "string",
            "format": "uri"
          },
          "documentationUrl": {
            "type": "string",
            "format": "uri"
          },
          "usage": {
            "type": "object",
            "description": "How to actually connect to or install the entity.",
            "properties": {
              "projectUrl": {
                "type": "string",
                "format": "uri"
              },
              "manifestUrl": {
                "type": "string",
                "format": "uri",
                "description": "A2A agent card URL, when applicable."
              },
              "openapiUrl": {
                "type": "string",
                "format": "uri"
              },
              "protocol": {
                "type": "string",
                "enum": [
                  "mcp",
                  "a2a",
                  "agntcy",
                  "openapi",
                  "asyncapi",
                  "graphql",
                  "llms_txt",
                  "legacy_plugin",
                  "unknown"
                ]
              },
              "endpoints": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "label": {
                      "type": "string"
                    },
                    "transport": {
                      "type": "string"
                    },
                    "authType": {
                      "type": "string"
                    },
                    "healthStatus": {
                      "type": "string",
                      "enum": [
                        "unknown",
                        "healthy",
                        "degraded",
                        "down"
                      ]
                    },
                    "headers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "required": {
                            "type": "boolean"
                          },
                          "secret": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "name"
                        ]
                      }
                    }
                  },
                  "required": [
                    "url"
                  ]
                }
              },
              "packages": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "registryType": {
                      "type": "string"
                    },
                    "identifier": {
                      "type": "string"
                    },
                    "version": {
                      "type": "string"
                    },
                    "transport": {
                      "type": "string"
                    },
                    "installHint": {
                      "type": "string"
                    },
                    "environmentVariables": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "required": {
                            "type": "boolean"
                          },
                          "secret": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "name"
                        ]
                      }
                    }
                  },
                  "required": [
                    "identifier"
                  ]
                }
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "endpointUrl": {
            "type": "string",
            "format": "uri"
          },
          "operability": {
            "type": "object",
            "description": "Tiza's readiness assessment from live protocol probes.",
            "properties": {
              "readiness": {
                "type": "string",
                "enum": [
                  "ready",
                  "agent_onboarding",
                  "user_onboarding",
                  "credentials_required",
                  "local_required",
                  "not_usable",
                  "unknown"
                ]
              },
              "dimensions": {
                "type": "object",
                "properties": {
                  "protocol": {
                    "type": "string",
                    "enum": [
                      "mcp",
                      "a2a",
                      "unknown"
                    ]
                  },
                  "security": {
                    "type": "string",
                    "enum": [
                      "secure",
                      "local",
                      "insecure",
                      "unknown"
                    ]
                  },
                  "authentication": {
                    "type": "string",
                    "enum": [
                      "none",
                      "oauth",
                      "credential",
                      "manual",
                      "unknown"
                    ]
                  },
                  "onboarding": {
                    "type": "string",
                    "enum": [
                      "not_required",
                      "agent_self_serve",
                      "user_self_serve",
                      "external_account_required",
                      "vendor_gated",
                      "unknown"
                    ]
                  },
                  "deployment": {
                    "type": "string",
                    "enum": [
                      "remote",
                      "local_package",
                      "local_container",
                      "local_source",
                      "local_manual",
                      "unknown"
                    ]
                  },
                  "connectivity": {
                    "type": "string",
                    "enum": [
                      "live",
                      "metadata_only",
                      "unreachable",
                      "not_tested"
                    ]
                  }
                }
              },
              "deploymentOptions": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "remote",
                    "local_package",
                    "local_container",
                    "local_source",
                    "local_manual",
                    "unknown"
                  ]
                }
              },
              "reasons": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "lastSeenAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "name",
          "type",
          "description",
          "protocols",
          "sourceUrl",
          "usage"
        ]
      },
      "EntityDetail": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "agent",
              "tool",
              "mcp_server",
              "a2a_agent",
              "api",
              "registry",
              "unknown"
            ]
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "publisher": {
            "type": "string",
            "nullable": true
          },
          "usage": {
            "type": "object",
            "description": "How to actually connect to or install the entity.",
            "properties": {
              "projectUrl": {
                "type": "string",
                "format": "uri"
              },
              "manifestUrl": {
                "type": "string",
                "format": "uri",
                "description": "A2A agent card URL, when applicable."
              },
              "openapiUrl": {
                "type": "string",
                "format": "uri"
              },
              "protocol": {
                "type": "string",
                "enum": [
                  "mcp",
                  "a2a",
                  "agntcy",
                  "openapi",
                  "asyncapi",
                  "graphql",
                  "llms_txt",
                  "legacy_plugin",
                  "unknown"
                ]
              },
              "endpoints": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "label": {
                      "type": "string"
                    },
                    "transport": {
                      "type": "string"
                    },
                    "authType": {
                      "type": "string"
                    },
                    "healthStatus": {
                      "type": "string",
                      "enum": [
                        "unknown",
                        "healthy",
                        "degraded",
                        "down"
                      ]
                    },
                    "headers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "required": {
                            "type": "boolean"
                          },
                          "secret": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "name"
                        ]
                      }
                    }
                  },
                  "required": [
                    "url"
                  ]
                }
              },
              "packages": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "registryType": {
                      "type": "string"
                    },
                    "identifier": {
                      "type": "string"
                    },
                    "version": {
                      "type": "string"
                    },
                    "transport": {
                      "type": "string"
                    },
                    "installHint": {
                      "type": "string"
                    },
                    "environmentVariables": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "required": {
                            "type": "boolean"
                          },
                          "secret": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "name"
                        ]
                      }
                    }
                  },
                  "required": [
                    "identifier"
                  ]
                }
              },
              "notes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "authType": {
            "type": "string",
            "nullable": true
          },
          "license": {
            "type": "string",
            "nullable": true
          },
          "pricingHint": {
            "type": "string",
            "nullable": true
          },
          "healthStatus": {
            "type": "string",
            "enum": [
              "unknown",
              "healthy",
              "degraded",
              "down"
            ]
          },
          "lastSeenAt": {
            "type": "string",
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "protocols": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "mcp",
                "a2a",
                "agntcy",
                "openapi",
                "asyncapi",
                "graphql",
                "llms_txt",
                "legacy_plugin",
                "unknown"
              ]
            }
          },
          "endpoints": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "label": {
                  "type": "string"
                },
                "transport": {
                  "type": "string"
                },
                "authType": {
                  "type": "string"
                },
                "healthStatus": {
                  "type": "string",
                  "enum": [
                    "unknown",
                    "healthy",
                    "degraded",
                    "down"
                  ]
                },
                "headers": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "required": {
                        "type": "boolean"
                      },
                      "secret": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "name"
                    ]
                  }
                }
              },
              "required": [
                "url"
              ]
            }
          },
          "versions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "version": {
                  "type": "string",
                  "nullable": true
                },
                "registryStatus": {
                  "type": "string",
                  "nullable": true
                },
                "isLatest": {
                  "type": "boolean"
                },
                "publishedAt": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "registryUpdatedAt": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "statusChangedAt": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "createdAt": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          },
          "operability": {
            "type": "object",
            "description": "Tiza's readiness assessment from live protocol probes.",
            "properties": {
              "readiness": {
                "type": "string",
                "enum": [
                  "ready",
                  "agent_onboarding",
                  "user_onboarding",
                  "credentials_required",
                  "local_required",
                  "not_usable",
                  "unknown"
                ]
              },
              "dimensions": {
                "type": "object",
                "properties": {
                  "protocol": {
                    "type": "string",
                    "enum": [
                      "mcp",
                      "a2a",
                      "unknown"
                    ]
                  },
                  "security": {
                    "type": "string",
                    "enum": [
                      "secure",
                      "local",
                      "insecure",
                      "unknown"
                    ]
                  },
                  "authentication": {
                    "type": "string",
                    "enum": [
                      "none",
                      "oauth",
                      "credential",
                      "manual",
                      "unknown"
                    ]
                  },
                  "onboarding": {
                    "type": "string",
                    "enum": [
                      "not_required",
                      "agent_self_serve",
                      "user_self_serve",
                      "external_account_required",
                      "vendor_gated",
                      "unknown"
                    ]
                  },
                  "deployment": {
                    "type": "string",
                    "enum": [
                      "remote",
                      "local_package",
                      "local_container",
                      "local_source",
                      "local_manual",
                      "unknown"
                    ]
                  },
                  "connectivity": {
                    "type": "string",
                    "enum": [
                      "live",
                      "metadata_only",
                      "unreachable",
                      "not_tested"
                    ]
                  }
                }
              },
              "deploymentOptions": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "remote",
                    "local_package",
                    "local_container",
                    "local_source",
                    "local_manual",
                    "unknown"
                  ]
                }
              },
              "reasons": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        },
        "required": [
          "id",
          "type",
          "name",
          "description",
          "usage",
          "protocols"
        ]
      },
      "UsageInfo": {
        "type": "object",
        "description": "How to actually connect to or install the entity.",
        "properties": {
          "projectUrl": {
            "type": "string",
            "format": "uri"
          },
          "manifestUrl": {
            "type": "string",
            "format": "uri",
            "description": "A2A agent card URL, when applicable."
          },
          "openapiUrl": {
            "type": "string",
            "format": "uri"
          },
          "protocol": {
            "type": "string",
            "enum": [
              "mcp",
              "a2a",
              "agntcy",
              "openapi",
              "asyncapi",
              "graphql",
              "llms_txt",
              "legacy_plugin",
              "unknown"
            ]
          },
          "endpoints": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "label": {
                  "type": "string"
                },
                "transport": {
                  "type": "string"
                },
                "authType": {
                  "type": "string"
                },
                "healthStatus": {
                  "type": "string",
                  "enum": [
                    "unknown",
                    "healthy",
                    "degraded",
                    "down"
                  ]
                },
                "headers": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "required": {
                        "type": "boolean"
                      },
                      "secret": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "name"
                    ]
                  }
                }
              },
              "required": [
                "url"
              ]
            }
          },
          "packages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "registryType": {
                  "type": "string"
                },
                "identifier": {
                  "type": "string"
                },
                "version": {
                  "type": "string"
                },
                "transport": {
                  "type": "string"
                },
                "installHint": {
                  "type": "string"
                },
                "environmentVariables": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "required": {
                        "type": "boolean"
                      },
                      "secret": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "name"
                    ]
                  }
                }
              },
              "required": [
                "identifier"
              ]
            }
          },
          "notes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "Endpoint": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "label": {
            "type": "string"
          },
          "transport": {
            "type": "string"
          },
          "authType": {
            "type": "string"
          },
          "healthStatus": {
            "type": "string",
            "enum": [
              "unknown",
              "healthy",
              "degraded",
              "down"
            ]
          },
          "headers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "required": {
                  "type": "boolean"
                },
                "secret": {
                  "type": "boolean"
                }
              },
              "required": [
                "name"
              ]
            }
          }
        },
        "required": [
          "url"
        ]
      },
      "UsagePackage": {
        "type": "object",
        "properties": {
          "registryType": {
            "type": "string"
          },
          "identifier": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "transport": {
            "type": "string"
          },
          "installHint": {
            "type": "string"
          },
          "environmentVariables": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "required": {
                  "type": "boolean"
                },
                "secret": {
                  "type": "boolean"
                }
              },
              "required": [
                "name"
              ]
            }
          }
        },
        "required": [
          "identifier"
        ]
      },
      "Operability": {
        "type": "object",
        "description": "Tiza's readiness assessment from live protocol probes.",
        "properties": {
          "readiness": {
            "type": "string",
            "enum": [
              "ready",
              "agent_onboarding",
              "user_onboarding",
              "credentials_required",
              "local_required",
              "not_usable",
              "unknown"
            ]
          },
          "dimensions": {
            "type": "object",
            "properties": {
              "protocol": {
                "type": "string",
                "enum": [
                  "mcp",
                  "a2a",
                  "unknown"
                ]
              },
              "security": {
                "type": "string",
                "enum": [
                  "secure",
                  "local",
                  "insecure",
                  "unknown"
                ]
              },
              "authentication": {
                "type": "string",
                "enum": [
                  "none",
                  "oauth",
                  "credential",
                  "manual",
                  "unknown"
                ]
              },
              "onboarding": {
                "type": "string",
                "enum": [
                  "not_required",
                  "agent_self_serve",
                  "user_self_serve",
                  "external_account_required",
                  "vendor_gated",
                  "unknown"
                ]
              },
              "deployment": {
                "type": "string",
                "enum": [
                  "remote",
                  "local_package",
                  "local_container",
                  "local_source",
                  "local_manual",
                  "unknown"
                ]
              },
              "connectivity": {
                "type": "string",
                "enum": [
                  "live",
                  "metadata_only",
                  "unreachable",
                  "not_tested"
                ]
              }
            }
          },
          "deploymentOptions": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "remote",
                "local_package",
                "local_container",
                "local_source",
                "local_manual",
                "unknown"
              ]
            }
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "OperabilityDimensions": {
        "type": "object",
        "properties": {
          "protocol": {
            "type": "string",
            "enum": [
              "mcp",
              "a2a",
              "unknown"
            ]
          },
          "security": {
            "type": "string",
            "enum": [
              "secure",
              "local",
              "insecure",
              "unknown"
            ]
          },
          "authentication": {
            "type": "string",
            "enum": [
              "none",
              "oauth",
              "credential",
              "manual",
              "unknown"
            ]
          },
          "onboarding": {
            "type": "string",
            "enum": [
              "not_required",
              "agent_self_serve",
              "user_self_serve",
              "external_account_required",
              "vendor_gated",
              "unknown"
            ]
          },
          "deployment": {
            "type": "string",
            "enum": [
              "remote",
              "local_package",
              "local_container",
              "local_source",
              "local_manual",
              "unknown"
            ]
          },
          "connectivity": {
            "type": "string",
            "enum": [
              "live",
              "metadata_only",
              "unreachable",
              "not_tested"
            ]
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          },
          "details": {
            "type": "object"
          }
        },
        "required": [
          "error"
        ]
      }
    }
  }
}