pub.chive.graph.getNode

lexicons.governance.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 
{
  "description": "Retrieve a unified knowledge graph node by ID",
  "errors": [
    {
      "name": "NotFound"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "ref": "#nodeWithEdges",
      "type": "ref"
    }
  },
  "parameters": {
    "properties": {
      "id": {
        "description": "Node ID (UUID or rkey)",
        "type": "string"
      },
      "includeEdges": {
        "default": false,
        "description": "Include connected edges in the response",
        "type": "boolean"
      }
    },
    "required": [
      "id"
    ],
    "type": "params"
  },
  "type": "query"
}
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 
{
  "description": "Graph edge response",
  "properties": {
    "cid": {
      "description": "Content identifier",
      "type": "string"
    },
    "createdAt": {
      "description": "Creation timestamp",
      "format": "datetime",
      "type": "string"
    },
    "createdBy": {
      "description": "DID of creator",
      "format": "did",
      "type": "string"
    },
    "id": {
      "description": "Edge UUID identifier",
      "type": "string"
    },
    "metadata": {
      "description": "Edge-specific metadata",
      "ref": "pub.chive.graph.edge#edgeMetadata",
      "type": "ref"
    },
    "proposalUri": {
      "description": "AT-URI of creating proposal",
      "format": "at-uri",
      "type": "string"
    },
    "relationSlug": {
      "description": "Relation slug (broader, narrower, related, etc.)",
      "type": "string"
    },
    "relationUri": {
      "description": "AT-URI of relation type node",
      "format": "at-uri",
      "type": "string"
    },
    "sourceUri": {
      "description": "AT-URI of source node",
      "format": "at-uri",
      "type": "string"
    },
    "status": {
      "description": "Edge lifecycle status",
      "knownValues": [
        "proposed",
        "established",
        "deprecated"
      ],
      "type": "string"
    },
    "targetUri": {
      "description": "AT-URI of target node",
      "format": "at-uri",
      "type": "string"
    },
    "updatedAt": {
      "description": "Last update timestamp",
      "format": "datetime",
      "type": "string"
    },
    "uri": {
      "description": "AT-URI of the edge",
      "format": "at-uri",
      "type": "string"
    },
    "weight": {
      "description": "Edge weight (scaled by 1000 for 0.0-1.0 range)",
      "maximum": 1000,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "id",
    "uri",
    "sourceUri",
    "targetUri",
    "relationSlug",
    "status",
    "createdAt"
  ],
  "type": "object"
}
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 
{
  "description": "Graph node with optional connected edges",
  "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"
    },
    "edges": {
      "description": "Connected edges (when includeEdges=true)",
      "items": {
        "ref": "#graphEdge",
        "type": "ref"
      },
      "type": "array"
    },
    "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"
}

Lexicon Garden

@