Visualize Semantic
Return semantic positions and clusters for the same subgraph as GET /visualize/json.
Pass the same arguments used for GET /visualize/json to lay out the
same subgraph semantically. This is the one call that fetches
embeddings (up to 2000 nodes) and runs PCA/UMAP over them, so it is
only worth calling when the semantic tab is actually open.
Query Parameters
Same as GET /visualize/json.
- dataset_id (UUID): UUID of the dataset to visualize. List your datasets via GET /api/v1/datasets to find it.
- full (bool): Include the entire graph instead of a bounded subgraph. Defaults to False.
- max_nodes (int): Hard cap on rendered nodes after expansion. Defaults to 500.
- neighborhood_depth (int): k-hop neighborhood depth for subgraph expansion. Defaults to 2.
- neighborhood_seed_top_k (int): Maximum number of seed nodes. Defaults to 10.
- query (Optional[str]): Query string whose nearest vector hits seed the subgraph.
- seed_node_ids (Optional[List[str]]): Explicit seed node ids for subgraph neighborhood expansion.
Response
A JSON object with semantic_positions and semantic_clusters,
either of which is null when there are no embeddings to lay out.
Error Codes
- 409 Conflict: Dataset not found, permission denied, or the payload could not be built (generic message; full detail is server-logged, not returned, to avoid leaking internals)
Notes
- User must have read permissions on the dataset
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
UUID of the dataset to visualize. List your datasets via GET /api/v1/datasets to find it.
""
Include the entire graph instead of a bounded subgraph.
Query string whose nearest vector hits seed the subgraph.
Explicit seed node ids for subgraph neighborhood expansion.
k-hop neighborhood depth for subgraph expansion.
1 <= x <= 10Maximum number of seed nodes.
1 <= x <= 100Hard cap on rendered nodes after expansion.
1 <= x <= 5000Response
Successful Response