> 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/guardian/standard-registry/policies/auto-suggestion/auto-suggestion-apis.md).

# Auto Suggestion APIs

Endpoints for retrieving AI-powered block type suggestions during policy authoring and managing the auto-suggestion configuration.

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

**Permission:** Standard Registry role required.

***

| Method | Endpoint                     | Description                                                                      | Auth Required |
| ------ | ---------------------------- | -------------------------------------------------------------------------------- | ------------- |
| `POST` | `/api/v1/suggestions`        | Returns the next and nested suggested block types for the current policy context | Yes           |
| `GET`  | `/api/v1/suggestions/config` | Returns the current auto-suggestion configuration                                | Yes           |
| `POST` | `/api/v1/suggestions/config` | Updates the auto-suggestion configuration                                        | Yes           |

## Endpoints

* [Get Next and Nested Suggested Block Types](/guardian/standard-registry/policies/auto-suggestion/auto-suggestion-apis/get-next-and-nested-suggested-block-types.md)
* [Get Suggestions Configuration](/guardian/standard-registry/policies/auto-suggestion/auto-suggestion-apis/get-suggestions-configuration.md)
* [Set Suggestions Configuration](/guardian/standard-registry/policies/auto-suggestion/auto-suggestion-apis/set-suggestions-configuration.md)