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