Semantic entity search across the org-wide graph

POST

/ontology/search

Semantic search over entities in the organization-wide graph. JSON body: text (1-2000 chars, required), optional topK (1-100), optional types (non-empty array of organization | person | location | identifier | date | amount | other). Returns { matches }, each { id, type, name, score } ranked by similarity. Organization administrators only; other callers get 403.

Semantic search over entities in the organization-wide graph. JSON body: `text` (1-2000 chars, required), optional `topK` (1-100), optional `types` (non-empty array of organization | person | location | identifier | date | amount | other). Returns `{ matches }`, each `{ id, type, name, score }` ranked by similarity. Organization administrators only; other callers get 403.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

textstringRequired1-2000 characters

topKintegerOptional1-100

typeslist of enumsOptional

Response

Ranked entity matches across the organization.

matcheslist of objects

$	curl -X POST https://api.cloudraker.com/ontology/search \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"text": "acme purchase orders"
>	}'

1	{
2	"matches": [
3	{
4	"id": "org-12345",
5	"type": "organization",
6	"name": "Acme Corporation",
7	"score": 0.92
8	}
9	]
10	}