Explore Graph

POST /agent/graph

Get an overview of the entire knowledge graph for a volume — all entities and their relationships.

Request

Body:

Field	Type	Required	Description
volume_id	string (UUID)	Yes	Volume ID
limit	integer	No	Max entities (1–200, default: 100)

Response

{
  "volume_id": "...",
  "entities": [
    {
      "name": "John Smith",
      "type": "person",
      "summary": "CTO of Acme Corp",
      "factCount": 8
    },
    {
      "name": "Acme Corp",
      "type": "organization",
      "summary": "Technology company",
      "factCount": 5
    }
  ],
  "relationships": [
    {
      "source": "John Smith",
      "type": "WORKS_AT",
      "description": "Chief Technology Officer since 2022",
      "target": "Acme Corp",
      "strength": 0.95
    }
  ]
}

Response Fields

Field	Description
entities	Array of entities, ordered by fact count descending
entities[].factCount	Number of facts attached to the entity
relationships	Array of relationships (max 200)
relationships[].strength	Relationship confidence score

Example

curl -X POST https://api.sharedmemory.ai/agent/graph \
  -H "Authorization: Bearer sm_agent_..." \
  -H "Content-Type: application/json" \
  -d '{
    "volume_id": "a1b2c3d4-...",
    "limit": 50
  }'