Skip to main content
GET
/
entity-edge
/
{uuid}
Get Entity Edge
curl --request GET \
  --url https://memory.stru.ai/entity-edge/{uuid} \
  --header 'X-API-Key: <x-api-key>'
{
  "404": {},
  "422": {},
  "edges": [
    {
      "uuid": "<string>",
      "source_node_uuid": "<string>",
      "target_node_uuid": "<string>",
      "relationship_type": "<string>",
      "created_at": "<string>"
    }
  ]
}

​
Overview

Retrieve all relationship edges connected to a specific entity node. This shows how the entity is connected to other entities in the knowledge graph.
Advanced Feature: This endpoint is for advanced knowledge graph inspection. Most users don’t need to directly access entity edges. Use the standard memory retrieval endpoints instead.

​
Authentication

​
X-API-Key
string
required
Your API key for authentication
X-API-Key: windowseat

​
Path Parameters

​
uuid
string
required
UUID of the entity node to get edges for
/entity-edge/e090f257-c182-4930-819d-161c66bee335

​
Response

​
edges
array
Array of relationship edges connected to this entity

​
Example Request

curl -X GET https://memory.stru.ai/entity-edge/e090f257-c182-4930-819d-161c66bee335 \
  -H "X-API-Key: windowseat"

​
Example Response

{
  "edges": [
    {
      "uuid": "edge_uuid_123",
      "source_node_uuid": "e090f257-c182-4930-819d-161c66bee335",
      "target_node_uuid": "f32a1b9c-7d45-4e8f-9a1c-b3d2e4f5a678",
      "relationship_type": "USES",
      "created_at": "2025-10-11T03:15:00Z"
    },
    {
      "uuid": "edge_uuid_456",
      "source_node_uuid": "e090f257-c182-4930-819d-161c66bee335",
      "target_node_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "relationship_type": "LOCATED_IN",
      "created_at": "2025-10-11T03:16:00Z"
    }
  ]
}

​
Use Cases

Explore Relationships

Discover how an entity is connected to other entities in the knowledge graph

Graph Visualization

Get relationship data to build visual graph representations

Relationship Analysis

Analyze patterns in how entities are related

​
Error Responses

​
422
Validation Error
Invalid UUID format
{
  "detail": [
    {
      "loc": ["path", "uuid"],
      "msg": "value is not a valid uuid",
      "type": "type_error.uuid"
    }
  ]
}
​
404
Not Found
Entity node not found
{
  "detail": "Entity node not found"
}