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.
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