> For the complete documentation index, see [llms.txt](https://docs.truedat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.truedat.io/api-integrations/business-glossary-apis/suggestions.md).

# Suggestions

## Search business concept suggestions (KNN)

> &#x20; Returns business concept versions ranked by vector similarity to the supplied source resource.\
> \
> &#x20; Requires the suggestions index to be enabled for the tenant. No additional permission is checked at this endpoint; the results are filtered by the caller's concept visibility rules as part of the KNN search.\
> \
> &#x20; \*\*Request body:\*\*\
> &#x20; \- \`resource\` (required) – Source resource to find similar concepts for.\
> &#x20; \- \`k\`, \`similarity\`, \`num\_candidates\` (optional) – kNN tuning parameters.\
> \
> &#x20; If the suggestions index is disabled, the endpoint returns \`403 Forbidden\`, regardless of the caller's permissions.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.11.0"},"paths":{"/api/business_concept_versions/suggestions":{"post":{"description":"  Returns business concept versions ranked by vector similarity to the supplied source resource.\n\n  Requires the suggestions index to be enabled for the tenant. No additional permission is checked at this endpoint; the results are filtered by the caller's concept visibility rules as part of the KNN search.\n\n  **Request body:**\n  - `resource` (required) – Source resource to find similar concepts for.\n  - `k`, `similarity`, `num_candidates` (optional) – kNN tuning parameters.\n\n  If the suggestions index is disabled, the endpoint returns `403 Forbidden`, regardless of the caller's permissions.\n","operationId":"TdBgWeb.SuggestionController.search","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestionSearchRequest"}}},"description":"Suggestion search payload","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestionSearchResponse"}}},"description":"Suggestions list"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdBgInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Search business concept suggestions (KNN)","tags":["Suggestions"]}}},"components":{"schemas":{"SuggestionSearchRequest":{"additionalProperties":false,"description":"KNN vector search for business concept suggestions.\nRequires a source resource (`type` and `id`) from which the service generates an embedding.\nOptional parameters override similarity search behavior.\n","properties":{"collection_name":{"description":"Embedding collection to search. When omitted, the service uses its configured default collection.","type":"string"},"k":{"default":10,"description":"Number of nearest neighbors to return (1-100)","maximum":100,"minimum":1,"type":"integer"},"num_candidates":{"default":100,"description":"Number of candidates for ANN search","minimum":1,"type":"integer"},"resource":{"additionalProperties":false,"description":"Source resource used to generate embedding vector","properties":{"id":{"description":"Resource ID","type":"integer"},"type":{"description":"Resource type (only 'structures' supported)","enum":["structures"],"type":"string"}},"required":["type","id"],"type":"object"},"similarity":{"default":0.6,"description":"Cosine similarity threshold (0.0-1.0)","maximum":1,"minimum":0,"type":"number"}},"required":["resource"],"title":"SuggestionSearchRequest","type":"object"},"SuggestionSearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"additionalProperties":true,"properties":{"business_concept_id":{"description":"Parent business concept ID","type":"integer"},"id":{"description":"Business concept version ID","type":"integer"},"name":{"description":"Concept name","type":"string"},"similarity":{"description":"Cosine similarity score (0-1)","type":"number"}},"required":["id","business_concept_id","name"],"type":"object"},"type":"array"}},"required":["data"],"title":"SuggestionSearchResponse","type":"object"},"TdBgUnauthorizedResponse":{"properties":{"errors":{"properties":{"message":{"type":"string"}},"type":"object"}},"title":"TdBgUnauthorizedResponse","type":"object"},"TdBgForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgForbiddenResponse","type":"object"},"TdBgInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdBgInternalServerErrorResponse","type":"object"}}}}
```
