pub.chive.graph.listNodes

chive.pub

Documentation

List knowledge graph nodes with optional filtering by kind, subkind, and status

main query

List knowledge graph nodes with optional filtering by kind, subkind, and status

Parameters

cursor string Optional

Pagination cursor

externalIdIdentifier string Optional

Filter nodes whose externalIds array includes an entry with this identifier. Must be combined with externalIdSystem.

externalIdSystem string Optional

Filter nodes whose externalIds array includes an entry with this system. Must be combined with externalIdIdentifier.

kind string Optional

Filter by node kind

limit integer Optional

Maximum results to return

status string Optional

Filter by lifecycle status

subkind string Optional

Filter by subkind slug

Output

Encodingapplication/json
cursor string Optional

Pagination cursor for next page

hasMore boolean Required

Whether more results exist

nodes array Required

List of nodes

total integer Required

Total count of matching nodes

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Pagination cursor
Filter nodes whose externalIds array includes an entry with this identifier. Must be combined with externalIdSystem.
Filter nodes whose externalIds array includes an entry with this system. Must be combined with externalIdIdentifier.
Filter by node kind
Maximum results to return
Filter by lifecycle status
Filter by subkind slug
View raw schema 
{
  "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 object

Graph node response

Properties

alternateLabels array of string Optional

Alternate labels/synonyms

cid string Optional

Content identifier

createdAt string datetime Required

Creation timestamp

createdBy string did Optional

DID of creator

deprecatedBy string at-uri Optional

AT-URI of superseding node

description string Optional

Detailed description

id string Required

Node UUID identifier

kind string Required

Node kind: type or object

Known values: type, object
label string Required

Primary display label

proposalUri string at-uri Optional

AT-URI of creating proposal

status string Required

Lifecycle status

Known values: proposed, provisional, established, deprecated
subkind string Optional

Subkind slug (e.g., field, institution)

subkindUri string at-uri Optional

AT-URI of the subkind type node

updatedAt string datetime Optional

Last update timestamp

uri string at-uri Required

AT-URI of the node

View raw schema 
{
  "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"
}

Lexicon Garden

@