> 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.12/api-integrations/data-catalog-data-lineage-and-grants-apis/search.md).

# Search

## Rebuild embeddings for all data structures

> Rebuilds the embeddings for all data structures. Embeddings are used by the AI suggestion features (k‑nearest‑neighbors search). The embedding rebuild task is started asynchronously in the background. The endpoint returns \`202 Accepted\` immediately after the task is queued.\
> \
> \*\*Only administrators\*\* can use this endpoint. Additionally, the suggestions index must be enabled in the system.\
> \
> This is a heavy maintenance operation. Rebuilding embeddings may take a significant amount of time depending on the number of data structures. The suggestions feature may not return up‑to‑date results until the rebuild completes.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.12.2"},"paths":{"/api/data_structures/search/embeddings/_put":{"post":{"description":"Rebuilds the embeddings for all data structures. Embeddings are used by the AI suggestion features (k‑nearest‑neighbors search). The embedding rebuild task is started asynchronously in the background. The endpoint returns `202 Accepted` immediately after the task is queued.\n\n**Only administrators** can use this endpoint. Additionally, the suggestions index must be enabled in the system.\n\nThis is a heavy maintenance operation. Rebuilding embeddings may take a significant amount of time depending on the number of data structures. The suggestions feature may not return up‑to‑date results until the rebuild completes.\n","operationId":"TdDdWeb.SearchController.embeddings","parameters":[],"responses":{"202":{"description":"Embeddings update accepted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Rebuild embeddings for all data structures","tags":["Search"]}}},"components":{"schemas":{"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdForbiddenResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdForbiddenResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```

## Trigger full search index reindex

> Triggers a full reindex of the search index for all data structures. The reindex task is started asynchronously in the background. The endpoint returns \`202 Accepted\` immediately after the task is queued.\
> \
> \*\*Only administrators\*\* can trigger a full reindex.\
> \
> This is a heavy maintenance operation. Reindexing may take a significant amount of time depending on the number of data structures. Search functionality may be temporarily degraded during the reindex.<br>

```json
{"openapi":"3.0.0","info":{"title":"td-dd","version":"Truedat 8.12.2"},"paths":{"/api/data_structures/search/reindex_all":{"get":{"description":"Triggers a full reindex of the search index for all data structures. The reindex task is started asynchronously in the background. The endpoint returns `202 Accepted` immediately after the task is queued.\n\n**Only administrators** can trigger a full reindex.\n\nThis is a heavy maintenance operation. Reindexing may take a significant amount of time depending on the number of data structures. Search functionality may be temporarily degraded during the reindex.\n","operationId":"TdDdWeb.SearchController.reindex_all","parameters":[],"responses":{"202":{"description":"Accepted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDdInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Trigger full search index reindex","tags":["Search"]}}},"components":{"schemas":{"TdDdUnauthorizedResponse":{"anyOf":[{"$ref":"#/components/schemas/TdDdUnauthorizedMessageResponse"},{"$ref":"#/components/schemas/TdDdUnauthorizedErrorResponse"}],"description":"Unauthorized response from auth plug or error view","title":"TdDdUnauthorizedResponse"},"TdDdUnauthorizedMessageResponse":{"additionalProperties":false,"properties":{"message":{"type":"string"}},"required":["message"],"title":"TdDdUnauthorizedMessageResponse","type":"object"},"TdDdUnauthorizedErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"required":["errors"],"title":"TdDdUnauthorizedErrorResponse","type":"object"},"TdDdForbiddenResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdForbiddenResponse","type":"object"},"TdDdInternalServerErrorResponse":{"additionalProperties":false,"properties":{"errors":{"additionalProperties":false,"properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"}},"required":["errors"],"title":"TdDdInternalServerErrorResponse","type":"object"}}}}
```