---
title: "GET /apps/{appId}/versions/{versionId}/intents/{intentId}/suggest"
method: GET
path: "/apps/{appId}/versions/{versionId}/intents/{intentId}/suggest"
---

# GET /apps/{appId}/versions/{versionId}/intents/{intentId}/suggest

`GET /apps/{appId}/versions/{versionId}/intents/{intentId}/suggest`

## Request

- Base URL: `{Endpoint}/luis/authoring/v3.0-preview`
- URL: `{Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/{versionId}/intents/{intentId}/suggest`
- Auth: API key in header `Ocp-Apim-Subscription-Key`

Suggests example utterances that would improve the accuracy of the intent model in a version of the application.

## Path parameters

- `appId` string, uuid, required
- `versionId` string, required
- `intentId` string, uuid, required

## Query parameters

- `take` integer
- `enableNestedChildren` boolean

## Response `200`

If there's no trained intent model, nothing is returned in the response. If there's a trained model and active learning finds any relevant queries, they are returned with the intent model predictions. If there's a trained model but active learning didn't find any relevant queries, an empty list is returned in the response.

- IntentsSuggestionExample[]: List of predicted/suggested intents.
  - `text` string: The utterance. For example, "What's the weather like in seattle?"
  - `tokenizedText` string[]: The tokenized utterance.
  - `intentPredictions` IntentPrediction[]: Predicted/suggested intents.
    - `name` string: The intent's name
    - `score` number: The intent's score, based on the prediction model.
  - `entityPredictions` EntityPrediction[]: Predicted/suggested entities.
    - `entityName` string, required: The entity's name
    - `startTokenIndex` integer, required: The index within the utterance where the extracted entity starts.
    - `endTokenIndex` integer, required: The index within the utterance where the extracted entity ends.
    - `phrase` string, required: The actual token(s) that comprise the entity.
    - `children` EntityPrediction[]

## Other responses

- `default`: Error Response.

## Changes

- **2020-05-14** `63bec9d0050f`: 1 info
  - added the new optional `query` request parameter `enableNestedChildren`

[Operation history](https://skmtc.dev/azure/apis/luis-authoring-client/changes/apps/:appId/versions/:versionId/intents/:intentId/suggest/get.md)

---

[API](https://skmtc.dev/azure/apis/luis-authoring-client.md) - [All operations](https://skmtc.dev/azure/apis/luis-authoring-client/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/luis-authoring-client/revisions/a26a0f7e5a37?raw)