pub.chive.graph.getEdge

chive.pub

Documentation

Retrieve a knowledge graph edge by AT-URI

main query

Retrieve a knowledge graph edge by AT-URI

Parameters

uri string at-uri Required

Edge AT-URI

Output

Encodingapplication/json
Schema#graphEdge

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
Edge AT-URI
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "NotFound"
    }
  ],
  "output": {
    "schema": {
      "ref": "#graphEdge",
      "type": "ref"
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "uri"
    ],
    "properties": {
      "uri": {
        "type": "string",
        "format": "at-uri",
        "description": "Edge AT-URI"
      }
    }
  },
  "description": "Retrieve a knowledge graph edge by AT-URI"
}
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"
}

Lexicon Garden

@