pub.chive.graph.getNode

chive.pub

Documentation

Retrieve a unified knowledge graph node by ID

main query

Retrieve a unified knowledge graph node by ID

Parameters

id string Required

Node ID (UUID or rkey)

includeEdges boolean Optional

Include connected edges in the response

Output

Encodingapplication/json
Schema#nodeWithEdges

Errors

NotFound
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
Node ID (UUID or rkey)
Include connected edges in the response
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "NotFound"
    }
  ],
  "output": {
    "schema": {
      "ref": "#nodeWithEdges",
      "type": "ref"
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Node ID (UUID or rkey)"
      },
      "includeEdges": {
        "type": "boolean",
        "default": false,
        "description": "Include connected edges in the response"
      }
    }
  },
  "description": "Retrieve a unified knowledge graph node by ID"
}
graphEdge object

Graph edge response

Properties

cid string Optional

Content identifier

createdAt string datetime Required

Creation timestamp

createdBy string did Optional

DID of creator

id string Required

Edge UUID identifier

proposalUri string at-uri Optional

AT-URI of creating proposal

relationSlug string Required

Relation slug (broader, narrower, related, etc.)

relationUri string at-uri Optional

AT-URI of relation type node

sourceUri string at-uri Required

AT-URI of source node

status string Required

Edge lifecycle status

Known values: proposed, established, deprecated
targetUri string at-uri Required

AT-URI of target node

updatedAt string datetime Optional

Last update timestamp

uri string at-uri Required

AT-URI of the edge

weight integer Optional

Edge weight (scaled by 1000 for 0.0-1.0 range)

minimum: 0maximum: 1000
View raw schema 
{
  "type": "object",
  "required": [
    "id",
    "uri",
    "sourceUri",
    "targetUri",
    "relationSlug",
    "status",
    "createdAt"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Edge UUID identifier"
    },
    "cid": {
      "type": "string",
      "description": "Content identifier"
    },
    "uri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of the edge"
    },
    "status": {
      "type": "string",
      "description": "Edge lifecycle status",
      "knownValues": [
        "proposed",
        "established",
        "deprecated"
      ]
    },
    "weight": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 0,
      "description": "Edge weight (scaled by 1000 for 0.0-1.0 range)"
    },
    "metadata": {
      "ref": "pub.chive.graph.edge#edgeMetadata",
      "type": "ref",
      "description": "Edge-specific metadata"
    },
    "createdAt": {
      "type": "string",
      "format": "datetime",
      "description": "Creation timestamp"
    },
    "createdBy": {
      "type": "string",
      "format": "did",
      "description": "DID of creator"
    },
    "sourceUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of source node"
    },
    "targetUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of target node"
    },
    "updatedAt": {
      "type": "string",
      "format": "datetime",
      "description": "Last update timestamp"
    },
    "proposalUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of creating proposal"
    },
    "relationUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of relation type node"
    },
    "relationSlug": {
      "type": "string",
      "description": "Relation slug (broader, narrower, related, etc.)"
    }
  },
  "description": "Graph edge response"
}
nodeWithEdges object

Graph node with optional connected edges

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

edges array of ref#graphEdge Optional

Connected edges (when includeEdges=true)

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"
      ]
    },
    "edges": {
      "type": "array",
      "items": {
        "ref": "#graphEdge",
        "type": "ref"
      },
      "description": "Connected edges (when includeEdges=true)"
    },
    "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 with optional connected edges"
}

Lexicon Garden

@