# pub.chive.graph.getEdge

> Published by [chive.pub](https://lexicon.garden/identity/did:plc:7natp5xae72bddaqlkef2t4e)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.graph.getEdge)
- [Documentation](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.graph.getEdge/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.graph.getEdge/examples)

## Definitions

### `pub.chive.graph.getEdge`

**Type**: `query`

Retrieve a knowledge graph edge by AT-URI

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `uri` | `string` (at-uri) | Yes | Edge AT-URI |

#### Output

**Encoding**: `application/json`

#### Errors

- **NotFound**

### `pub.chive.graph.getEdge#graphEdge`

**Type**: `object`

Graph edge response

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | Yes | Edge UUID identifier |
| `cid` | `string` | No | Content identifier |
| `uri` | `string` (at-uri) | Yes | AT-URI of the edge |
| `status` | `string` | Yes | Edge lifecycle status |
| `weight` | `integer` | No | Edge weight (scaled by 1000 for 0.0-1.0 range) |
| `metadata` | `ref` → `pub.chive.graph.edge#edgeMetadata` | No | Edge-specific metadata |
| `createdAt` | `string` (datetime) | Yes | Creation timestamp |
| `createdBy` | `string` (did) | No | DID of creator |
| `sourceUri` | `string` (at-uri) | Yes | AT-URI of source node |
| `targetUri` | `string` (at-uri) | Yes | AT-URI of target node |
| `updatedAt` | `string` (datetime) | No | Last update timestamp |
| `proposalUri` | `string` (at-uri) | No | AT-URI of creating proposal |
| `relationUri` | `string` (at-uri) | No | AT-URI of relation type node |
| `relationSlug` | `string` | Yes | Relation slug (broader, narrower, related, etc.) |

## Raw Schema

```json
{
  "id": "pub.chive.graph.getEdge",
  "defs": {
    "main": {
      "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": {
      "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"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "revision": 1
}
```