> 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/v8.8/api-integrations/business-glossary-apis/suggestions.md).

# Suggestions

## Search business concept suggestions (KNN)

> Search for recommended business concept versions using KNN-based suggestion criteria.

```json
{"openapi":"3.0.0","info":{"title":"td-bg","version":"Truedat 8.8.0"},"paths":{"/api/business_concept_versions/suggestions":{"post":{"description":"Search for recommended business concept versions using KNN-based suggestion criteria.","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 resource (type + id) to generate embeddings.\nOptional parameters override similarity search behavior.\n","properties":{"collection_name":{"description":"Embedding collection name (defaults to system default)","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"}}}}
```