Query: Lookup

Find a node by entity ID.

method · POST

/query

Authentication: Required (if enabled)

Find a node by its entity ID.

Request

{
  "type": "lookup",
  "entity_id": 1
}

Field	Type	Required	Description
type	string	Yes	Must be "lookup".
entity_id	integer (u64)	Yes	Entity to look up.

Response

Found

{
  "success": true,
  "found": true,
  "path": [0],
  "edges": [],
  "grounding": "fact",
  "error": null
}

When found is false, diagnostic explains why (e.g. entity_not_found).

Example

curl -X POST http://localhost:8080/query \
     -H "Authorization: Bearer your-api-key" \
     -H "Content-Type: application/json" \
     -d '{"type": "lookup", "entity_id": 1}'