> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/developer-tools-and-resources/api-reference/ai-search-apis.md).

# AI Search APIs

Endpoints for Guardian's AI-powered policy suggestion and natural language search capabilities.

**Authentication:** Bearer token required (`Authorization: Bearer <token>`)

***

| Method | Endpoint                                   | Description                                                            | Auth Required                             |
| ------ | ------------------------------------------ | ---------------------------------------------------------------------- | ----------------------------------------- |
| `POST` | `/api/v1/ai-suggestions`                   | Returns AI-generated policy recommendations for a given query          | No                                        |
| `PUT`  | `/api/v1/ai-suggestions/rebuild-vector`    | Rebuilds the AI vector index from current policy data                  | No                                        |
| `POST` | `/api/v1/ai-suggestions/schema-properties` | Returns AI-suggested glossary properties for one or more schema fields | Yes (`Permissions.SCHEMAS_SCHEMA_CREATE`) |

## Endpoints

* [Returns AI Search Response](/developer-tools-and-resources/api-reference/ai-search-apis/returns-response.md)
* [Rebuilds Vector Based on Policy Data](/developer-tools-and-resources/api-reference/ai-search-apis/rebuilds-vector-based-on-policy-data.md)
* [Suggests Schema Field Properties](/developer-tools-and-resources/api-reference/ai-search-apis/suggest-schema-field-properties.md)