{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/connections-icu/json-schema/connections-icu-network-neighborhood-response-schema.json",
  "title": "NetworkNeighborhoodResponse",
  "description": "Result of GET /network: the confirmed network neighborhood rooted at the credential owner.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/connections-icu-network-api-openapi.yml#/components/schemas/NetworkNeighborhoodResponse",
  "type": "object",
  "required": [
    "rootSub",
    "nodes",
    "edges",
    "truncated"
  ],
  "properties": {
    "rootSub": {
      "type": "string",
      "description": "The credential owner's AEGIS sub."
    },
    "nodes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sub": {
            "type": "string"
          },
          "ring": {
            "type": "integer",
            "enum": [
              1,
              2
            ]
          },
          "displayName": {
            "type": "string",
            "description": "From the owner's own contact card. Always empty for ring-2 nodes (another owner's contact card never crosses the seam)."
          }
        }
      }
    },
    "edges": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fromSub": {
            "type": "string"
          },
          "toSub": {
            "type": "string"
          },
          "matchKind": {
            "type": "string",
            "enum": [
              "deterministic",
              "user_confirmed"
            ]
          },
          "ring": {
            "type": "integer",
            "enum": [
              1,
              2
            ]
          }
        }
      }
    },
    "truncated": {
      "type": "boolean",
      "description": "True when a ring hit its limit: the picture is partial."
    }
  }
}