Semantic entity search within a space's graph

View as Markdown
Semantic search over the entities in a space. JSON body: `text` (1-2000 chars, required — the natural-language query), optional `topK` (1-100) to cap results, optional `types` (non-empty array of organization | person | location | identifier | date | amount | other) to restrict to entity kinds. Returns `{ matches }`, each `{ id, type, name, score }` ranked by similarity (higher `score` = closer). Requires `space:read` on `:spaceId`; missing access surfaces as a 404.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

Request

This endpoint expects an object.
textstringRequired1-2000 characters
topKintegerOptional1-100
typeslist of enumsOptional

Response

Ranked entity matches.
matcheslist of objects