genage_aging read

{
  "additionalProperties": false,
  "description": "Input schema for ``scidex.forge.genage_aging``.",
  "properties": {
    "gene": {
      "default": "",
      "description": "HGNC gene symbol or free-text search term (e.g. ``'FOXO3'``, ``'SIRT1'``, ``'telomerase'``). Pass an empty string to browse the full database up to *limit* entries.",
      "maxLength": 100,
      "title": "Gene",
      "type": "string"
    },
    "aging_role": {
      "default": "",
      "description": "Optional filter by aging role. Pass ``'pro-longevity'``, ``'anti-longevity'``, or ``'unclear'`` to restrict results. Empty string (default) returns all roles.",
      "maxLength": 50,
      "title": "Aging Role",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of aging gene records to return (default 20, max 200).",
      "maximum": 200,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "ForgeGenageIn",
  "type": "object"
}

{
  "$defs": {
    "AgingGene": {
      "description": "One GenAge aging gene record.",
      "properties": {
        "hgnc_symbol": {
          "description": "HGNC gene symbol (e.g. FOXO3, SIRT1).",
          "title": "Hgnc Symbol",
          "type": "string"
        },
        "entrez_id": {
          "default": "",
          "description": "NCBI Entrez gene ID, or empty string if not available.",
          "title": "Entrez Id",
          "type": "string"
        },
        "name": {
          "default": "",
          "description": "Full gene name from GenAge.",
          "title": "Name",
          "type": "string"
        },
        "aging_role": {
          "default": "",
          "description": "Curated aging role: ``'pro-longevity'``, ``'anti-longevity'``, ``'unclear'``, or empty when not classified.",
          "title": "Aging Role",
          "type": "string"
        },
        "senescence_effect": {
          "default": "",
          "description": "Effect on cellular senescence as reported in GenAge.",
          "title": "Senescence Effect",
          "type": "string"
        },
        "lifespan_effect": {
          "default": "",
          "description": "Reported effect on organism lifespan.",
          "title": "Lifespan Effect",
          "type": "string"
        },
        "longevity_influence": {
          "default": "",
          "description": "Influence on longevity (e.g. GWAS / SNP / expression evidence).",
          "title": "Longevity Influence",
          "type": "string"
        },
        "interventions": {
          "description": "Curated interventions (e.g. over-expression, knockout, drug).",
          "items": {
            "type": "string"
          },
          "title": "Interventions",
          "type": "array"
        },
        "references": {
          "default": 0,
          "description": "Number of PubMed references supporting this entry.",
          "title": "References",
          "type": "integer"
        }
      },
      "required": [
        "hgnc_symbol"
      ],
      "title": "AgingGene",
      "type": "object"
    }
  },
  "description": "Response shape for ``scidex.forge.genage_aging``.",
  "properties": {
    "query": {
      "description": "The gene/search term that was queried.",
      "title": "Query",
      "type": "string"
    },
    "genes": {
      "description": "Aging gene records from GenAge matching the query and filters.",
      "items": {
        "$ref": "#/$defs/AgingGene"
      },
      "title": "Genes",
      "type": "array"
    },
    "not_found": {
      "default": false,
      "description": "``True`` when no GenAge records matched the query or filters. ``False`` when at least one record was returned.",
      "title": "Not Found",
      "type": "boolean"
    },
    "took_ms": {
      "default": 0,
      "description": "Wall-clock time for the upstream API call in milliseconds.",
      "title": "Took Ms",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "ForgeGenageOut",
  "type": "object"
}