PangenomeGraphResponse

The top-level compact-JSON pangenome graph response. The single wire contract assembled by the serializer (T8) and served by the endpoint (T9) as a response_model. The pipeline tasks (T4-T7) produce the nodes / edges / paths / bubbles; T8 attaches each bubble's evidence and sets meta; T9 serves it with by_alias=True so the edge from/to and the camelCase fields reach the wire (CR Section 5 I1).

BioinformaticsGenomicsClinicalHealthcareData Science

Properties

Name Type Description
nodes array
edges array
paths array
bubbles array
privateVariants array
meta object
View JSON Schema on GitHub

JSON Schema

helena-bio-pangenome-graph-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/helena-bio/json-schema/helena-bio-pangenome-graph-response-schema.json",
  "title": "PangenomeGraphResponse",
  "description": "The top-level compact-JSON pangenome graph response.\n\nThe single wire contract assembled by the serializer (T8) and served by the\nendpoint (T9) as a response_model. The pipeline tasks (T4-T7) produce the\nnodes / edges / paths / bubbles; T8 attaches each bubble's evidence and\nsets meta; T9 serves it with by_alias=True so the edge from/to and the\ncamelCase fields reach the wire (CR Section 5 I1).",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/helena-bio-graph-api-openapi.yml#/components/schemas/PangenomeGraphResponse",
  "properties": {
    "nodes": {
      "items": {
        "$ref": "#/$defs/PangenomeNode"
      },
      "type": "array",
      "title": "Nodes"
    },
    "edges": {
      "items": {
        "$ref": "#/$defs/PangenomeEdge"
      },
      "type": "array",
      "title": "Edges"
    },
    "paths": {
      "items": {
        "$ref": "#/$defs/PangenomePath"
      },
      "type": "array",
      "title": "Paths"
    },
    "bubbles": {
      "items": {
        "$ref": "#/$defs/PangenomeBubble"
      },
      "type": "array",
      "title": "Bubbles"
    },
    "privateVariants": {
      "items": {
        "$ref": "#/$defs/PangenomePrivateVariant"
      },
      "type": "array",
      "title": "Privatevariants",
      "default": []
    },
    "meta": {
      "$ref": "#/$defs/PangenomeMeta"
    }
  },
  "type": "object",
  "required": [
    "nodes",
    "edges",
    "paths",
    "bubbles",
    "meta"
  ],
  "$defs": {
    "BrowserExonPextOut": {
      "properties": {
        "chrom": {
          "type": "string",
          "title": "Chrom"
        },
        "gene": {
          "type": "string",
          "title": "Gene"
        },
        "exonStart": {
          "type": "integer",
          "title": "Exonstart"
        },
        "exonEnd": {
          "type": "integer",
          "title": "Exonend"
        },
        "maxTissuePext": {
          "type": "number",
          "title": "Maxtissuepext"
        },
        "meanPext": {
          "type": "number",
          "title": "Meanpext"
        },
        "brainCortexPext": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Braincortexpext"
        },
        "wholeBloodPext": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Wholebloodpext"
        },
        "tier": {
          "type": "string",
          "title": "Tier"
        }
      },
      "type": "object",
      "required": [
        "chrom",
        "gene",
        "exonStart",
        "exonEnd",
        "maxTissuePext",
        "meanPext",
        "tier"
      ],
      "title": "BrowserExonPextOut",
      "description": "A per-exon pext marker (frontend BrowserExonPext).\n\nCR-2026-BROWSER-EVIDENCE-TRACKS-001-P2 (Wave 1, Phase 2): a NEW pext-lane\nsource read from the read-only reference_db table exon_pext (gnomAD v4.1 /\nGTEx v10 per-exon expression proportion). Wire names are camelCase (the\nexisting svType / iscaId convention). The per-field types follow EXON_PEXT_\nDDL (registry/exon_pext.py): chromosome / gene_symbol VARCHAR -> str;\nexon_start / exon_end BIGINT -> int; max_tissue_pext / mean_pext FLOAT NOT\nNULL -> float; brain_cortex_pext / whole_blood_pext FLOAT nullable ->\nOptional[float]. tier is DERIVED server-side from maxTissuePext via\n_pext_tier using the classifier's exact PVS1 cut (acmg_classifier.py\nL5155-5160): one of 'full' | 'downgrade' | 'block' (CR Section 2.3)."
    },
    "BrowserSnvOut": {
      "properties": {
        "chrom": {
          "type": "string",
          "title": "Chrom"
        },
        "pos": {
          "type": "integer",
          "title": "Pos"
        },
        "gene": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gene"
        },
        "cls": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Cls"
        },
        "hgvs": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hgvs"
        },
        "ref": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ref"
        },
        "alt": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Alt"
        },
        "bayesdelNoaf": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Bayesdelnoaf"
        },
        "bayesdelNoafPred": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Bayesdelnoafpred"
        },
        "spliceaiMax": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Spliceaimax"
        },
        "spliceaiPred": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Spliceaipred"
        },
        "phylop": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Phylop"
        },
        "gerp": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gerp"
        },
        "alphamissense": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Alphamissense"
        },
        "sift": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sift"
        },
        "metasvm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Metasvm"
        },
        "dann": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Dann"
        },
        "mpc": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Mpc"
        },
        "af": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Af"
        },
        "afGrpmax": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Afgrpmax"
        },
        "popmax": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Popmax"
        },
        "hom": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hom"
        },
        "loeuf": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Loeuf"
        },
        "misZ": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Misz"
        },
        "pli": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pli"
        },
        "clinvarSig": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Clinvarsig"
        },
        "reviewStars": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reviewstars"
        },
        "clinvarId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Clinvarid"
        },
        "criteria": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Criteria"
        },
        "confidence": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Confidence"
        },
        "consequence": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Consequence"
        },
        "impact": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Impact"
        },
        "hgvsCdna": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hgvscdna"
        },
        "transcriptId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Transcriptid"
        },
        "transcriptRepresentations": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Transcriptrepresentations"
        },
        "exonNumber": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Exonnumber"
        },
        "domains": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Domains"
        },
        "pm1Source": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pm1Source"
        },
        "vcepApplied": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Vcepapplied"
        },
        "vcepPanel": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Vceppanel"
        },
        "deNovo": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Denovo"
        },
        "hiScore": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hiscore"
        },
        "tsScore": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Tsscore"
        }
      },
      "type": "object",
      "required": [
        "chrom",
        "pos"
      ],
      "title": "BrowserSnvOut",
      "description": "A small variant marker (frontend BrowserSnv).\n\nCR-2026-BROWSER-EVIDENCE-TRACKS-001-P1 (Wave 1, Phase 1): the five\nestablished fields (chrom, pos, gene, cls, hgvs) are UNCHANGED. Below them\n35 ADDITIVE per-variant evidence fields are appended, ALL Optional with a\nNone default (a pure additive contract widening -- an old frontend ignores\nthe unknown keys, a new frontend can be built against the widened contract).\nEach field is read from the per-session `variants` table; a session whose\ntable lacks a source column degrades to None via _evidence_columns_present\n(the schema-drift guard), so every field is genuinely optional.\n\nWire names are camelCase (matching the existing svType / iscaId convention).\nThe wire-name -> `variants` source-column mapping is CR Section 3a; the\nper-field types follow the source column types in variant_schema.py\n(re-verified 2026-06-20, Eunomia B1). CRITICAL (Eunomia B1): exonNumber and\npopmax are Optional[str] -- exon_number is VARCHAR(20) carrying the VEP\n\"X/Y\" form (e.g. \"3/12\"), popmax is VARCHAR(10) carrying a population LABEL,\nNOT a number; typing either as int would raise a Pydantic ValidationError\n-> 500 on a real coding-gene window, which the frontend degrade-clean\nhandler masks as a silently-empty browser."
    },
    "PangenomeBubble": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id"
        },
        "position": {
          "type": "integer",
          "title": "Position"
        },
        "alleles": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Alleles"
        },
        "evidence": {
          "anyOf": [
            {
              "$ref": "#/$defs/PangenomeBubbleEvidence"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object",
      "required": [
        "id",
        "position",
        "alleles"
      ],
      "title": "PangenomeBubble",
      "description": "A variant site (a snarl / bubble).\n\nposition is the reference-path position of the site in the SAME coordinate\nbasis the linear browser uses (PANGENOME_COORDINATE_SYSTEM). evidence is\nOptional/None-defaulted: a bubble with no overlapping classifier evidence\ncarries None, exactly as the linear view's per-field None-degrade does. T8\nowns POPULATING evidence; T3 owns its SHAPE."
    },
    "PangenomeBubbleEvidence": {
      "properties": {
        "snv": {
          "anyOf": [
            {
              "$ref": "#/$defs/BrowserSnvOut"
            },
            {
              "type": "null"
            }
          ]
        },
        "pext": {
          "anyOf": [
            {
              "$ref": "#/$defs/BrowserExonPextOut"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object",
      "title": "PangenomeBubbleEvidence",
      "description": "The bubble evidence SLOT -- the clinical-critical reuse of the shared\nlinear-view evidence shape.\n\nIt REUSES the SAME models the linear browser serves (BrowserSnvOut: the\nfive established fields + 35 additive evidence fields; BrowserExonPextOut:\nthe per-exon pext lane incl. the server-derived tier), imported from\ninfrastructure.browser_evidence. There is NO second, graph-specific\nevidence shape: a bubble carries the SAME evidence the linear view serves\nso a clinician sees identical evidence in both views and the graph view\nnever recomputes a verdict (CR Section 2.5). The serializer (T8) POPULATES\nthis slot from the same classifier evidence the linear view reads (CR I3);\nT3 owns only the SHAPE."
    },
    "PangenomeEdge": {
      "properties": {
        "from": {
          "type": "string",
          "title": "From"
        },
        "to": {
          "type": "string",
          "title": "To"
        }
      },
      "type": "object",
      "required": [
        "from",
        "to"
      ],
      "title": "PangenomeEdge",
      "description": "A graph edge (GFA v1.1 link / L-line): a directed node-id pair.\n\nThe wire field names are `from` / `to`. `from` is a Python reserved\nkeyword and cannot be a field name, so the Python fields are from_node /\nto_node carrying Field(alias=...) -- the SERIALIZED wire JSON is\n{\"from\": ..., \"to\": ...}. populate_by_name=True lets the serializer (T8)\nconstruct by Python name (from_node=...) while the endpoint (T9) serializes\nby alias (by_alias=True; CR Section 5 I1). Orientation is a server-side\nlayout concern; the wire carries only the from/to node-id pair the frontend\ndraws."
    },
    "PangenomeMeta": {
      "properties": {
        "locus": {
          "type": "string",
          "title": "Locus"
        },
        "coordinateSystem": {
          "type": "string",
          "title": "Coordinatesystem",
          "default": "grch38-ref-path-ucsc-1based"
        },
        "inferredPhasing": {
          "type": "boolean",
          "title": "Inferredphasing",
          "default": true
        }
      },
      "type": "object",
      "required": [
        "locus"
      ],
      "title": "PangenomeMeta",
      "description": "The response metadata.\n\ncoordinateSystem defaults to PANGENOME_COORDINATE_SYSTEM (the linear-browser\nbasis, declared on the wire so the two views share selection).\ninferredPhasing is the phasing-honesty flag: True when the patient route is\nan INFERRED route (an unphased case threaded as if it had a single route),\nFalse when the route derives from real phasing (VCF PS tags). Default True\nis the conservative, honest default -- an unset flag must not assert real\nphasing; T6 owns flipping it to False only when phasing is real (CR Section\n2.3, AC-4). coordinateSystem / inferredPhasing are camelCase identifiers\n(no keyword clash, valid Python names), so they need no alias."
    },
    "PangenomeNode": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id"
        },
        "x": {
          "type": "number",
          "title": "X"
        },
        "y": {
          "type": "number",
          "title": "Y"
        },
        "label": {
          "type": "string",
          "title": "Label"
        },
        "kind": {
          "type": "string",
          "title": "Kind"
        },
        "length": {
          "type": "integer",
          "title": "Length"
        },
        "bubbleId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Bubbleid"
        }
      },
      "type": "object",
      "required": [
        "id",
        "x",
        "y",
        "label",
        "kind",
        "length"
      ],
      "title": "PangenomeNode",
      "description": "A graph node (GFA v1.1 segment / S-line).\n\nid is the segment name; length is the segment sequence length (GFA LN);\nlabel is a short display string (the node sequence or a truncation the\nserializer T8 decides); x / y are the server-computed layout coordinates\n(T7); kind is the node role for rendering, declared as str so the contract\ndoes not over-constrain a value set the pipeline (T8) owns (CR I4).\n\nbubbleId (CR-2026-VA-PANGENOME-VISUAL-LANGUAGE-001, T2): the id of the\nSNARL/bubble this node BELONGS to (its owning bubble's id), surfaced by the\nserializer DIRECTLY from at_by_bubble_id (the producer membership truth) so\nthe frontend resolves node -> bubble -> evidence.snv.cls as an O(1) EXACT\nlookup for the ACMG node colour -- NOT a client re-derivation from a lossy\ncoordinate. ADDITIVE and backward-compatible: None for a node with no\nsurfaced membership (a reference-backbone node, or an unanchored node) --\nan absent membership is None, never a wrong id. The membership COMPUTATION\nis unchanged (threading at_by_bubble_id); T2 only SURFACES it onto the node."
    },
    "PangenomePath": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id"
        },
        "name": {
          "type": "string",
          "title": "Name"
        },
        "route": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Route"
        },
        "bold": {
          "type": "boolean",
          "title": "Bold",
          "default": false
        }
      },
      "type": "object",
      "required": [
        "id",
        "name",
        "route"
      ],
      "title": "PangenomePath",
      "description": "A haplotype route (GFA v1.1 walk / W-line).\n\nroute is the ordered node-id array (the walk); name follows the PanSN\nconvention the T1 asset records (sample#haplotype#contig, e.g.\nGRCh38#0#chr18). bold marks the patient's threaded route (True); the\nreference backbone is False (default)."
    },
    "PangenomePrivateVariant": {
      "properties": {
        "position": {
          "type": "integer",
          "title": "Position"
        },
        "gene": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gene"
        },
        "acmgClass": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Acmgclass"
        },
        "evidence": {
          "anyOf": [
            {
              "$ref": "#/$defs/PangenomeBubbleEvidence"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object",
      "required": [
        "position"
      ],
      "title": "PangenomePrivateVariant",
      "description": "A PRIVATE classified variant -- a ghost bubble.\n\nCR-2026-VA-PANGENOME-PRIVATE-VARIANT-GHOST-BUBBLE-001 (additive, modelled on\nPangenomeBubble + PangenomeBubbleEvidence). A private variant is a patient\nCLASSIFIED variant whose position is NOT an equal-position bubble.position --\ni.e. the HPRC panel carries no snarl for it, so the patient is threaded as a\nROUTE through existing panel nodes and the variant forms no bubble. The\nserializer (T8) computes the set as the COMPLEMENT: the windowed classified\nSNVs whose position is not in {bubble.position}, from the SAME single windowed\nSNV read + the SAME snv_by_pos index the bubble evidence attach uses (no second\nread, no graph mutation, no schema change). The frontend renders each as an\nACMG-coloured GHOST BUBBLE in the graph's own grammar.\n\nposition is the global 1-based UCSC bp -- the SAME shared-selection basis a\nbubble carries (PANGENOME_COORDINATE_SYSTEM), so the ghost selects the same\nsite the linear view does. acmgClass + gene are read STRAIGHT from the backend\nclassification (the snv's own BrowserSnvOut.cls / .gene -- NEVER re-derived on\nthe client). evidence REUSES the SAME PangenomeBubbleEvidence slot a bubble\ncarries (the shared BrowserSnvOut), so the ghost opens the IDENTICAL evidence\npanel a bubble opens (one evidence model, no second graph-specific shape)."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/helena-bio-pangenome-graph-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.