Get a single entity

Returns the named entity's graph node, enriched with description and chunk_text fetched from Weaviate via the same deterministic-UUID lookup the MCP get_entity tool uses.

description/chunk_text are null (not an error) when the entity has no chunk in Weaviate — a structural-only node — or when Weaviate is unreachable: the graph JSON is the source of truth for the entity's existence.

Path parameters

Query parameters

Request

curl "localhost:8000/graph/your-repo/entity?name=src.http.RequestHandler" \
  -H "Authorization: Bearer $TOKEN"

Responses

{
  "id": 42,
  "kind": "Class",
  "qualified_name": "src.http.RequestHandler",
  "path": "src/http/request_handler.py",
  "start_line": 10, "end_line": 80,
  "description": "Parses an incoming request and dispatches it to a service.",
  "chunk_text": "..."
}

{ "detail": "entity 'src.http.RequestHandler' not found in project 'your-repo' graph" }