Skip to navigation

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