pub.chive.graph.listNodes

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "graphNode": {
      "description": "Graph node response",
      "properties": {
        "alternateLabels": {
          "description": "Alternate labels/synonyms",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "cid": {
          "description": "Content identifier",
          "type": "string"
        },
        "createdAt": {
          "description": "Creation timestamp",
          "format": "datetime",
          "type": "string"
        },
        "createdBy": {
          "description": "DID of creator",
          "format": "did",
          "type": "string"
        },
        "deprecatedBy": {
          "description": "AT-URI of superseding node",
          "format": "at-uri",
          "type": "string"
        },
        "description": {
          "description": "Detailed description",
          "type": "string"
        },
        "externalIds": {
          "description": "External identifier mappings",
          "items": {
            "ref": "pub.chive.graph.node#externalId",
            "type": "ref"
          },
          "type": "array"
        },
        "id": {
          "description": "Node UUID identifier",
          "type": "string"
        },
        "kind": {
          "description": "Node kind: type or object",
          "knownValues": [
            "type",
            "object"
          ],
          "type": "string"
        },
        "label": {
          "description": "Primary display label",
          "type": "string"
        },
        "metadata": {
          "description": "Subkind-specific metadata",
          "ref": "pub.chive.graph.node#nodeMetadata",
          "type": "ref"
        },
        "proposalUri": {
          "description": "AT-URI of creating proposal",
          "format": "at-uri",
          "type": "string"
        },
        "status": {
          "description": "Lifecycle status",
          "knownValues": [
            "proposed",
            "provisional",
            "established",
            "deprecated"
          ],
          "type": "string"
        },
        "subkind": {
          "description": "Subkind slug (e.g., field, institution)",
          "type": "string"
        },
        "subkindUri": {
          "description": "AT-URI of the subkind type node",
          "format": "at-uri",
          "type": "string"
        },
        "updatedAt": {
          "description": "Last update timestamp",
          "format": "datetime",
          "type": "string"
        },
        "uri": {
          "description": "AT-URI of the node",
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "id",
        "uri",
        "kind",
        "label",
        "status",
        "createdAt"
      ],
      "type": "object"
    },
    "main": {
      "description": "List knowledge graph nodes with optional filtering by kind, subkind, and status",
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "cursor": {
              "description": "Pagination cursor for next page",
              "type": "string"
            },
            "hasMore": {
              "description": "Whether more results exist",
              "type": "boolean"
            },
            "nodes": {
              "description": "List of nodes",
              "items": {
                "ref": "#graphNode",
                "type": "ref"
              },
              "type": "array"
            },
            "total": {
              "description": "Total count of matching nodes",
              "type": "integer"
            }
          },
          "required": [
            "nodes",
            "hasMore",
            "total"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "cursor": {
            "description": "Pagination cursor",
            "type": "string"
          },
          "externalIdIdentifier": {
            "description": "Filter nodes whose externalIds array includes an entry with this identifier. Must be combined with externalIdSystem.",
            "type": "string"
          },
          "externalIdSystem": {
            "description": "Filter nodes whose externalIds array includes an entry with this system. Must be combined with externalIdIdentifier.",
            "type": "string"
          },
          "kind": {
            "description": "Filter by node kind",
            "knownValues": [
              "type",
              "object"
            ],
            "type": "string"
          },
          "limit": {
            "default": 50,
            "description": "Maximum results to return",
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "status": {
            "description": "Filter by lifecycle status",
            "knownValues": [
              "proposed",
              "provisional",
              "established",
              "deprecated"
            ],
            "type": "string"
          },
          "subkind": {
            "description": "Filter by subkind slug",
            "type": "string"
          }
        },
        "type": "params"
      },
      "type": "query"
    }
  },
  "id": "pub.chive.graph.listNodes",
  "lexicon": 1,
  "revision": 1
}